CtrlK
BlogDocsLog inGet started
Tessl Logo

apple-notes

Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a user asks Bitterbot to add a note, list notes, search notes, or manage note folders.

74

Quality

93%

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

SKILL.md
Quality
Evals
Security

Quality

Content

87%

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

A compact, actionable CLI reference that respects token budget and groups commands cleanly. The main gap is the absence of validation/confirmation guidance around the destructive delete and move operations.

Suggestions

Add an explicit confirmation/validation note for destructive commands, e.g. note that `memo notes -d` prompts interactively and to verify the selected note before confirming deletion.

Clarify non-interactive equivalents or flags where they exist, since several commands rely on interactive selection that may block automation.

Note the expected output of `memo notes` (e.g. how notes/folders are displayed) so Claude can parse results without trial and error.

DimensionReasoningScore

Conciseness

Lean bullet-point reference with no concept explanation padding; every line states a command or constraint and assumes Claude's competence.

3 / 3

Actionability

Each task maps to a concrete, copy-paste-ready command (e.g. `memo notes -f "Folder Name"`, `memo notes -a "Note Title"`) with flags shown explicitly.

3 / 3

Workflow Clarity

Tasks are simple single commands, but destructive operations (delete `-d`, move `-m`) lack any validation or confirmation checkpoint, which caps clarity per the destructive-operation guideline.

2 / 3

Progressive Disclosure

Under 50 lines with no external references needed; content is split into clear, well-organized sections (Setup, View, Create, Edit, Delete, Move, Export, Limitations) satisfying the simple-skill exception.

3 / 3

Total

11

/

12

Passed

Description

100%

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 strong description: concrete capabilities, natural trigger terms, explicit use-when guidance, and a distinct, low-conflict niche. Third-person voice is maintained throughout.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'create, view, edit, delete, search, move, and export notes' — naming the tool and platform rather than vague verbs.

3 / 3

Completeness

Explicitly answers both what ('Manage Apple Notes via the memo CLI...') and when ('Use when a user asks Bitterbot to...'), with an explicit trigger clause.

3 / 3

Trigger Term Quality

'add a note, list notes, search notes, or manage note folders' are natural phrases a user would say, giving good coverage of common request variations.

3 / 3

Distinctiveness Conflict Risk

Scoped to Apple Notes via memo on macOS with note-specific triggers, a clear niche unlikely to collide with other skills.

3 / 3

Total

12

/

12

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.

Validation13 / 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
Bitterbot-AI/bitterbot-desktop
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.