CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

release-digest

Post a "what's changed since the last release" recap to the release Slack channel for final QA. Groups merged PRs by author and classifies each as feature / bug fix / task. Use when the user wants a release recap, a changelog since the last tag, or to prep QA before cutting a release from main.

75

Quality

94%

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

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.

A highly actionable, well-sequenced workflow with executable commands, an exact output template, validation checkpoints, and a checklist — the reference to the bundled gather script is real and matches its documented flags and JSON fields. The only improvements are token-level: trim the duplicated --pre-release/on-demand guidance and consider moving the classification rulebook to a reference file.

Suggestions

State the '--pre-release implies use the newest tag as <new_release>' rule once (Phase 1 or Phase 3) instead of twice, and drop the 'This is on-demand' sentence that restates the description's trigger.

Consider moving the ~40-line classification decision order and model-catalog rules into a references/ file (e.g. references/classification.md), keeping only the three bucket definitions inline in SKILL.md.

The JSON field inventory in Phase 1 could drop the per-field commentary for self-explanatory fields (e.g. pr_count, commit_count) to save tokens without losing actionability.

DimensionReasoningScore

Conciseness

The body is dense with operational detail and assumes Claude's competence (no concept explanations, no library tutorials), matching the 4 anchor ('efficient; minor instances of over-explanation that could be trimmed'). Not 5 because of small redundancies: the --pre-release tag-selection rule is stated in Phase 1 and restated in Phase 3, and 'This is on-demand: run it when someone asks' repeats the description's trigger. Not 3 since these trims are minor and everything else earns its tokens.

4 / 5

Actionability

Fully executable end-to-end: copy-paste gather commands (including --pre-release and --since variants), a complete JSON field inventory to consume, a decision-ordered classification procedure with concrete examples, an exact Slack mrkdwn message template, the channel ID, and the exact MCP tool name. Edge cases (empty range, direct commits, #null rendering, unresolved PRs) are covered, matching the 5 anchor.

5 / 5

Workflow Clarity

Four clearly sequenced phases with explicit validation and feedback loops: stop on empty range, report unresolved PRs before posting, require user confirmation before the outward-facing Slack post, a slack_search_channels fallback if the channel ID fails, and a closing checklist. This matches the 5 anchor (explicit validation steps, error-recovery loops, checklist); the destructive/batch cap at 3 does not apply because confirmation before posting is present.

5 / 5

Progressive Disclosure

Structure is good: well-labeled phase sections and a single one-level-deep reference to the real script at scripts/gather_changes.py with exact paths. It matches the 4 anchor ('most content appropriately placed, minor organization gaps') rather than 5, because the ~40-line classification rulebook and JSON schema inventory are inlined in SKILL.md and could partially live in a reference file for a ~200-line skill.

4 / 5

Total

18

/

20

Passed

Description

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

An exemplary description: concrete third-person actions, explicit and multi-phrase 'Use when' triggers, and a clearly scoped niche (release QA recap posted to Slack). The only weakness is minor overlap risk with a generic changelog skill via the 'changelog since the last tag' trigger.

DimensionReasoningScore

Specificity

The description lists three concrete actions in third person — 'Post a "what's changed since the last release" recap to the release Slack channel for final QA', 'Groups merged PRs by author', 'classifies each as feature / bug fix / task' — covering the full task. It matches the 5 anchor (multiple specific concrete actions, comprehensive coverage) and is not 4, since no meaningful capability is left out.

5 / 5

Completeness

Both questions are explicitly answered: the 'what' (post a recap to the release Slack channel, group by author, classify as feature/bug fix/task) and an explicit 'Use when the user wants a release recap, a changelog since the last tag, or to prep QA before cutting a release from main' trigger clause. This mirrors the rubric's 5-anchor example structure exactly; not 4 because the 'when' is explicit and specific rather than vague.

5 / 5

Trigger Term Quality

Natural user phrasings are comprehensively covered with synonyms: 'release recap', 'what's changed since the last release', 'a changelog since the last tag', and 'prep QA before cutting a release'. It matches the 5 anchor's comprehensive synonym coverage; the 4 anchor requires 'a few natural terms missing', and no significant phrasing is absent.

5 / 5

Distinctiveness Conflict Risk

The Slack-recap/QA framing and release-specific triggers create a clear niche with minimal conflict risk, matching the 4 anchor ('mostly distinct; minor overlap risk'). It is not 5 because the trigger 'a changelog since the last tag' could plausibly fire a generic changelog-generation skill, and not 3 since the release/QA/Slack context strongly disambiguates.

4 / 5

Total

19

/

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

Kiln-AI/Kiln

Path

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