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 OpenClaw to add a note, list notes, search notes, or manage note folders.
80
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Discovery
85%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-crafted skill description that clearly specifies capabilities, platform, and tool while providing explicit 'Use when' guidance. The main weakness is the trigger term coverage, which could include more natural variations of how users might ask about notes. The description uses proper third-person voice throughout.
Suggestions
Expand trigger terms to include common variations like 'Apple Notes', 'notes app', 'jot down', 'write a note', or 'save a note' to improve discoverability.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'create, view, edit, delete, search, move, and export notes'. Also specifies the tool ('memo CLI') and platform ('macOS'). | 3 / 3 |
Completeness | Clearly answers both what ('Manage Apple Notes via the memo CLI...create, view, edit, delete, search, move, and export notes') and when ('Use when a user asks...to add a note, list notes, search notes, or manage note folders'). | 3 / 3 |
Trigger Term Quality | Includes natural terms like 'add a note', 'list notes', 'search notes', 'manage note folders', but missing common variations like 'Apple Notes', 'notes app', 'jot down', 'write a note', or 'save a note'. | 2 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with specific triggers: 'Apple Notes', 'memo CLI', 'macOS', and note-specific actions. Unlikely to conflict with other document or file management skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, concise CLI reference that efficiently documents the memo tool's capabilities. The main weakness is the heavy reliance on interactive prompts without documenting non-interactive alternatives or providing guidance on automation scenarios where terminal interaction isn't available.
Suggestions
Document non-interactive alternatives or flags for automation (e.g., can notes be created with body content via stdin or arguments?)
Add expected output examples for at least the list/search commands to help Claude verify successful execution
Include error handling guidance for common failures like permission denied or attempting to edit notes with attachments
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, presenting only essential commands and flags without explaining what Apple Notes is or how CLI tools work. Every section delivers actionable information without padding. | 3 / 3 |
Actionability | Commands are concrete and copy-paste ready, but the interactive nature of most operations (edit, delete, move, export all use interactive selection) means Claude can't fully automate these tasks. Missing examples of expected output or non-interactive alternatives. | 2 / 3 |
Workflow Clarity | For a simple CLI reference skill, the organization is clear, but there's no guidance on handling failures (e.g., what happens if permissions aren't granted, or if a note has attachments). The limitations section hints at issues but doesn't provide recovery steps. | 2 / 3 |
Progressive Disclosure | For a skill under 50 lines with a single-purpose CLI tool, the content is well-organized into logical sections (Setup, View, Create, Edit, etc.) with no need for external references. Navigation is straightforward. | 3 / 3 |
Total | 10 / 12 Passed |
Validation
72%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 8 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
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 | 8 / 11 Passed | |
- 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.