CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-notes

Use when deciding whether a Cherry Studio change needs an Agent Note, authoring or reviewing a Spec, recording a durable bug-fix decision, moving a note between proposed/implemented/rejected, or checking supersession and stacked Spec approval.

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

92%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 dense, well-structured instruction skill: rules are stated as terse imperatives, the multi-step Spec workflow is sequenced with explicit approval and validation checkpoints, and external detail is appropriately delegated to one clearly-signaled reference. The only gap is that a few steps (note creation details, the scoped pairing commands) stay directional rather than fully concrete.

Suggestions

Name or inline the exact command(s) for the "scoped pairing write/check" in the Validation section so every listed check is runnable as written.

Add a minimal inline example of a note's structure (class + lifecycle + AC mapping) or point to a specific section of the notes README for the authoring steps, since "proposed bilingual note" currently assumes knowledge from the linked doc.

DimensionReasoningScore

Conciseness

Nearly every sentence is a load-bearing rule ("Partial supersessions stay active and cross-linked", "A successful sync is not validation", "Report only evidence actually run") with no padding and no explanation of concepts Claude already knows. It matches anchor 5 — lean, assumes competence, every token earns its place — rather than anchor 4's "minor instances of over-explanation".

5 / 5

Actionability

The body provides mostly executable guidance with concrete commands ("pnpm agent-notes:check-transition --base <verified-spec-ref>", "gh stack view --json", "pnpm change:scope", "git diff --check") and explicit approval gates. However, some steps remain directional without exact mechanics — "Create the bottom Spec branch and proposed bilingual note" and the unnamed "scoped pairing write/check" — so it fits anchor 4 (minor gaps) rather than anchor 5 (copy-paste ready coverage of common cases).

4 / 5

Workflow Clarity

The Spec-first stack is a clear numbered 1–7 sequence with explicit validation checkpoints ("require an explicit `APPROVED` review whose commit id equals the current Spec head"), error-recovery loops ("If it exits 2, follow the `gh-stack` skill's remote-discovery procedure"; rerun only invalidated checks after sync), and a dedicated Validation section with commands. This matches anchor 5; since validation is present, the destructive/batch cap at 3 does not apply.

5 / 5

Progressive Disclosure

The body is under 50 lines with clean section organization and a single clearly-signaled one-level-deep reference ("Read [the Agent Note rules](../../notes/README.md) before acting") plus a named pointer to the `gh-stack` skill. Per the rubric's simple-skill exception, a short, well-organized skill with no bundle files scores 5; there is no nested or buried referencing that would lower it.

5 / 5

Total

19

/

20

Passed

Description

92%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 strong description that explicitly covers both what the skill does and when to use it via a rich, concrete trigger enumeration, anchored by repo-specific terminology that makes it highly distinct. The only weakness is the absence of synonyms or looser natural-language variations that could broaden trigger matching.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — "deciding whether a Cherry Studio change needs an Agent Note", "authoring or reviewing a Spec", "recording a durable bug-fix decision", "moving a note between proposed/implemented/rejected", "checking supersession and stacked Spec approval" — with comprehensive coverage of the skill's operations. It matches the anchor 5 example's breadth; there are no minor coverage gaps that would place it at 4.

5 / 5

Completeness

The explicit "Use when..." trigger clause enumerates concrete triggering situations, and the same verb phrases explicitly state what the skill does (decide, author/review, record, move, check). Both what and when are explicit with concrete trigger phrases, matching anchor 5; the when is fully specific, so anchor 4's caveat ("when could be more explicit") does not apply.

5 / 5

Trigger Term Quality

Good keyword coverage of terms a contributor in this repo would naturally say ("Agent Note", "Spec", "bug-fix", "supersession", "Cherry Studio"), but there are no synonyms or variations such as "decision record", "notes", or "specification". This fits anchor 4 (good coverage, a few natural terms missing) rather than 5 (comprehensive synonyms/extensions) or 3 (only partial coverage).

4 / 5

Distinctiveness Conflict Risk

"Cherry Studio" plus repo-specific lifecycle vocabulary ("Agent Note", "Spec", "proposed/implemented/rejected", "stacked Spec approval") carves out a clear niche with distinct triggers and minimal conflict risk with other skills. It clearly matches anchor 5 rather than anchor 4's "minor overlap risk with closely related skills".

5 / 5

Total

19

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

CherryHQ/cherry-studio

Path

.agents/skills/agent-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.