CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

draft-release-notes

Takes a structured list of changes from changelog-scan and produces a clean, categorized, user-facing release notes draft. Follows project voice and conventions. Never publishes — only proposes a draft file or section.

Quality

76%

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

Fix and improve this skill with Tessl

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

Quality

Content

86%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 tight, well-structured instruction skill: concrete output contract, explicit drafting rules, and a useful escalation section, with no verbosity or filler. The only improvements are small — one worked example of a drafted entry, an explicit fallback/output step ordering, and handling of missing scan input.

DimensionReasoningScore

Conciseness

Lean and efficient throughout: a compact inputs list, one copy-paste template with "adapt section names to what actually exists; omit empty sections", one-line rules, and a tight escalation list. No concepts Claude already knows are explained; every line carries operational information, and the generated untrusted-input block is functional safety guidance rather than padding.

5 / 5

Actionability

Concrete and executable — exact output path (RELEASE_NOTES_DRAFT.md), a full draft template including the compare-link and thanks lines, and specific rules ("Always call out breaking changes and security items at the top"; "Never claim a change was made if it was not in the scanned input"). Minor gaps keep it below 5: no worked example of a single drafted entry, and "or print it clearly so the loop can save it" is slightly ambiguous about the fallback behavior.

4 / 5

Workflow Clarity

The flow is clear — read the scan output, check the escalation criteria (">40 items", breaking/security items, "human review needed first"), write the draft, then update state with the draft location and "pending human review" — with the escalation list acting as a pre-flight checklist. Minor validation gaps: no guidance for missing or malformed changelog-scan input, and the final state-update step is stated in passing rather than sequenced, so it does not reach the explicit error-recovery-loop level of a 5.

4 / 5

Progressive Disclosure

A short (~50 core lines) single-file skill with no need for external references, and no references/scripts/assets bundle exists. Sections (Inputs, Output, Rules, When to Escalate) are well-organized and the only external link is a one-level-deep background pointer; per the rubric's simple-skill guidance this earns a 5 on organization alone.

5 / 5

Total

18

/

20

Passed

Description

58%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 crisp, third-person description with a clear "what" and an explicit scope boundary (never publishes), but it omits any "Use when..." trigger clause and lacks common trigger synonyms like "changelog" or "version". Completeness and trigger-term coverage are the main weaknesses.

Suggestions

Append an explicit trigger clause, e.g. "Use when the user asks for release notes, a changelog draft, or a summary of what changed in a release/version."

Add natural trigger synonyms such as "changelog", "version", "what's changed", and "announce a release" so users' phrasing matches the description.

Mention the breaking-change/security callout behavior in the description so the safety-critical part of the "what" is discoverable from the description alone.

DimensionReasoningScore

Specificity

Names several concrete actions in third person — "takes a structured list of changes from changelog-scan", "produces a clean, categorized, user-facing release notes draft", "follows project voice and conventions", "never publishes — only proposes a draft file or section" — with only minor coverage gaps (no mention of breaking-change callouts or escalation behavior). Not 5 because coverage is not comprehensive; not 3 because more than 1-2 specific actions are explicitly stated.

4 / 5

Completeness

The "what" is clearly stated (produces a categorized, user-facing release-notes draft from changelog-scan output), but there is no "Use when..." clause or equivalent explicit trigger guidance — the "when" is only weakly implied via the changelog-scan dependency. The rubric guideline caps completeness at 3 for a missing explicit trigger clause.

3 / 5

Trigger Term Quality

"release notes" and "draft" are natural terms a user would say, but common variations and synonyms are missing: "changelog", "version", "what's changed", "ship notes", "announce a release". Fits the anchor "some relevant keywords but missing common variations or synonyms"; not 4 because several natural user phrases would not trigger this description.

3 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (release-notes drafting) with an explicit boundary — "Never publishes — only proposes a draft file or section" — leaving only minor overlap risk with a changelog-scan or general writing/summarizing skill. Not 5 because it shares trigger space with any "summarize the changes" request and depends on a sibling skill's name for distinctiveness.

4 / 5

Total

14

/

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/.grok/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.