CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

apple-notes

Create, view, edit, delete, search, move, or export Apple Notes via the memo CLI on macOS.

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/apple-notes/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A lean, command-first reference that is easy to act on, with well-organized sections for a simple skill. Its main weaknesses are duplicated macOS/permission notes, missing examples for export and non-interactive flags, and no validation or confirmation guidance around the destructive delete operation.

Suggestions

Add a validation step before delete, e.g. showing how to view or search a note first to confirm the target before running `memo notes -d`.

Show example invocations for export (format/output flags) and non-interactive variants of edit/delete/move where the CLI supports them.

Deduplicate the macOS-only and Automation-permission notes, keeping them in one section, and drop the Mistune implementation detail.

DimensionReasoningScore

Conciseness

Command-first bullets like "List all notes: `memo notes`" are lean and assume competence; not 5 because "macOS-only" and Automation-permission guidance each appear twice (Setup and Notes sections), and "uses Mistune for markdown processing" is an unneeded implementation detail.

4 / 5

Actionability

Every operation ships a copy-paste-ready command (e.g. `memo notes -a "Note Title"`, `memo notes -s "query"`); not 5 because `-ex` shows no format-selection examples and edit/delete/move only demonstrate the interactive invocation.

4 / 5

Workflow Clarity

Per-command steps are unambiguous, but delete is a destructive operation and the body offers no confirmation or verification guidance, capping workflow clarity at 3 per the destructive-operation rule that overrides the simple-skill exception; not 2 because the commands themselves are concrete and each section's sequence is coherent.

3 / 5

Progressive Disclosure

The ~50-line body has no external references and is organized into clear per-task sections (View/Create/Edit/Delete/Move/Export/Limitations), satisfying the simple-skill guideline for a top score; not 4 because nothing here belongs in a separate file.

5 / 5

Total

16

/

20

Passed

Description

75%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A crisp, specific description with excellent action coverage and low conflict risk, weakened only by the absence of an explicit 'when to use this' trigger clause. Adding a 'Use when the user mentions Apple Notes, the Notes app, or wants to manage notes from the terminal' sentence would lift it to top-tier.

Suggestions

Append a trigger clause such as 'Use when the user mentions Apple Notes, the Notes app, or wants to manage notes from the macOS terminal.'

Include common synonyms users say, e.g. "Notes app" or "notes", not just "Apple Notes".

Keep the action list as-is; it is comprehensive and concrete.

DimensionReasoningScore

Specificity

"Create, view, edit, delete, search, move, or export Apple Notes via the memo CLI" lists seven concrete actions naming both domain and tool, matching the comprehensive-coverage anchor; not 4 because there are no minor gaps across the CRUD surface.

5 / 5

Completeness

The "what" is clearly and concretely answered, but there is no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines; not 2 because the "what" is specific rather than vague.

3 / 5

Trigger Term Quality

"Apple Notes", "memo CLI", "macOS", and action verbs like "search" and "export" give good natural keyword coverage; not 5 because common user variations such as "Notes app", "note", or "notebook" are missing.

4 / 5

Distinctiveness Conflict Risk

"Apple Notes via the memo CLI on macOS" carves a clear niche with distinct triggers and minimal risk of firing for unrelated note or document skills; not 4 because no closely related skill plausibly overlaps these specific terms.

5 / 5

Total

17

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

openclaw/openclaw

Path

skills/apple-notes/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.