CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

release-maintainer

Internal maintainer SOP for version bumps, release PRs, tagging, publishing, and post-publish verification in this repository.

68

Quality

85%

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

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 lean wrapper skill: it adds only repo-specific guardrails and validation hooks while deferring the canonical recipe to a clearly signaled external document. The only weakness is that a reader without access to the referenced doc cannot execute the core release steps from this file alone.

DimensionReasoningScore

Conciseness

The body is entirely repo-specific guardrails, checklists, and commands with zero padding or explanation of concepts Claude already knows; every token earns its place, matching the lean-and-efficient anchor.

5 / 5

Actionability

Concrete executable commands are given (the `gh api graphql` auth check, `mise run ci`, `gh run view ... --json status,conclusion,jobs`, `doctor --json` `.result.ok`, `NODE_BIN`), but the core step-by-step recipe is delegated to `docs/RELEASE-PROCESS.md`, so guidance is not fully copy-paste executable standalone — mostly executable with minor gaps rather than anchor 5.

4 / 5

Workflow Clarity

A clear ordered flow (Preflight → Execution Checklist → Failure Recovery) with explicit validation checkpoints — real API call for auth, structured CI wait, tag-merged-commit-only, and "verify both npm installation and GitHub Release asset installation before announcing" — plus a dedicated error-recovery feedback loop for mistagged releases, matching the 5 anchor; the destructive-operation cap does not apply because validation steps are present.

5 / 5

Progressive Disclosure

The short, well-sectioned body keeps a single one-level-deep reference to the canonical `docs/RELEASE-PROCESS.md`, clearly signaled and consistently pointed to instead of duplicating it; there are no bundle files to inline and no nested references.

5 / 5

Total

19

/

20

Passed

Description

75%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 specific, distinctive, third-person description that names the full release lifecycle, but it omits any explicit trigger guidance ("Use when..."), which caps completeness. Adding a when-to-use clause with natural trigger phrases would lift it substantially.

Suggestions

Append an explicit trigger clause, e.g. "Use when asked to bump the package version, cut a release, publish to npm, or verify a published release in this repository."

Include natural maintainer synonyms such as "cut a release" or "npm publish" alongside the existing terms to broaden trigger coverage.

State the when-condition inline rather than relying only on the "in this repository" scoping phrase, which describes scope but not invocation timing.

DimensionReasoningScore

Specificity

The description enumerates five concrete release-lifecycle actions ("version bumps, release PRs, tagging, publishing, and post-publish verification") in third-person voice, matching the comprehensive-coverage anchor; nothing meaningful is missing within its domain, so it is not a 4.

5 / 5

Completeness

The "what" is explicit and clear, but there is no "Use when..." clause or equivalent trigger guidance; the rubric explicitly caps completeness at 3 in that case. "in this repository" scopes the skill rather than stating when to invoke it.

3 / 5

Trigger Term Quality

"version bumps", "release PRs", "tagging", and "publishing" are natural maintainer phrases, but common synonyms like "cut a release", "npm publish", or "changelog" are absent, fitting the good-coverage-with-a-few-missing-terms anchor rather than the comprehensive one.

4 / 5

Distinctiveness Conflict Risk

"Internal maintainer SOP ... in this repository" carves out a distinct release-maintenance niche unlikely to fire for unrelated skills, matching the clear-niche anchor; overlap with generic versioning or changelog skills is minimal.

5 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 1 suspicious

Warning

Total

14

/

16

Passed

Repository

coder/agent-tty

Path

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