CtrlK
BlogDocsLog inGet started
Tessl Logo

release-readiness-review

Two-phase pattern for release readiness: Phase 1 audits build/vet/test/security/docs → report gaps. Phase 2 closes gaps and tags the release.

63

Quality

74%

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 ./.agents/skills/release-readiness-review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

90%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 lean, highly actionable, and clearly sequenced across two phases with concrete commands and a checklist. The main gap is workflow validation: there is no explicit gate confirming all gaps are closed before tagging and no feedback loop for smoke-test failure.

DimensionReasoningScore

Conciseness

The body is lean and command-driven with no padding or explanation of concepts Claude already knows (e.g. no "what is go vet"), matching the score-5 anchor of lean and efficient where every token earns its place; the only redundancy is the Overview restating the frontmatter, which is too minor to drop it to 4.

5 / 5

Actionability

Provides copy-paste-ready commands throughout ("go build ./cmd/server ./cmd/worker...", "govulncheck ./...", "git tag -a v0.0.1 -m ...", "docker compose build netrunner"), matching the score-5 anchor of fully executable examples covering common cases; placeholders like YYYY-MM-DD and <summary> are normal substitution points, not gaps.

5 / 5

Workflow Clarity

Two phases are clearly sequenced with a Phase 1 checklist and a Docker smoke-test verification, matching the score-4 anchor of clear sequence with most checkpoints present; not a 5 because there is no explicit "all gaps closed" gate before tagging and no feedback loop for smoke-test failure, and tagging/pushing a release is a hard-to-undo operation.

4 / 5

Progressive Disclosure

Well-organized into Overview, Phase 1, Phase 2, and Related Files with clear one-level pointers to docs/plans, CHANGELOG, and workflow files, matching the score-4 anchor of good structure with minor organization gaps; not a 5 because the body (~65 lines) exceeds the under-50-line simple-skill threshold and inlines the full checklist and typical-gaps content that could live in reference files.

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

The description clearly states what the skill does via a concrete two-phase pattern but omits any explicit "when to use it" trigger guidance, which caps completeness. Trigger terms are relevant but lack common synonyms users would naturally say.

Suggestions

Add an explicit trigger clause, e.g. "Use when preparing to ship, publish, or cut a release for NetRunner."

Broaden trigger terms with natural synonyms users say ("ship a release", "publish", "cut a release", "tag a release").

Optionally surface one or two concrete sub-actions (e.g. "runs go build/vet/test and govulncheck") to lift specificity toward 5.

DimensionReasoningScore

Specificity

Lists several concrete actions ("audits build/vet/test/security/docs", "report gaps", "closes gaps", "tags the release"), matching the score-4 anchor of several specific actions with minor coverage gaps; not a 5 because the actions stay high-level rather than enumerating comprehensive sub-tasks.

4 / 5

Completeness

It has a clear "what" (two-phase audit-then-close-and-tag pattern) but no "Use when..." or equivalent trigger guidance, so per the rubric cap it stays at 3; not a 2 because the "what" is explicit and concrete, not vague.

3 / 5

Trigger Term Quality

"release readiness" and "tag the release" are relevant keywords but common synonyms users say (ship, publish, cut a release) are absent, fitting the score-3 anchor of some relevant keywords missing common variations; not a 4 because natural-term coverage is thin.

3 / 5

Distinctiveness Conflict Risk

"release readiness" is a clear niche with distinct triggers and low overlap risk, matching the score-4 anchor of mostly distinct with minor overlap; not a 5 because the phrasing lacks the concrete trigger phrases that fully separate it from general release/CI skills.

4 / 5

Total

14

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
pvnkmnk/djinn-netrunner
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.