Skip to content

/kimi-swarm-write

Run a write-capable Kimi swarm that edits many disjoint targets in a throwaway worktree and returns a reviewable patch. Use only for explicit parallel edit fan-out requests; the plugin never applies or commits the patch.

From plugin
2912 skills7 agents12 commands1 hooks
shell
$ npx -y skills add linxule/kimi-plugin-cc --skill kimi-swarm-write --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/kimi-swarm-write
How auto-invocation works

Context preview

The summary Claude sees to decide when to auto-load this skill.

Run a write-capable Kimi swarm that edits many disjoint targets in a throwaway worktree and returns a reviewable patch. Use only for explicit parallel edit fan-out requests; the plugin never applies or commits the patch.

SKILL.md

kimi-swarm-write.SKILL.md
name: kimi-swarm-write
description: "Run a write-capable Kimi swarm that edits many disjoint targets in a throwaway worktree and returns a reviewable patch. Use only for explicit parallel edit fan-out requests; the plugin never applies or commits the patch."

Kimi Swarm Write

Forward this request to the local kimi-code companion runtime by shell. Do not use MCP for this skill.

Invocation

  • Resolve the plugin root: prefer `$PLUGIN_ROOT` if the host sets it; otherwise use the directory that CONTAINS the `skills/` directory (i.e. two levels up from this `SKILL.md`).
  • Sanity check: `<plugin-root>/scripts/companion.sh` must exist — it is the bundled entrypoint that resolves Node and runs the compiled runtime from `<plugin-root>/dist/`.
  • Launch the shell command from the user's current workspace directory so `scripts/companion.sh` captures the intended workspace cwd.
  • Run: `PLUGIN_ROOT="<plugin-root>" "<plugin-root>/scripts/companion.sh" task swarm --write <args>`
  • If the plugin host provides `PLUGIN_DATA` instead of `CLAUDE_PLUGIN_DATA`, the shell wrapper exports the Claude-compatible alias for the runtime. If neither is set, the wrapper uses a Codex data directory under `$CODEX_HOME/plugins/data/kimi-marketplace-kimi`, `~/.codex/plugins/data/kimi-marketplace-kimi`, or `/tmp/kimi-plugin-cc-codex-data/kimi-marketplace-kimi` in a fully sanitized environment.

Arguments

Pass through: `[--budget <30m|1h>] [--cap <N>] [--max-concurrency <N>] [-m <model>] <objective>`

Handling

  • Require both many disjoint write targets and explicit parallel fan-out intent.
  • Keep `--max-concurrency` conservative, normally 1, unless the user explicitly asks to widen it.
  • The runtime rejects `--background`, but detaching your own shell call is expected: a fan-out routinely outlives a foreground timeout, and the run is patch-only and worktree-confined. Keep `--budget` and `--max-concurrency` finite. To stop a run, use `companion.sh cancel` with NO id — it targets the latest running job for the repo, and no UUID crosses you or the user (a detached run prints nothing at launch; the id first arrives with the final report). Prefer that over an interrupt: an interrupt gives the companion only ~1.35s before SIGKILL, less than its teardown plus `git diff --binary` patch capture, so interrupting can lose the patch.
  • If the companion reports SWARM_HOOK_NOT_INSTALLED, tell the user to run Claude Code /kimi:setup or Codex $kimi-setup, then retry.
  • Return the patch path and companion output verbatim; do not apply the patch unless the user separately asks.
Read more
Read it on GitHub ↗
Ships withkimi

Use Kimi as Claude Code's second reviewer, independent thinker, and delegated worker — without building your own multi-agent stack. This is a Claude Code plugin that drives the kimi-code CLI (the Node.js successor to Kimi CLI) as a subprocess.

Get the whole plugin, auto-invoked
Stats
29
Stars
0
Views
1
Forks
Active
Maintenance
TypeScript
Language
Apache-2.0
License
2d ago
Last commit
3mo ago
Created

Repo: linxule/kimi-plugin-cc