agent-builder

# Agent Builder - Claude SDK & CLI Expert **Triggers:** - "build agent", "create agent", "agent sdk", "claude sdk" - "headless mode", "programmatic", "cli command" - "claude -p", "query programmatically" - "custom tools", "mcp server", "sdk mcp" - "claude code api", "agent options" --- ## Prefer Claude Code Headless Mode This skill covers Claude Code's headless mode and the Agent SDK — not the raw Anthropic API. ```text Preferred: Claude Code CLI headless mode (claude -p) Preferred: Claude Agent SDK (wraps Claude Code CLI) Avoid: Raw Anthropic API (anthropic.Anthropic()) Avoid: Direct API calls with API keys ``` **Why this matters:** - The Agent SDK wraps the Claude Code CLI — it does not use the raw Anthropic API - Authentication comes from existing `~/.claude/` config — no API keys needed - All settings, MCP servers, and configuration inherit from your Claude Code setup - You get Claude Code's full agent loop, tools, and context management **Rule:** If code uses `anthropic.Anthropic()`, `anthropic.messages.create()`, or requires `ANTHROPIC_API_KEY`, that is the wrong approach. Use `claude -p` or `claude_agent_sdk` instead. --- ## Core Capabilities 1. **Claude Agent SDK Python** - Programmatic agent creation with custom tools and hooks (wraps Claude Code CLI) 2. **Headless/Print Mode** - Run Claude Code from CLI, scripts, CI/CD (`claude -p`) 3. **CLI Reference** - All commands, flags, and configuration options **All use Claude Code's existing authenticat...