CtrlK
BlogDocsLog inGet started
Tessl Logo

release-cut

Use when preparing, cutting, tagging, publishing, or verifying an IPTVnator release or its release assets.

71

Quality

89%

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

SKILL.md
Quality
Evals
Security

Quality

Content

96%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 operational runbook: exact commands, an explicit destructive boundary, ordering constraints with justifications, validation at every risky step, and a failure-recovery section — all with near-zero token waste. The only real weakness is structural: detailed material lives in repo files outside the skill bundle, referenced via deep relative paths, so the skill is not self-contained as a bundle.

DimensionReasoningScore

Conciseness

The body is dense and lean: no boilerplate, no explanation of concepts Claude already knows, and every line carries non-obvious project-specific facts (e.g., "`--silent`, or pnpm's lifecycle banner lands in the saved post", "Steps 5 and 6 must precede `--consume`: `highlight:` exists only in the note files it deletes"). It matches anchor 5 — every token earns its place and Claude's competence is assumed throughout.

5 / 5

Actionability

Nearly every step ships an exact, copy-paste-ready command (`pnpm run release:notes:changelog`, `pnpm nx run electron-backend:build-e2e`, `git push upstream v0.25.1`, `node tools/release/build-release-notes.mjs --consume`), including exact commit/tag forms and a worked remote+version example. This matches anchor 5 (fully executable, common cases covered); the few manual steps ("publish the release", "finish every editorial field") are genuinely human actions, not gaps.

5 / 5

Workflow Clarity

The process is explicitly sequenced (Preflight → Generate 1-7 → Push → publish → Failure Safety) with validation checkpoints at every risky boundary: `release:notes:validate` and `i18n:check` before tagging, `release:verify:draft` after the tag build, an explicit destructive boundary ("The consume command is the destructive boundary"), ordering constraints with reasons, and a recovery loop in Failure Safety. Anchor 5 (explicit validation, feedback loops, error recovery) is matched; the destructive-batch cap of 3 does not apply because verification steps are present.

5 / 5

Progressive Disclosure

The skill is well organized into clear sections and delegates the bulk detail ("Full contract, asset table and rationale: `docs/architecture/release-pipeline.md`") one level deep, keeping the body a tight overview. However, those references point to repo files outside the skill bundle (no references/, scripts/, or assets/ directories exist), one via a fragile `../../../docs/development/release-cover-artwork.md` relative path, so navigation depends on external files this bundle cannot vouch for — good structure with minor organization gaps, i.e., anchor 4 rather than the fully self-contained, clearly-signaled navigation of anchor 5.

4 / 5

Total

19

/

20

Passed

Description

78%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 lean, well-targeted trigger description with concrete verbs and an explicit "Use when" clause tied to a specific project's release process. Its main weakness is that the "what" is only implied by the trigger verbs, with no explicit capability statement or common synonyms like "ship", "changelog", or "release notes".

Suggestions

Add an explicit what-clause before the trigger, e.g., "Cuts, tags, and publishes IPTVnator releases end to end, generating release notes and verifying assets. Use when preparing, cutting, tagging, publishing, or verifying an IPTVnator release or its release assets."

Include a few natural synonyms users might say, such as "ship", "version bump", "changelog", or "release notes", to broaden trigger coverage.

Mention the artifact types it covers (GitHub release, Docker image, Snap, blog/Telegram/Reddit announcements) so the scope of "release assets" is concrete at trigger time.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "preparing, cutting, tagging, publishing, or verifying" an IPTVnator release — rather than vague language, but they are framed purely as trigger conditions with no separate statement of what the skill does (e.g., generating notes, building assets, pushing tags), which is a minor coverage gap. This matches anchor 4 ('lists several specific actions; minor gaps') better than anchor 3 (only 1-2 actions) and falls short of anchor 5's comprehensive what-coverage.

4 / 5

Completeness

The "when" is explicit and strong ("Use when preparing, cutting, tagging, publishing, or verifying an IPTVnator release or its release assets"), and the verbs imply the "what", but there is no explicit standalone what-clause (e.g., "Cuts, tags, and publishes IPTVnator releases end to end"). This sits between anchor 3 (clear what, weak when — the mirror image of this description) and anchor 5 (both explicit), landing at anchor 4; it is not missing either element, so anchor 3 would undervalue the explicit trigger guidance.

4 / 5

Trigger Term Quality

Natural phrases users would actually say are present — "preparing", "cutting", "tagging", "publishing", "verifying", "release", "release assets" — giving good keyword coverage. A few common synonyms are missing (e.g., "ship", "version bump", "changelog", "release notes"), so it does not reach anchor 5's comprehensive synonym coverage, but it clearly exceeds anchor 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

The description is scoped to a clear niche — releases of the specific project "IPTVnator" and their assets — with distinct verbs (cut, tag, verify draft) unlikely to fire for unrelated skills. It matches anchor 5 (clear niche with distinct triggers; minimal conflict risk) and is clearly above anchor 4's minor overlap risk.

5 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository
4gray/iptvnator
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.