CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

release

Prepare rtp2httpd release notes or publish a requested version, including prerelease and stable-branch handling.

Quality

82%

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

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-orchestrated skill body: lean token use, concrete decision rules and prohibitions, explicit CI/authorization checkpoints for risky publication steps, and exemplary progressive disclosure that keeps executable detail in two clearly-scoped, verified reference files loaded only when needed. The only minor gaps are operational terms defined only one level deep.

DimensionReasoningScore

Conciseness

The 26-line body is lean and efficient with zero padding: every sentence carries project-specific facts Claude cannot infer (authorization semantics, cumulative-notes rules, CI gates, stable-branch timing). It assumes Claude's competence and never explains concepts it already knows, matching anchor 5 ('every token earns its place').

5 / 5

Actionability

For an instruction-only skill the guidance is concrete and executable: specific decision rules ("Use the user's target tag or release type... ask only for the missing version decision"), explicit prohibitions ("Never force-push main/stable, move an existing release tag, or delete/recreate a published release"), and concrete deliverables ("Report the notes file or published release URL, exact tag, cleanup/stable results, and actual CI status"). It is not anchor 5 because some operational terms (e.g., "collapse same-series prerelease notes") are not defined until one level down in the references, leaving minor gaps in the body itself.

4 / 5

Workflow Clarity

The flow is clearly sequenced (match requested outcome → select and load the right reference → resolve version → execute under invariants → report completion) with explicit validation checkpoints: "Publish from an up-to-date, clean main release checkout", "update stable after the versioned Makefiles job succeeds", and an explicit failure path ("report the concrete blocker and remaining work"). Because destructive-operation validation checkpoints are present, the cap at 3 does not apply; it falls short of anchor 5 only because the detailed publish step ordering and fix-retry loops live in publishing.md rather than the body.

4 / 5

Progressive Disclosure

The body is a proper overview with two well-signaled, one-level-deep references that both exist and match their stated scopes: "For notes, version selection, and cumulative prerelease history, read [notes.md]" and "For build preparation, publication, recovery, and CI/stable handling, read [publishing.md]. Load it only when preparing or executing publication." The explicit lazy-load instruction and clean split of overview vs. executable detail match anchor 5 exactly.

5 / 5

Total

18

/

20

Passed

Description

70%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 concise, project-scoped description with concrete capabilities and strong distinctiveness. Its main weakness is the complete absence of a 'Use when...' trigger clause, which caps completeness and limits discoverability when users phrase requests informally (e.g., "cut a release", "draft the changelog").

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to draft or publish rtp2httpd release notes, cut or tag a version, or prepare a prerelease or stable-branch update."

Include common synonyms users naturally say — "changelog", "cut a release", "tag a version" — to broaden trigger-term coverage from good to comprehensive.

Mention adjacent capabilities the skill actually covers (e.g., version selection, CI/stable-branch handling after publish) to close the minor specificity gaps toward anchor 5.

DimensionReasoningScore

Specificity

The description lists two concrete primary actions ("Prepare rtp2httpd release notes", "publish a requested version") plus two named handling scopes ("prerelease and stable-branch handling"), matching anchor 4's 'several specific actions; minor gaps in coverage'. It falls short of anchor 5 because it omits adjacent capabilities like version selection or CI verification that the skill actually covers.

4 / 5

Completeness

The 'what' is clearly stated (prepare release notes or publish a version) but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. This exactly matches anchor 3's example ('Extract text and tables from PDF files, fill forms, merge documents') — clear what, missing when; it is not anchor 4 because no when-clause exists even weakly.

3 / 5

Trigger Term Quality

Natural keywords users would say are present: "release notes", "publish", "version", "prerelease", "stable-branch". This matches anchor 4 ('good keyword coverage; a few natural terms missing') rather than anchor 5 because common variations like "changelog", "cut a release", "tag a version", or "GitHub release" are absent.

4 / 5

Distinctiveness Conflict Risk

The project-specific name "rtp2httpd" gives the skill a clear niche with distinct triggers and minimal conflict risk with other skills, matching anchor 5. It cannot be anchor 4 because there is no meaningful overlap with closely related skills — the description only fires for a single named project's releases.

5 / 5

Total

16

/

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

stackia/rtp2httpd

Path

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