CtrlK
BlogDocsLog inGet started
Tessl Logo

stave-release

Release workflow for the Stave repository that confirms whether the next release is patch or minor before bumping the version, reviews the actual PR changes and PR description `Changes` sections in the release scope instead of relying on commit titles alone, generates release notes with `conventional-changelog`, and opens a pull request against `main` from a dedicated temporary release worktree so the user's original checkout stays on its original branch. Use when the user asks to cut the next release, ship the current changes as a versioned release, or prepare a release PR. After the PR merges, the repository's GitHub Actions workflow builds and publishes the release artifacts automatically.

72

Quality

88%

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

85%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.

Excellent actionability and workflow clarity — every step is executable with explicit validation checkpoints and recovery paths. The weaknesses are redundancy between the inline workflow, the Guardrails section, and the bundled checklist reference, which inflates token cost and blurs what belongs in SKILL.md versus the reference file.

Suggestions

Consolidate the release sequence: keep SKILL.md as a lean overview of the workflow shape and move the detailed step-by-step sequence into references/stave-release-checklist.md, or drop the reference and keep the detail inline — currently both carry the same sequence.

Deduplicate the Guardrails section against inline rules (e.g. 'Never push directly to main', worktree removal rules, commit-title reliance each appear twice); keep guardrails only for rules not already enforced in their step.

Where steps need emphasis (e.g. 'Never push directly to `main`'), bold the rule inline in its step instead of restating it in a separate 21-bullet list.

DimensionReasoningScore

Conciseness

The body is dense with directive, executable steps and assumes Claude's competence — no git or changelog concepts are explained. However, the 21-bullet Guardrails section substantially restates rules already stated inline (e.g. 'Never push directly to `main`' appears in step 8 and again in Guardrails; worktree-removal and commit-title rules are likewise duplicated), so it could be tightened. Matches 'efficient; minor instances... that could be trimmed' rather than the every-token-earns-its-place of score 5.

4 / 5

Actionability

Fully executable, copy-paste-ready commands throughout: `git rev-parse --show-toplevel`, `git tag --list 'v*' --sort=-version:refname | head -5`, `bunx --bun conventional-changelog-cli -p conventionalcommits -i CHANGELOG.md -s`, `bun run typecheck`, `git stash push --include-untracked -m "worktree-pr:release-x.y.z:<timestamp>"`, `git worktree add -b release-x.y.z ../.worktrees/<repo>/release-x.y.z HEAD`, `gh pr create --base main`. Concrete outputs are specified too (commit message `chore: release x.y.z`, 3–7 bullet summary shape).

5 / 5

Workflow Clarity

A clear 10-step sequence with explicit validation checkpoints and feedback loops: pre-flight state checks (step 2), 'Verify before commit' with failure handling (step 6), post-PR diff review (step 8), and cleanup with a documented retry-once recovery path for a known failure mode ('If cleanup fails only because the shell is still inside the target worktree... change back... and retry once'). This matches the score-5 anchor with error-recovery guidance, not just the checkpoints of score 4.

5 / 5

Progressive Disclosure

The single reference `references/stave-release-checklist.md` exists in the bundle, is one level deep, and is clearly signaled at the top — but the body then inlines a full 127-line detailed sequence plus guardrails, which overlaps the reference's 'exact sequence' content (the checklist repeats the same release steps and repo facts). The body itself directs the reader to the checklist 'for the exact sequence and repair rules' and then duplicates it, which is the 'content that should be separate is inline / could be better organized' pattern of score 3 rather than the 'most content appropriately placed' of score 4.

3 / 5

Total

17

/

20

Passed

Description

92%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 description: concrete, comprehensive action list in third person, an explicit multi-phrase 'Use when' trigger clause, and a clearly scoped niche (Stave repository releases). The only gap is minor — a few natural trigger synonyms such as 'version bump' or 'publish a release' are not covered.

DimensionReasoningScore

Specificity

Lists multiple concrete actions with comprehensive coverage: 'confirms whether the next release is patch or minor before bumping the version', 'reviews the actual PR changes and PR description `Changes` sections', 'generates release notes with `conventional-changelog`', 'opens a pull request against `main` from a dedicated temporary release worktree'. Third person voice is used throughout ('confirms', 'reviews', 'generates', 'opens'), so no voice penalty applies.

5 / 5

Completeness

Explicitly answers both questions: the 'what' is fully detailed (bump confirmation, PR-change review, changelog generation, PR from a worktree) and the 'when' is an explicit trigger clause: 'Use when the user asks to cut the next release, ship the current changes as a versioned release, or prepare a release PR.' Not score 4 because the 'when' here is concrete and multi-phrase, not merely present.

5 / 5

Trigger Term Quality

The 'Use when' clause gives natural phrases users would actually say — 'cut the next release', 'ship the current changes as a versioned release', 'prepare a release PR' — but common variations like 'version bump', 'publish a release', or 'write the changelog/release notes' are absent. Good keyword coverage with a few natural terms missing, matching the score-4 anchor rather than the comprehensive synonym coverage of score 5.

4 / 5

Distinctiveness Conflict Risk

Clearly scoped to 'the Stave repository' with distinct triggers ('cut the next release', 'release PR', 'ship the current changes as a versioned release'), giving it a clear niche with minimal overlap risk against generic versioning or changelog skills.

5 / 5

Total

19

/

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
sendbird/stave
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.