DeepSeek Reasoning Skill
Reach DeepSeek's reasoning model from Claude Code via the consultant-deepseek
MCP server. This is one of five uniform "consultant" bridges (codex, deepseek,
perplexity, antigravity, zai) under /opt/agentbox/mcp/consultants/, registered
in skills/mcp.json. It is launched on demand by the MCP client — there is no
supervisord program, no config file, and no bespoke bridge code in this skill.
DeepSeek acts as the reasoning planner; Claude executes.
What it provides
- Explicit reasoning traces — DeepSeek V4 Flash returns its chain-of-thought
in
message.reasoning_content, which the consultant folds into the response under a<reasoning>...</reasoning>preamble ahead of the answer. - Root-cause analysis — deep code/system debugging with a visible reasoning trail.
- Task planning — dependency-aware phase/task breakdowns.
- Hybrid workflow — Claude as executor, DeepSeek as reasoning planner.
When not to use
- Straightforward code generation or editing — Claude handles this directly.
- Web research or live information — use perplexity-research.
- Code review on GitHub PRs — use github-code-review.
- OpenAI model delegation — use openai-codex or codex-companion.
- Latency-sensitive tasks — DeepSeek adds 2-5s per call; use Claude directly.
Tools (MCP)
Three tools, the shape shared by every consultant server:
consult— submit a question (and optional curated context) and get an answer with model, token usage, cost, and citations.health— liveness + auth probe. No paid call.cost_estimate— estimate USD cost from question/response token counts.
Full parameter and return schemas: references/tools.md.
Configuration
- Model:
AGENTBOX_DEEPSEEK_MODELenv var, defaultdeepseek-v4-flash(agentbox.toml[consultants.deepseek] model). - Auth:
DEEPSEEK_API_KEYfrom session env (optionalDEEPSEEK_BASE_URLoverride for a non-default endpoint). No credential file. - Gate:
env:AGENTBOX_CONSULTANTS_ENABLED.
References
references/tools.md— tool signatures, return schemas, DeepSeek-vs-Claude comparison.references/workflows.md— invocation examples, hybrid workflow, advanced usage, best practices.references/operations.md— real wiring, health checks, troubleshooting.