# Send CLI Worker Skill (Kimi CLI) to your agent
Use the source page and any available docs to guide the install because the item currently does not return a direct package file.
## Fast path
- Open the source page via Open source listing.
- If you can obtain the package, extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the source page and extracted files.
## Suggested prompts
### New install

```text
I tried to install a skill package from Yavira, but the item currently does not return a direct package file. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required. Then review README.md for any prerequisites, environment setup, or post-install checks.
```
### Upgrade existing

```text
I tried to upgrade a skill package from Yavira, but the item currently does not return a direct package file. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need. Then review README.md for any prerequisites, environment setup, or post-install checks.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "cli-worker",
    "name": "CLI Worker Skill (Kimi CLI)",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/quratus/cli-worker",
    "canonicalUrl": "https://clawhub.ai/quratus/cli-worker",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/cli-worker",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=cli-worker",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "AGENTS.md",
      "CHANGELOG.md",
      "README.md",
      "SECURITY.md",
      "SKILL.md",
      "bin/auth/verify.js"
    ],
    "downloadMode": "manual_only",
    "sourceHealth": {
      "source": "tencent",
      "slug": "cli-worker",
      "status": "source_issue",
      "reason": "not_found",
      "recommendedAction": "review_source",
      "checkedAt": "2026-05-01T05:32:07.037Z",
      "expiresAt": "2026-05-02T05:32:07.037Z",
      "httpStatus": 404,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=cli-worker",
      "contentType": "text/plain",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=cli-worker",
        "contentDisposition": null,
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "cli-worker"
      },
      "scope": "item",
      "summary": "Known item issue.",
      "detail": "This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.",
      "primaryActionLabel": "Open source listing",
      "primaryActionHref": "https://clawhub.ai/quratus/cli-worker"
    },
    "validation": {
      "installChecklist": [
        "Open the source listing and confirm there is a real package or setup artifact available.",
        "Review SKILL.md before asking your agent to continue.",
        "Treat this source as manual setup until the upstream download flow is fixed."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/cli-worker",
    "downloadUrl": "https://openagent3.xyz/downloads/cli-worker",
    "agentUrl": "https://openagent3.xyz/skills/cli-worker/agent",
    "manifestUrl": "https://openagent3.xyz/skills/cli-worker/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/cli-worker/agent.md"
  }
}
```
## Documentation

### When to use

User asks to delegate a coding task to Kimi or a CLI worker
Isolated coding task that should run in its own worktree (no git conflicts)
Parallel work: run multiple tasks without blocking the main agent
Headless task: run Kimi CLI non-interactively from OpenClaw

### Delegation: prefer CLI over sessions_spawn

For a single coding task, use the CLI so the task actually runs:

Do: cli-worker execute "Your task prompt" (and optionally --constraint / --success). This runs Kimi CLI in a worktree and returns output.
Avoid: Using sessions_spawn to delegate to a "sub-agent" for the same kind of task. Spawn is known to sometimes create a session that never processes (0 messages). Use sessions_spawn only when you need an ongoing sub-agent conversation with multiple back-and-forth or sessions_send.

After any spawn, verify within ~30s: sessions_list with kinds: ["subagent"] and/or sessions_history on the child session; if messages stay 0, treat as failed and retry with cli-worker execute instead.

### Prerequisites

You must install and authenticate the CLI yourself before using this skill. This skill does not store or use any credentials.

Kimi CLI installed (uv tool install kimi-cli or install script from code.kimi.com)
Authenticated: run kimi then /login in the REPL (user must complete OAuth; cannot be automated)

Verify with: cli-worker verify

### How to invoke

# Run a single task (creates worktree if in a git repo)
cli-worker execute "Your task prompt"

# With context
cli-worker execute "Create hello.py" --constraint "Python 3.11" --success "Tests pass"

# To get full plain-text output for the agent (not only the final answer)
cli-worker execute "Your task" --output-format text

# Check task status (after Kimi writes report)
cli-worker status <taskId>

# List / remove worktrees
cli-worker worktree list
cli-worker worktree remove <taskId>

# Cleanup old worktrees
cli-worker cleanup --older-than 24

### Merge and cleanup

After a task completes, decide whether to keep or discard the work:

To keep the work: From the main repo (e.g., on main), run:
git merge openclaw/<taskId>
cli-worker worktree remove <taskId>


To discard: Run cli-worker worktree remove <taskId> directly, or rely on cli-worker cleanup --older-than N.

### Install

CLI (required for execute/verify): Must be on PATH where the agent runs. From the repo: npm install && npm run build && npm link. (From npm: npm install -g @sqncr/openclaw-cli-agent-skill.) If the agent gets "command not found", run npm link from the repo and restart the gateway.
Skill discovery: From the repo run npm run install-skill to symlink into ~/.openclaw/skills/cli-worker. Restart gateway or new session after that.

### OpenClaw integration

Symlink or copy skills/cli-worker/ to ~/.openclaw/skills/cli-worker/ so agents can discover it
Optional config: ~/.openclaw/openclaw.json with worktree.basePath for worktree location
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: quratus
- Version: 0.3.0
## Source health
- Status: source_issue
- Known item issue.
- This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.
- Health scope: item
- Reason: not_found
- Checked at: 2026-05-01T05:32:07.037Z
- Expires at: 2026-05-02T05:32:07.037Z
- Recommended action: Open source listing
## Links
- [Detail page](https://openagent3.xyz/skills/cli-worker)
- [Send to Agent page](https://openagent3.xyz/skills/cli-worker/agent)
- [JSON manifest](https://openagent3.xyz/skills/cli-worker/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/cli-worker/agent.md)
- [Download page](https://openagent3.xyz/downloads/cli-worker)