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

Passed

No findings from the security scan

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.

A tightly written, executable skill body with concrete commands, a clear multi-step workflow, explicit validation checkpoints, and a closing checklist. It avoids over-explaining basics and keeps everything in one well-structured file.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence, providing only git/gh commands and Minutes-specific conventions (e.g. the no-em-dash rule, classification table) without re-explaining git, conventional commits, or what release notes are.

5 / 5

Actionability

It supplies copy-paste-ready commands for every phase (git describe, git log ranges, gh release list/view, node scripts/check_version_sync.mjs --release) plus a concrete output markdown template and a verification checklist covering common cases.

5 / 5

Workflow Clarity

The four numbered steps are clearly sequenced with explicit validation checkpoints (confirm refs with git rev-parse --verify, run check_version_sync.mjs, verify breaking-change status) and a final checklist that closes the feedback loop before returning the draft.

5 / 5

Progressive Disclosure

Content is well organized into Inputs/Steps/Output format/Checklist with the bulk of guidance inline and appropriately scoped; there are no bundle files to reference, so one-level-deep external navigation is not used, leaving minor room for splitting the large output template into a reference.

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, third-person description that states concrete capabilities and gives an explicit 'Use when' trigger clause with multiple natural phrasings. It is well-scoped to a Minutes release-notes niche with low conflict risk.

DimensionReasoningScore

Specificity

The description enumerates several concrete actions ('Draft', 'generate', 'prepare', 'revise', 'review') tied to specific inputs ('commit range', 'recent GitHub releases', 'repository release checks'), giving clear coverage with only minor gaps in naming the full output assembly process.

4 / 5

Completeness

It explicitly answers 'what' (draft Minutes release notes from commits, recent releases, and release checks) and 'when' via the 'Use when the user asks to write, generate, prepare, revise, or review release notes or a changelog' clause with concrete triggers.

5 / 5

Trigger Term Quality

It lists the natural user phrasings verbatim ('write, generate, prepare, revise, or review release notes or a changelog'), covering both 'release notes' and 'changelog' synonyms that a user would actually say.

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche (Minutes-specific release notes from commit ranges and GitHub releases) with distinct triggers unlikely to fire for unrelated 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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

15

/

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.