Name: apple-notes
Rating: 57.599999999999994 (1 reviews)
Author: OpenBMB

Blog Docs Log inGet started

apple-notes

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

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/apple-notes/SKILL.md

Quality

Content

57%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.

The body is a lean, command-per-task reference with genuinely executable guidance for every operation, which is its core strength. It is held back by a destructive delete flow with no validation step, an ambiguous export command, and redundancy plus an irrelevant migration-metadata section that pad the token budget without helping execution.

Suggestions

Add a validation step before destructive deletes, e.g. view the note first (`memo notes -s "title"`) or confirm the selection matches the intended note before running `memo notes -d`.

Specify the export workflow: how `-ex` chooses HTML vs Markdown, whether it prompts interactively, and where the exported file is written.

Convert section labels to markdown headers, merge the redundant "Notes" section into "Setup"/"Limitations" (stating macOS-only once), and remove the PilotDeck migration metadata, which adds tokens without aiding skill execution.

Dimension	Reasoning	Score
Conciseness	The command listings are lean, but the body carries unnecessary weight: "Notes" repeats "macOS-only" from Setup and overlaps Limitations, and the "PilotDeck Migration Note" section is migration metadata irrelevant to using the skill. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened'.	3 / 5
Actionability	Every task is paired with a concrete, copy-paste-ready command with flags and quoted arguments (e.g. `memo notes -f "Folder Name"`), but `memo notes -ex` never states how the HTML vs Markdown format is chosen or where output lands — a minor gap that keeps it below fully executable.	4 / 5
Workflow Clarity	Tasks are cleanly sectioned one command each, but delete is a destructive operation with no validation, confirmation, or verification step described, so the rubric's destructive-operation cap holds workflow clarity at 3.	3 / 5
Progressive Disclosure	This is a short single-file skill with no bundle directories, so external references aren't needed, but organization is loose: section labels ("Setup", "View Notes", etc.) are plain text rather than markdown headers, and the only actual heading ("## PilotDeck Migration Note") spotlights irrelevant migration metadata — structure exists but could be better organized.	3 / 5
	Total	13 / 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 concise, highly specific description that clearly states what the skill does and is well-differentiated from other skills. Its one structural weakness is the absence of any "when to use" trigger guidance, which both caps completeness and slightly weakens trigger-term coverage.

Suggestions

Append a 'Use when...' clause, e.g. 'Use when the user mentions Apple Notes, the Notes app, or wants to manage notes from the terminal on macOS.'

Add a synonym or two for discoverability, such as 'Notes app' or 'note taking', since users may not say 'Apple Notes' verbatim.

Optionally mention export formats ('export to HTML or Markdown') as explicit trigger terms for export-oriented requests.

Dimension	Reasoning	Score
Specificity	"Create, view, edit, delete, search, move, or export Apple Notes" enumerates seven concrete, comprehensive actions for the domain, in third-person voice, matching the anchor for multiple specific concrete actions with comprehensive coverage.	5 / 5
Completeness	The description has a clear, explicit "what" but contains no "Use when..." clause or equivalent explicit trigger guidance, which the rubric mandates as a cap at 3.	3 / 5
Trigger Term Quality	"Apple Notes", "memo CLI", "macOS", and verbs like "search", "export", and "move" give good natural keyword coverage, but there are no synonyms (e.g. "note taking", "Notes app") or related trigger phrases, so it stops short of comprehensive.	4 / 5
Distinctiveness Conflict Risk	"Apple Notes ... via the memo CLI on macOS" carves out a clear niche with distinct triggers; it is unlikely to fire for generic note-taking or other CLI skills.	5 / 5
	Total	17 / 20 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: OpenBMB/PilotDeck
Path: skills/apple-notes/SKILL.md
Commit: 66bfd09

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.