Agent skill

releasing-kata

Use this skill when releasing Kata Desktop, Kata CLI, Kata Orchestrator, Kata Context, or Symphony, bumping versions, updating changelogs, or creating release PRs. Triggers include "release", "bump version", "publish", "create release PR", "ship it", "cut a release".

View SKILL.md on GitHub Repository
Stars 28
Forks 2

Install this agent skill to your Project

npx add-skill https://github.com/gannonh/kata/tree/main/.agents/skills/releasing-kata

SKILL.md

Releasing Kata

Kata has five independently versioned release targets. Ask which target if not clear from context.

Target Package Tag Format Reference
Desktop @kata-sh/desktop desktop-vX.Y.Z references/desktop-release.md
CLI @kata-sh/cli cli-vX.Y.Z references/cli-release.md
Orchestrator @kata-sh/orc orc-vX.Y.Z references/orc-release.md
Context @kata/context context-vX.Y.Z references/context-release.md
Symphony symphony (Rust binary) symphony-vX.Y.Z references/symphony-release.md

Root package.json version is 0.0.0 — never touch it. Each app owns its own version. Versions are independent and do not need to match.

Version semantics

Type When Example
patch Bug fixes, small improvements 0.4.9 → 0.4.10
minor New features, backward compatible 0.4.9 → 0.5.0
major Breaking changes 0.4.9 → 1.0.0

Workflow

Once the target is identified, read the corresponding reference file for the full release steps, CI behavior, and acceptance criteria. Then follow it.

Troubleshooting

For build failures, code signing, notarization, and CI issues, read release-troubleshooting.md.

Quick checks:

  • CI didn't trigger: Version in package.json must differ from existing git tags
  • Desktop CI fails: gh run list --workflow=desktop-release.yml --limit 3
  • CLI publish fails: Ensure NPM_TOKEN secret is set and private: false in apps/cli/package.json
  • Orchestrator CI didn't trigger: Changes must be under apps/orchestrator/**; version must differ from existing orc-v* tags
  • Orchestrator publish fails: Ensure NPM_TOKEN secret is set; check apps/orchestrator/package.json has no private: true
  • Context CI didn't trigger: Changes must be under apps/context/**; version must differ from existing context-v* tags
  • Context publish fails: Ensure NPM_TOKEN secret is set; check apps/context/package.json has no private: true
  • Symphony CI didn't trigger: Changes must be under apps/symphony/**; version in Cargo.toml must differ from existing symphony-v* tags
  • Symphony build fails: Ensure Rust toolchain is installed; check cargo build --release locally first
  • macOS notarization fails: Verify APPLE_ID, APPLE_APP_SPECIFIC_PASSWORD, APPLE_TEAM_ID secrets

Recommended Agent Skills

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

gannonh/kata

kata-context

Structural and semantic codebase intelligence with persistent memory — index TypeScript and Python repos into a knowledge graph with vector embeddings, query symbol dependencies, run semantic search by intent, search code patterns, fuzzy-find symbols, and persist/recall agent memories with git audit trail. Use when you need to understand code structure, find what depends on a symbol, trace dependencies, search by meaning, search for code patterns, find symbols by name, or remember/recall project decisions, patterns, and learnings.

28 2
Explore
gannonh/kata

claude-md-improver

Audit and improve CLAUDE.md files in repositories. Use when user asks to check, audit, update, improve, or fix CLAUDE.md files. Scans for all CLAUDE.md files, evaluates quality against templates, outputs quality report, then makes targeted updates. Also use when the user mentions "CLAUDE.md maintenance" or "project memory optimization".

28 2
Explore
gannonh/kata

frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

28 2
Explore
gannonh/kata

debug-like-expert

Deep analysis debugging mode for complex issues. Activates methodical investigation protocol with evidence gathering, hypothesis testing, and rigorous verification. Use when standard troubleshooting fails or when issues require systematic root cause analysis.

28 2
Explore
gannonh/kata

swiftui

SwiftUI apps from scratch through App Store. Full lifecycle - create, debug, test, optimize, ship.

28 2
Explore
gannonh/kata

sym-address-comments

Help address review/issue comments on the open GitHub PR for the current branch using gh CLI; verify gh auth first and prompt the user to authenticate if not logged in.

28 2
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results