Agent skill

release-checklist

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

View SKILL.md on GitHub Repository
Stars 143
Forks 15

Install this agent skill to your Project

npx add-skill https://github.com/yonatangross/orchestkit/tree/main/src/skills/release-checklist

SKILL.md

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

Category Rules Impact When to Use
Pre-Release Gates 2 CRITICAL Before every release commit
Release Commit 2 HIGH Staging, committing, tagging, pushing

Total: 4 rules across 2 categories

Quick Start

bash
# 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.

Step Command Rule File
1. Build npm run build rules/gate-build-and-test.md
2. Tests npm test rules/gate-build-and-test.md
3. Security npm run test:security rules/gate-build-and-test.md
4. TypeScript npm run typecheck rules/gate-build-and-test.md
5. Validate counts /validate-counts rules/gate-counts-and-diff.md
6. Diff review git diff rules/gate-counts-and-diff.md

Release Commit

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

Step Action Rule File
7. Changelog Entry exists in CHANGELOG.md rules/commit-staging.md
8. Version bump package.json + CLAUDE.md both updated rules/commit-staging.md
9. Stage files git add <specific files> — never -A rules/commit-staging.md
10. Commit release: vX.Y.Z conventional format rules/commit-tag-push.md
11. Tag git tag vX.Y.Z rules/commit-tag-push.md
12. Push Run scripts/pre-push-confirm.sh — confirm first rules/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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

yonatangross/orchestkit

expect

Diff-aware AI browser testing — analyzes git changes, generates targeted test plans, and executes them via agent-browser. Reads git diff to determine what changed, maps changes to affected pages via route map, generates a test plan scoped to the diff, and runs it with pass/fail reporting. Use when testing UI changes, verifying PRs before merge, running regression checks on changed components, or validating that recent code changes don't break the user-facing experience.

143 15
Explore
yonatangross/orchestkit

github-operations

GitHub CLI operations for issues, PRs, milestones, and Projects v2. Covers gh commands, REST API patterns, and automation scripts. Use when managing GitHub issues, PRs, milestones, or Projects with gh.

143 15
Explore
yonatangross/orchestkit

chain-patterns

Chain patterns for CC 2.1.71 pipelines — MCP detection, handoff files, checkpoint-resume, worktree agents, CronCreate monitoring. Use when building multi-phase pipeline skills. Loaded via skills: field by pipeline skills (fix-issue, implement, brainstorm, verify). Not user-invocable.

143 15
Explore
yonatangross/orchestkit

storybook-mcp-integration

Storybook MCP server integration for component-aware AI development. Covers 6 tools across 3 toolsets (dev, docs, testing): component discovery via list-all-documentation/get-documentation, story previews via preview-stories, and automated testing via run-story-tests. Use when generating components that should reuse existing Storybook components, running component tests via MCP, or previewing stories in chat.

143 15
Explore
yonatangross/orchestkit

component-search

Search 21st.dev component registry for production-ready React components. Finds components by natural language description, filters by framework and style system, returns ranked results with install instructions. Use when looking for UI components, finding alternatives to existing components, or sourcing design system building blocks.

143 15
Explore
yonatangross/orchestkit

ai-ui-generation

AI-assisted UI generation patterns for json-render, v0, Bolt, and Cursor workflows. Covers prompt engineering for component generation, review checklists for AI-generated code, design token injection, refactoring for design system conformance, and CI gates for quality assurance. Use when generating UI components with AI tools, rendering multi-surface MCP visual output, reviewing AI-generated code, or integrating AI output into design systems.

143 15
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results