CtrlK
BlogDocsLog inGet started
Tessl Logo

apple-notes

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

60

Quality

70%

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%

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

A concise, highly actionable command reference that is well organized, but it repeats setup information across sections, carries an irrelevant migration note, and lacks a verification checkpoint for the destructive delete operation.

Suggestions

Add a confirmation/validation note for deletion, e.g. confirm the selected note title before `memo notes -d` completes.

Remove the duplicated macOS/permission facts from the "Notes" section since they already appear under Setup, and drop the "PilotDeck Migration Note" review meta-content from the skill body.

DimensionReasoningScore

Conciseness

The body is mostly lean command listings, but the "Notes" section duplicates Setup facts (macOS-only, automation permission) and the "PilotDeck Migration Note" is review meta-clutter, so it could be tightened to reach score 3.

2 / 3

Actionability

Every operation is given as concrete, copy-paste-ready commands (e.g. `memo notes -f "Folder Name"`, `memo notes -a "Note Title"`), matching the score-3 anchor of fully executable commands.

3 / 3

Workflow Clarity

Each single-action operation is unambiguous, but the destructive `memo notes -d` delete step has no validation or verification checkpoint, which caps workflow clarity at 2 per the destructive-operation guideline.

2 / 3

Progressive Disclosure

This is a simple, single-purpose skill organized into clear one-line sections (View/Create/Edit/Delete/Move/Export) with no nested or external references needed, matching the score-3 simple-skill allowance for well-organized sections.

3 / 3

Total

10

/

12

Passed

Description

67%

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 specific, well-scoped description that clearly names capabilities and is unlikely to conflict, but it omits an explicit "Use when..." trigger clause and has only modest natural keyword coverage.

Suggestions

Append an explicit trigger clause, e.g. "Use when the user wants to manage Apple Notes or the macOS Notes app from the terminal."

Broaden trigger terms to include natural phrasings like "Notes app", "Mac notes", or "my notes".

DimensionReasoningScore

Specificity

The description enumerates seven concrete actions ("Create, view, edit, delete, search, move, or export") matching the score-3 anchor that lists multiple specific concrete actions.

3 / 3

Completeness

It clearly answers "what" (the seven operations via memo CLI) but offers no "Use when..." or equivalent explicit trigger guidance, so per the judging guidelines completeness is capped at 2.

2 / 3

Trigger Term Quality

"Apple Notes" and "memo CLI on macOS" are relevant terms, but coverage of natural user phrasings is thin (no "Notes app", "Mac notes", "my notes"), fitting the score-2 anchor of some relevant keywords missing common variations.

2 / 3

Distinctiveness Conflict Risk

The tightly scoped niche of Apple Notes via the memo CLI on macOS gives distinct triggers unlikely to collide with other skills, matching the score-3 anchor of a clear niche with distinct triggers.

3 / 3

Total

10

/

12

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
OpenBMB/PilotDeck
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.