CtrlK
BlogDocsLog inGet started
Tessl Logo

minutes-release-notes

Draft user-facing Minutes release notes for a version from the commit range, recent GitHub releases, and the repository release checks. Use when the user asks to write, generate, prepare, revise, or review release notes or a changelog for a Minutes version.

76

Quality

95%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

The canonical home for this skill is minutes-release-notes in silverstein/minutes

SKILL.md
Quality
Evals
Security

Quality

Content

96%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 an exemplary instruction-only skill: terse, fully executable guidance with a well-sequenced four-step workflow, explicit validation and error-reporting checkpoints, and a comprehensive pre-return checklist. The single improvement opportunity is structural, offloading the long output-format template to a reference file to slim the main SKILL.md.

DimensionReasoningScore

Conciseness

The body is lean and imperative throughout ("Classify every relevant commit by conventional prefix", "Drop internal-only version bumps, lockfile syncs...") with no explanation of concepts Claude already knows and no padded sections. It does not match anchor 4 because there is no identifiable passage of over-explanation to trim.

5 / 5

Actionability

Every step ships copy-paste-ready commands (git describe/log/diff, gh release list/view, node scripts/check_version_sync.mjs --release) plus a complete output template with exact install wording. It exceeds anchor 4 because the concrete commands and the full layout template together cover the common cases end to end.

5 / 5

Workflow Clarity

Four clearly sequenced steps with explicit validation checkpoints: confirm refs with "git rev-parse --verify", ask one short question when ambiguous, run the version check after the version is applied, and report its failure mode rather than silently proceeding. The closing checklist adds a final verification loop, matching the anchor-5 pattern rather than the minor-gaps pattern of anchor 4.

5 / 5

Progressive Disclosure

A single-file skill with clean section structure (Inputs, Steps, Output format, Checklist) and no nested or buried references, and the body's file references (e.g. scripts/check_version_sync.mjs) are repo paths invoked by command rather than bundle pointers to chase. It falls short of 5 only because the ~35-line output layout template is the one sizable block that could be moved to a one-level-deep reference file, which is a minor placement gap per anchor 4.

4 / 5

Total

19

/

20

Passed

Description

95%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 states a concrete capability, names its data sources, and provides explicit, verb-rich trigger guidance scoped to the Minutes product. The only mild limitation is that it describes a single drafting action rather than a broader set of concrete operations, which is inherent to this single-purpose skill.

DimensionReasoningScore

Specificity

The description gives one concrete action, "Draft user-facing Minutes release notes", with named sources ("commit range, recent GitHub releases, and the repository release checks"), which sits between anchor 3 (1-2 concrete actions) and anchor 4 (several specific actions). It is not a 5 because the capability is a single drafting action rather than multiple distinct concrete actions.

4 / 5

Completeness

Both parts are explicit: what it does ("Draft user-facing Minutes release notes for a version from the commit range, recent GitHub releases, and the repository release checks") and when to use it ("Use when the user asks to write, generate, prepare, revise, or review release notes or a changelog for a Minutes version"). This matches the anchor-5 pattern of concrete what plus explicit trigger phrases, not the weaker 'when' of anchor 4.

5 / 5

Trigger Term Quality

"Use when the user asks to write, generate, prepare, revise, or review release notes or a changelog" comprehensively covers the natural synonyms (release notes, changelog) and the verbs users would actually say. It does not fall to 4 because no commonly used trigger phrasing for this task is missing.

5 / 5

Distinctiveness Conflict Risk

The description is scoped to "a Minutes version" with product-specific triggers, giving it a clear niche with minimal overlap risk against generic changelog or documentation skills. Anchor 4 would require some overlap with closely related skills, which the explicit Minutes scoping avoids.

5 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository
silverstein/minutes
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.