CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

release-notes

Draft the GitHub release body for a new Docus version. Use when asked to write release notes, do the release notes, or prepare the GitHub release for a version. Generates emoji sections, Contributors and new docs candidates from CHANGELOG.md into a local file to edit and paste, plus Highlights on minor and major versions.

77

Quality

97%

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

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.

An exemplary skill body: concrete commands with exact paths and repo flags, a five-step workflow with genuine validation checkpoints (verify-against-PR, anchor checking, contributor sanity-check), and clean separation of mechanical work into a bundled script. The only minor issue is a small amount of version-specific precedent (the v5.15.0 example) that will age and slightly inflates the token budget.

Suggestions

Move the version-specific precedent ("v5.15.0 was all performance work") into a short past-releases note or replace it with a durable rule ("a minor may ship with only Performance entries"), so the guidance does not go stale as versions accumulate.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — no explanations of concepts Claude already knows, and rules are stated as compact directives ("Never invent an API", "no em dashes"). One blemish keeps it below the anchor-5 'every token earns its place' bar: time-sensitive specifics such as "v5.15.0 was all performance work" are stated inline rather than confined to a past-release-patterns section, per the judging guideline on version numbers. It is clearly above the 3 anchor, which requires unnecessary explanation.

4 / 5

Actionability

Fully executable, copy-paste-ready commands throughout: `node .claude/skills/release-notes/scripts/generate.mjs 5.16.0`, `gh pr view <n> --repo nuxt-content/docus`, `git log <prev>..<tag> --pretty=%b | grep -i co-authored-by`, plus a complete highlight template with real file paths to check (`layer/index.d.ts`, `layer/nuxt.schema.ts`). Specific numeric constraints ("2 to 4" highlights) and an emoji map cover the common cases. Not 4, because no guidance is pseudocode or missing key details.

5 / 5

Workflow Clarity

Five clearly sequenced steps with explicit validation checkpoints and feedback loops: "Verify before you write" (check the merged PR and schema files, never invent an API), "Check each anchor against the heading on the page" in step 4, and a dedicated sanity-check step (contributor-list verification with a recovery command, leftover-TODO removal, final report). A precondition check (`gh auth status`) is also included. This matches the anchor-5 example with validate-fix-retry structure; 4 would require missing checkpoints, which are absent.

5 / 5

Progressive Disclosure

Appropriately split: all mechanical generation is delegated to the single bundled script (`scripts/generate.mjs`, verified to exist and match the referenced path), while the body holds only the judgement-dependent guidance. References are one level deep and clearly signaled in step 1 with both usage variants shown. The bundle structure matches what the body promises (CHANGELOG.md parsing, Contributors via one graphql call, patch-release handling), so navigation is easy and nothing is inlined that belongs elsewhere. Not 4, because there are no organization gaps to point to.

5 / 5

Total

19

/

20

Passed

Description

100%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 model frontmatter description: concrete multi-action capability statement, explicit and naturally worded trigger clause, third-person/imperative voice, and a distinct Docus-specific niche. It matches the quality of the good_overall_examples with no padding or over-claims.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Draft the GitHub release body", "Generates emoji sections, Contributors and new docs candidates from CHANGELOG.md into a local file to edit and paste, plus Highlights on minor and major versions" — with a concrete source (CHANGELOG.md), output (local file), and version-conditional behavior. Coverage is comprehensive with no vague filler; it clearly exceeds the 'several specific actions; minor gaps' (4) anchor.

5 / 5

Completeness

It explicitly answers both questions: what ("Draft the GitHub release body for a new Docus version... Generates emoji sections, Contributors and new docs candidates...") and when ("Use when asked to write release notes, do the release notes, or prepare the GitHub release for a version") with concrete trigger phrases. This is the exact structure of the anchor-5 example; the 'when' is explicit, not merely implied as at 4.

5 / 5

Trigger Term Quality

"Use when asked to write release notes, do the release notes, or prepare the GitHub release for a version" covers the natural phrasings a user would actually say, including the colloquial "do the release notes" synonym variant and "prepare the GitHub release". This matches the comprehensive-with-synonyms anchor (5) rather than 'a few natural terms missing' (4).

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — the GitHub release body for a new Docus version, tied to CHANGELOG.md and version tagging — with triggers unlikely to fire for unrelated skills. Not below 4 because there is no meaningful overlap risk with closely related skills such as generic changelog tooling.

5 / 5

Total

20

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

nuxt-content/docus

Path

.claude/skills/release-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.