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.

71

Quality

89%

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

88%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 content is a well-sequenced, highly executable drafting workflow: concrete git and gh commands, an explicit classification scheme, validation checkpoints with error paths, and a complete output template. Its only weaknesses are mild verbosity in a few advisory passages and a long repository-specific install template that slightly pads the single file.

DimensionReasoningScore

Conciseness

The body is efficient: concrete commands like "git describe --tags --abbrev=0" and "gh release list --limit 5" with no explanations of concepts Claude already knows. It sits at the 4 anchor rather than 5 because some advisory prose (e.g., "Prefer concrete user outcomes, honest limitations, and short technical explanations") and the checklist's restatement of step rules could be trimmed slightly.

4 / 5

Actionability

Every phase has copy-paste-ready commands (git log/diff/show, gh release list/view, "node scripts/check_version_sync.mjs --release"), plus an explicit commit-prefix classification map and a full output template. This matches the "fully executable; specific examples cover the common cases" anchor.

5 / 5

Workflow Clarity

Four clearly sequenced steps with explicit validation checkpoints ("Confirm both refs with git rev-parse --verify before drafting", "ask one short question" when ambiguous, "If the check fails... report that clearly") and a ten-item pre-return checklist. This is the anchor-5 pattern of sequence, validation, error-recovery guidance, and a checklist; the operation is drafting-only so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

A single-file skill with no bundle files, organized into clean Inputs / Steps / Output format / Checklist sections where the inline template belongs in the body. It fits the 4 anchor (good structure, minor gaps) rather than 5 because the under-50-line simple-skill exception does not apply and the repository-specific install block is somewhat long to carry inline.

4 / 5

Total

18

/

20

Passed

Description

87%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 concrete capabilities in third person and pairs them with an explicit, verb-rich "Use when" clause scoped to Minutes versions. Trigger coverage is good though not exhaustive of synonyms, and the action list could surface one more of the skill's concrete sub-tasks.

DimensionReasoningScore

Specificity

"Draft user-facing Minutes release notes for a version from the commit range, recent GitHub releases, and the repository release checks" names the domain and concrete inputs in third person, matching the "several specific actions; minor gaps" anchor. It does not reach 5 because it does not enumerate the underlying sub-activities (commit classification, breaking-change verification, integrity checks) that the skill actually performs.

4 / 5

Completeness

The description explicitly answers both questions: "Draft user-facing Minutes release notes... from the commit range, recent GitHub releases, and the repository release checks" states what it does, and "Use when the user asks to write, generate, prepare, revise, or review release notes or a changelog for a Minutes version" gives concrete trigger phrases. This is a direct match for the 5 anchor.

5 / 5

Trigger Term Quality

"write, generate, prepare, revise, or review release notes or a changelog" covers the natural verbs and nouns a user would say. It stops short of the 5 anchor because synonyms like "release announcement" or "what's new" are absent, but it far exceeds the "some relevant keywords" level of 3.

4 / 5

Distinctiveness Conflict Risk

The scope is tightly pinned to "a Minutes version" and to release-notes/changelog triggers, giving it a clear niche with minimal overlap risk against generic git or documentation skills. It fits the 5 anchor; the 4 anchor's "minor overlap risk with closely related skills" does not apply because the product qualifier disambiguates.

5 / 5

Total

18

/

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

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.