CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

draft-release-notes

Turn changelog-scan output into polished, categorized release notes draft. Propose only.

Quality

60%

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

Fix and improve this skill with Tessl

tessl review fix ./starters/changelog-drafter/.claude/skills/draft-release-notes/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%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 commendably lean and includes a thoughtful untrusted-input safety section appropriate to a skill that ingests issue/PR text, but it fatally defers its core specification to an unavailable external skill, leaving the executor without the actual structure, categories, or rules. It reads as a stub whose key dependency is a dangling reference rather than a self-contained or properly bundled skill.

Suggestions

Inline the actual structure and rules from the Grok draft-release-notes skill (section headings, category definitions, formatting rules) or ship them as a real bundle file in references/ and link to it, so the instruction 'Follow the exact structure...' is resolvable.

Add a compact worked example: a short changelog-scan input and the expected RELEASE_NOTES_DRAFT.md output with breaking/security flagged at top and the closing review note, making the guidance copy-paste executable.

Trim non-executable boilerplate from the body (the sync-script comment and background URL) into a comment or reference file so every remaining token serves execution.

DimensionReasoningScore

Conciseness

The core instructions are lean and assume Claude's competence with no concept explanations, matching 'efficient with minor trimmable instances'. The embedded untrusted-input block is justified safety guidance for a skill ingesting issue/PR text, but it carries meta-noise (the 'generated by scripts/sync-untrusted-input.mjs; edit it there' comment and background URL) that does not help execution, keeping it below anchor 5.

4 / 5

Actionability

The pivotal instruction — 'Follow the exact structure and rules from the Grok `draft-release-notes` skill' — defers to content that does not exist in this bundle (no references/, scripts/, or assets/ directories), so the actual structure, categorization scheme, and rules are unresolvable. Only fragments are concrete ('Output a clean `RELEASE_NOTES_DRAFT.md`', 'Always flag breaking + security at top', 'End with review note'), which matches 'high-level hints but missing the specific steps to execute'.

2 / 5

Workflow Clarity

An implicit sequence exists (take changelog-scan output, apply the structure, write the draft with breaking/security flagged at top, end with a human-review note), but steps are unlisted prose and the transform step depends on the missing Grok skill definition. This is not a destructive or batch operation, so no validation cap applies, but the sequence has gaps that keep it at anchor 3 rather than 4.

3 / 5

Progressive Disclosure

Sections are organized (title, core instructions, untrusted-input handling) and the body is short, but the one external reference it depends on — the Grok draft-release-notes skill — is a dangling pointer outside the bundle, with no local file containing the needed structure and rules. That broken navigation matches 'references present but not clearly signaled / could be better organized' rather than the well-signaled, resolvable references of anchor 4-5.

3 / 5

Total

12

/

20

Passed

Description

53%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.

The description states a clear, single-purpose 'what' in third person with a couple of concrete details (categorized, draft, propose-only), but it omits any 'when to use' trigger guidance and leans on the jargon term 'changelog-scan output'. It is functional but not competitive with the good examples that pair actions with explicit use-conditions.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user has changelog-scan output or asks to draft, write, or polish release notes from a changelog.'

Replace or supplement the tool-specific term 'changelog-scan output' with natural synonyms users would actually say (release notes, changelog, ship notes, version notes).

Briefly enumerate what 'categorized' means (e.g. features, fixes, breaking changes, security) to lift specificity from one action to several concrete ones.

DimensionReasoningScore

Specificity

The description names its domain ('changelog-scan output') and one concrete transformation ('Turn ... into polished, categorized release notes draft'), matching the anchor for 1-2 concrete actions but not comprehensive coverage. It lacks the several specific actions needed for anchor 4 (no mention of categories used, output format, or the proposal/review flow).

3 / 5

Completeness

The 'what' is clear (turn changelog-scan output into a categorized release-notes draft, proposal-only), but there is no 'Use when...' clause or equivalent explicit trigger guidance — the 'when' is only weakly implied by naming the input. Per the judging guidelines, a missing 'Use when...' clause caps completeness at 3.

3 / 5

Trigger Term Quality

'release notes', 'changelog', and 'draft' are relevant natural terms, but 'changelog-scan output' is tool-specific jargon rather than a phrase users say, and common variations like 'draft the release notes' or 'summarize the changelog' are missing. This sits at 'some relevant keywords but missing common variations' rather than good coverage.

3 / 5

Distinctiveness Conflict Risk

The changelog-scan-to-release-notes niche is fairly specific with distinct triggers, so it is mostly distinguishable from other skills. It carries minor overlap risk with generic changelog-writing or summarization skills because it never states its unique entry conditions, keeping it below anchor 5.

4 / 5

Total

13

/

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: 1 missing

Warning

Total

14

/

16

Passed

Repository

cobusgreyling/loop-engineering

Path

starters/changelog-drafter/.claude/skills/draft-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.