CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

herdr-pre-release-audit

Audit herdr release readiness by comparing commits since the base release against next-release changelog and docs. Use when asked to run or apply the repo's pre-release audit, validate docs/next before release, inspect issue refs that release CI will close, or finalize release docs for herdr.

Quality

92%

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 progressive-disclosure skill: a lean overview that delegates all detail to a single, verified, self-contained reference workflow, with a sensible read-only-by-default guardrail. The only minor gap is that the body offers no inline example of the audit's output or common cases, relying entirely on the pointer.

DimensionReasoningScore

Conciseness

The ~20-line body is lean and assumes competence: a delegation instruction, an ordered scope list, and an edit-safety guardrail, with no explanation of concepts Claude already knows and no padding. Every token earns its place; the bullet list serves scope-setting for the delegated reference, not filler.

5 / 5

Actionability

Guidance is concrete and executable — an exact path ('Read references/pre-release-audit.md and follow its workflow') and a named command ('just release-docs-check') — and the referenced file contains fully executable git/just commands. Not 5 because the body itself is purely a pointer with no inline examples covering the common cases; not 3 because nothing is vague or pseudocode-like.

4 / 5

Workflow Clarity

This is a simple, single-purpose skill under 50 lines whose single action is unambiguous: read the reference and follow its workflow. The audit is read-only by default with an explicit validation-minded guardrail ('Do not edit files during the audit unless the user explicitly asks to apply fixes'), and the reference supplies the full sequenced workflow with explicit checkpoints, so the simple-skill exception applies.

5 / 5

Progressive Disclosure

The body is a clear overview that delegates to one well-signaled reference one level deep; the bundle listing confirms references/pre-release-audit.md exists as a real, self-contained workflow with no nested file references, and the bullet list previews exactly what it covers. Easy navigation with an appropriate content split.

5 / 5

Total

19

/

20

Passed

Description

87%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 strong, third-person description that clearly states what the skill does and gives multiple explicit, natural trigger phrases. Its only weaknesses are minor: the capability list is not fully comprehensive and a few natural synonyms (e.g., 'release notes') are absent.

DimensionReasoningScore

Specificity

The description names the domain and several concrete actions ('Audit herdr release readiness by comparing commits since the base release against next-release changelog and docs', 'inspect issue refs that release CI will close', 'finalize release docs'), but coverage has minor gaps — e.g., localized-docs parity and the release-docs-check step are not surfaced. Not 5 because the action list is not comprehensive; not 3 because it goes beyond 1-2 actions.

4 / 5

Completeness

It explicitly answers both parts: the what ('Audit herdr release readiness by comparing commits since the base release against next-release changelog and docs') and the when ('Use when asked to run or apply the repo's pre-release audit, validate docs/next before release, inspect issue refs that release CI will close, or finalize release docs for herdr') with concrete trigger phrases. Matches the anchor for a clear what and explicit when with concrete triggers.

5 / 5

Trigger Term Quality

Good natural keyword coverage ('pre-release audit', 'validate docs/next before release', 'changelog', 'issue refs', 'finalize release docs', 'herdr') that mirrors what a repo operator would say. Not 5 because common synonyms and variations such as 'release notes', 'changelog check', or 'cut/bump a release' are missing.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche scoped to the herdr repository's release process, with distinct triggers (pre-release audit, docs/next validation, issue refs that release CI will close) that are unlikely to fire for unrelated skills. Minimal conflict risk.

5 / 5

Total

18

/

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

KennethJefferson/HerdrPlus

Path

__references/herdr/.codex/skills/herdr-pre-release-audit/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.