cli-worker_skill

Overview

This skill delegates coding tasks to Kimi CLI agents by running them in isolated git worktrees. It is designed for headless, parallel, or isolated work that should not interfere with the main repository. Requires the Kimi CLI to be installed and authenticated on the host where the skill runs.

How this skill works

The skill invokes the Kimi CLI to create an isolated git worktree and runs a single non-interactive task using the provided prompt and optional constraints. It returns the agent output, stores the worktree under a taskId, and provides commands to inspect status, list or remove worktrees, and perform cleanup. Verification only checks CLI availability; authentication must be completed interactively by the user.

When to use it

• Delegate a single coding task to a CLI agent without manual interaction
• Run isolated work in a separate git worktree to avoid conflicts with main repo
• Execute parallel tasks and continue other work while agents run
• Run headless non-interactive tasks from automation or CI
• Avoid sessions_spawn when you need a guaranteed task execution

Best practices

• Install and authenticate the Kimi CLI on the host before invoking the skill (user completes OAuth via /login).
• Use cli-worker execute "<prompt>" for single tasks; include --constraint and --success for more predictable results.
• Prefer CLI delegation over sessions_spawn for one-off executions; sessions_spawn can create idle sessions. If you spawn, verify child session activity within ~30s.
• Use worktree list/status to inspect reports and decide whether to merge, keep, or remove a worktree.
• Cleanup old worktrees regularly with cli-worker cleanup --older-than to avoid disk clutter.

Example use cases

• Create a new feature file in isolation: cli-worker execute "Create hello.py" --constraint "Python 3.11"
• Run tests and return artifacts headlessly: cli-worker execute "Run unit tests and report failures" --output-format text
• Parallelize refactors across multiple branches by issuing multiple execute commands concurrently
• Recover or inspect archived outputs from past tasks using cli-worker worktree list and status