Skill

release-checklist

Install
1
Install the plugin
$
npx claudepluginhub yonatangross/orchestkit --plugin ork

Want just this skill?

Add to a custom plugin, then install with one command.

Description

Validates release readiness with gated checklist — build, test, count validation, changelog, version bump. Use when preparing a release.

Tool Access

This skill is limited to using the following tools:

ReadBashGrepGlob
Supporting Assets
View in Repository
references/release-flow.md
rules/_sections.md
rules/_template.md
rules/commit-staging.md
rules/commit-tag-push.md
rules/gate-build-and-test.md
rules/gate-counts-and-diff.md
scripts/pre-push-confirm.sh
test-cases.json
Skill Content

Release Checklist

Sequential release gate for OrchestKit. Each step reports [PASS] or [FAIL]. Stop on first failure, suggest a fix, then continue after user confirmation.

Load details: Read("${CLAUDE_SKILL_DIR}/references/release-flow.md") for why the order matters and hotfix guidance.

Quick Reference

CategoryRulesImpactWhen to Use
Pre-Release Gates2CRITICALBefore every release commit
Release Commit2HIGHStaging, committing, tagging, pushing

Total: 4 rules across 2 categories

Quick Start

# Run all pre-release gates in order (stop on first failure)
npm run build && npm test && npm run test:security && npm run typecheck
bash src/skills/validate-counts/scripts/validate-counts.sh
git diff  # review before staging

Pre-Release Gates

Must all pass before writing any release commit. See rules/gate-build-and-test.md and rules/gate-counts-and-diff.md.

StepCommandRule File
1. Buildnpm run buildrules/gate-build-and-test.md
2. Testsnpm testrules/gate-build-and-test.md
3. Securitynpm run test:securityrules/gate-build-and-test.md
4. TypeScriptnpm run typecheckrules/gate-build-and-test.md
5. Validate counts/validate-countsrules/gate-counts-and-diff.md
6. Diff reviewgit diffrules/gate-counts-and-diff.md

Release Commit

Steps after all gates pass. See rules/commit-staging.md and rules/commit-tag-push.md.

StepActionRule File
7. ChangelogEntry exists in CHANGELOG.mdrules/commit-staging.md
8. Version bumppackage.json + CLAUDE.md both updatedrules/commit-staging.md
9. Stage filesgit add <specific files> — never -Arules/commit-staging.md
10. Commitrelease: vX.Y.Z conventional formatrules/commit-tag-push.md
11. Taggit tag vX.Y.Zrules/commit-tag-push.md
12. PushRun scripts/pre-push-confirm.sh — confirm firstrules/commit-tag-push.md

Related Skills

  • validate-counts — Count consistency check (step 5 of this checklist)
  • audit-skills — Broader skill quality audit (run before major releases)
  • checkpoint-resume — Rate-limit-resilient pipelines for long release sessions

Common Mistakes

  1. Running npm test before npm run build — tests run against stale dist
  2. Using git add -A — accidentally stages secrets or unrelated in-progress work
  3. Forgetting to bump CLAUDE.md version alongside package.json
  4. Pushing without explicit user confirmation — irreversible on shared remotes
  5. Skipping security tests — non-negotiable, even for patch releases
Stats
Stars128
Forks14
Last CommitMar 10, 2026
Actions

Similar Skills