subagent — one-shot / batch provider subagent
Runs headless provider LLMs (DeepSeek, GLM, Kimi, Qwen, MiniMax) via the cc-fleet CLI for one-shot answers or lock-free parallel fan-out.
What it does
Teaches Claude to call cc-fleet subagent, which runs a provider model headless and returns a JSON envelope straight on stdout — the analog of the native Task tool, but pointed at a cheaper or specialized provider.
- A strict provider "ask ladder": user's choice → configured default → ask once → never switch silently after a balance/auth failure
- Practical flag guidance:
--label,--prompt-file,--timeout,--max-budget-usd,--max-turns,--profile - Success/failure envelope schemas plus a 20+ row
error_codedispatch table - Long-running work via a backgrounded Bash or
--background+subagent-status --waitas a push notification - Clear lane separation:
/cc-fleet:teamfor multi-turn collaborators,/cc-fleet:workflowfor dependent pipelines
Who it's for
- Developers already running cc-fleet with multiple LLM providers configured
- Anyone fanning out N independent tasks (per-file summaries, bulk analysis) in true parallel
- Teams that want hard cost/turn caps and cheap models for leaf work
Examples
- Summarize 30 files under
docs/with 30 parallel GLM subagent calls, then aggregate the results cc-fleet subagent deepseek --model strongto derive a worst-case complexity analysis plus a triggering input- Fire a 30-minute refactor survey with
--backgroundand get woken bysubagent-status --wait
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/ethanhq/cc-fleet/HEAD/skills/subagent/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/subagent folder from the GitHub repo ethanhq/cc-fleet into my ~/.claude/skills/ethanhq-subagent/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/ethanhq/cc-fleet.git /tmp/cc-fleet && mkdir -p ~/.claude/skills && cp -r /tmp/cc-fleet/skills/* ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Install cc-fleet itself first — follow the setup instructions at https://github.com/ethanhq/cc-fleet until the
cc-fleetcommand works in your terminal. - Clone the repo:
git clone https://github.com/ethanhq/cc-fleet.git /tmp/cc-fleet - Copy the skills in:
mkdir -p ~/.claude/skills && cp -r /tmp/cc-fleet/skills/* ~/.claude/skills/(copy the whole skills folder — this skill reads shared docs fromcc-fleet-shared/). - Register a provider:
cc-fleet addto store an API key, thencc-fleet default <provider>to pin a default. - Run
cc-fleet doctorto verify installation, PATH, and auth. - Restart Claude Code and try: "use subagents to summarize every file in docs in parallel".