kata

kata — Claude Code Plugin

The kata Claude Code plugin: a curated set of skills and references that encode the 0k-software development workflow — issue creation, PR review, plan-driven implementation, branch hygiene, and a few quality-of-life helpers.

This repository is the plugin. Its root is the plugin root, with .claude-plugin/plugin.json declaring the manifest. The plugin is published through the 0k-software/0k-plugins marketplace (see Installing below).

Installing the plugin

From any Claude Code session, register the marketplace and install:

/plugin marketplace add 0k-software/0k-plugins
/plugin install kata@0k-plugins

Once installed, every skill is available as /kata:<skill-name>.

Action	Command
Update	/plugin update kata@0k-plugins
Uninstall	/plugin uninstall kata@0k-plugins
List skills	/plugin info kata@0k-plugins

Enabling across an org's projects

Add this to a project's .claude/settings.json to register the marketplace and auto-enable the plugin for everyone who opens the project:

{
  "extraKnownMarketplaces": {
    "0k-plugins": {
      "source": {
        "source": "github",
        "repo": "0k-software/0k-plugins"
      }
    }
  },
  "enabledPlugins": {
    "kata@0k-plugins": true
  }
}

This is the standard Claude Code mechanism for distributing plugins to a team — no custom scripts or hooks required. Claude Code handles installation and updates automatically. See the plugin marketplaces docs for details.

Skills

Every skill is a directory under skills/ with a SKILL.md defining its frontmatter (name, description, argument hint) and behavior. Each skill is invoked from a Claude Code session as /kata:<skill-name>.

Workflow

Skill	Invocation	Purpose
commit	/kata:commit	Stage all changes (staged, unstaged, untracked) and generate a Conventional Commit. Use ! prefix to auto-fix errors instead of aborting.
create-issue	/kata:create-issue	Create a GitHub issue in an 0k-software repo using the standardized templates (pitch, feature, task, bug, enhancement, kickoff).
create-pr	/kata:create-pr	Open a pull request for the current branch with consistent formatting and automatic issue linking. Pass draft to open as a draft.
rebase	/kata:rebase	Rebase current branch onto another, handling pre-commit hook failures. /kata:rebase! auto-resolves conflicts where safe.
cleanup-branch	/kata:cleanup-branch	Squash back-and-forth, WIP, and fixup commits into a clean, reviewable history — without changing the final diff.
split-branch	/kata:split-branch	Split a large branch into smaller stacked branches (≤500 changed lines each) so PRs are easier to review.
kitty	/kata:kitty	Open or activate a kitty terminal in the current directory.

Plan-driven implementation

These skills cooperate around a PLAN.md file at the repo root. The canonical schema lives in references/PLAN_FORMAT.md — every plan-* skill reads it before acting.

Skill	Invocation	Purpose
plan-init	/kata:plan-init	Fetch a GitHub issue, design step-by-step implementation, write PLAN.md, commit, and open a draft PR.
plan-add	/kata:plan-add	Add a new step to an existing PLAN.md while preserving the format.
plan-execute	/kata:plan-execute	Autonomously run all remaining plan steps — implement, commit, repeat — until the plan is complete.

Refinement & feedback