Claude
Skills
Sign in
โ† Back

agent-sdk-development

Included with Lifetime
$97 forever

Central authority for Claude Agent SDK (TypeScript and Python SDKs). Covers SDK installation, authentication (Anthropic key, Bedrock, Vertex), sessions and resumption, forking sessions, streaming vs single mode, custom tools, permissions (allowedTools, disallowedTools, permissionMode), MCP integration, system prompts (CLAUDE.md, appendSystemPrompt, outputStyle), cost tracking, todo tracking, structured outputs, hosting patterns, plugins, and SDK branding guidelines. Assists with building custom agents, configuring SDK options, and troubleshooting SDK issues. Delegates 100% to docs-management skill for official documentation.

Backend & APIs

What this skill does


# Agent SDK Meta Skill

## ๐Ÿšจ MANDATORY: Invoke docs-management First

> **STOP - Before providing ANY response about Claude Agent SDK:**
>
> 1. **INVOKE** `docs-management` skill
> 2. **QUERY** using keywords: Agent SDK, TypeScript SDK, Python SDK, sessions, custom tools, permissions, or related topics
> 3. **BASE** all responses EXCLUSIVELY on official documentation loaded
>
> **Skipping this step results in outdated or incorrect information.**

### Verification Checkpoint

Before responding, verify:

- [ ] Did I invoke docs-management skill?
- [ ] Did official documentation load?
- [ ] Is my response based EXCLUSIVELY on official docs?

If ANY checkbox is unchecked, STOP and invoke docs-management first.

## Overview

Central authority for Claude Agent SDK (TypeScript and Python SDKs). This skill uses **100% delegation to docs-management** - it contains NO duplicated official documentation.

**Architecture:** Pure delegation with keyword registry. All official documentation is accessed via docs-management skill queries.

## Reference Loading Guide

This skill follows a **pure delegation architecture** with three loading layers:

### Layer 1: Always in Context

- **SKILL.md** (this file) - Keyword registry, decision trees, delegation patterns

### Layer 2: On-Demand via docs-management

All official Agent SDK documentation is accessed through docs-management queries:

| doc_id | Topic |
| --- | --- |
| platform-claude-com-docs-en-agent-sdk-overview | SDK overview and getting started |
| platform-claude-com-docs-en-agent-sdk-typescript | TypeScript SDK API reference |
| platform-claude-com-docs-en-agent-sdk-python | Python SDK API reference |
| platform-claude-com-docs-en-agent-sdk-sessions | Session management and resumption |
| platform-claude-com-docs-en-agent-sdk-streaming-vs-single-mode | Input mode selection |
| platform-claude-com-docs-en-agent-sdk-custom-tools | Creating custom tools |
| platform-claude-com-docs-en-agent-sdk-permissions | Permission configuration |
| platform-claude-com-docs-en-agent-sdk-modifying-system-prompts | System prompt customization |
| platform-claude-com-docs-en-agent-sdk-cost-tracking | Cost and usage tracking |
| platform-claude-com-docs-en-agent-sdk-todo-tracking | Todo list integration |
| platform-claude-com-docs-en-agent-sdk-structured-outputs | Structured output features |
| platform-claude-com-docs-en-agent-sdk-hosting | Production hosting patterns |
| platform-claude-com-docs-en-agent-sdk-mcp | MCP server integration |
| platform-claude-com-docs-en-agent-sdk-plugins | Plugin loading |
| platform-claude-com-docs-en-agent-sdk-subagents | Subagent usage |
| platform-claude-com-docs-en-agent-sdk-skills | Skills integration |
| platform-claude-com-docs-en-agent-sdk-slash-commands | Slash command usage |

### Layer 3: External Resources (GitHub)

- TypeScript SDK: anthropics/claude-agent-sdk-typescript
- Python SDK: anthropics/claude-agent-sdk-python

### Loading Strategy

**This skill has no local reference files.** All documentation is accessed via docs-management queries using the keyword registry below. This ensures:

- Zero duplication of official documentation
- Always-current information from canonical sources
- Zero maintenance overhead for documentation sync

## When to Use This Skill

**Keywords:** Agent SDK, Claude Agent SDK, TypeScript SDK, Python SDK, npm install claude-agent-sdk, pip install claude-agent-sdk, sessions, session resumption, forking sessions, streaming mode, single mode, custom tools, allowedTools, disallowedTools, permissionMode, system prompts, appendSystemPrompt, outputStyle, CLAUDE.md, settingSources, cost tracking, todo tracking, structured outputs, hosting, plugins SDK, MCP SDK, agent branding

**Use this skill when:**

- Installing or configuring Claude Agent SDK
- Setting up authentication (API key, Bedrock, Vertex)
- Managing sessions and resumption
- Choosing between streaming and single input modes
- Creating custom tools
- Configuring permissions (allowedTools, disallowedTools)
- Modifying system prompts
- Tracking costs and usage
- Working with todo lists in agents
- Getting structured outputs
- Hosting agents in production
- Integrating MCP with SDK
- Understanding SDK branding requirements

## Keyword Registry for docs-management Queries

Use these keywords when querying docs-management skill for official documentation:

### SDK Fundamentals

| Topic | Keywords |
| --- | --- |
| Overview | "Agent SDK", "Claude Agent SDK overview", "why use Agent SDK" |
| Installation | "Agent SDK installation", "npm install claude-agent-sdk", "pip install claude-agent-sdk" |
| SDK Options | "SDK options", "TypeScript SDK", "Python SDK" |
| Migration | "Claude Code SDK migration", "migration guide" |

### Authentication

| Topic | Keywords |
| --- | --- |
| API Key | "Agent SDK authentication", "ANTHROPIC_API_KEY" |
| Bedrock | "CLAUDE_CODE_USE_BEDROCK", "Bedrock SDK" |
| Vertex | "CLAUDE_CODE_USE_VERTEX", "Vertex SDK" |

### Sessions

| Topic | Keywords |
| --- | --- |
| Session Management | "session management SDK", "session ID", "getting session ID" |
| Resumption | "session resumption", "resume option", "continuing sessions" |
| Forking | "forking sessions", "forkSession", "session branching" |

### Input Modes

| Topic | Keywords |
| --- | --- |
| Overview | "streaming vs single mode", "input modes SDK" |
| Streaming Mode | "streaming input mode", "recommended mode" |
| Single Mode | "single input mode", "non-streaming" |

### Custom Tools

| Topic | Keywords |
| --- | --- |
| Creating Tools | "custom tools SDK", "creating custom tools" |
| Tool Schema | "tool schema", "tool definition SDK" |
| Tool Handlers | "tool handlers", "tool execution SDK" |

### Permissions

| Topic | Keywords |
| --- | --- |
| Tool Permissions | "allowedTools", "disallowedTools", "tool permissions SDK" |
| Permission Mode | "permissionMode SDK", "permission strategy" |
| Handling Permissions | "handling permissions SDK", "permission callbacks" |

### System Prompts

| Topic | Keywords |
| --- | --- |
| Overview | "modifying system prompts", "system prompts SDK" |
| CLAUDE.md | "CLAUDE.md SDK", "settingSources", "project instructions" |
| Append System Prompt | "appendSystemPrompt", "custom instructions" |
| Output Style | "outputStyle SDK", "agent persona" |

### Cost and Tracking

| Topic | Keywords |
| --- | --- |
| Cost Tracking | "cost tracking SDK", "token usage", "billing SDK" |
| Todo Tracking | "todo tracking SDK", "todo lists SDK", "task management" |

### Structured Outputs

| Topic | Keywords |
| --- | --- |
| Structured Outputs | "structured outputs SDK", "JSON results", "validated outputs" |
| Schema Definition | "output schema SDK", "result validation" |

### Hosting and Deployment

| Topic | Keywords |
| --- | --- |
| Hosting Overview | "hosting Agent SDK", "production deployment" |
| Ephemeral Sessions | "ephemeral sessions", "pattern 1 hosting" |
| Persistent Sessions | "persistent sessions", "pattern 2 hosting" |

### Plugins and MCP

| Topic | Keywords |
| --- | --- |
| Plugins | "plugins SDK", "loading plugins", "programmatic plugins" |
| MCP Integration | "MCP SDK", "MCP servers SDK", "extending with MCP" |

### Branding

| Topic | Keywords |
| --- | --- |
| Branding Guidelines | "agent branding", "Claude Agent naming", "SDK branding" |

### SDK Feature Integration

| Topic | Keywords |
| --- | --- |
| Subagents | "subagents SDK", "SDK subagents", "subagent integration" |
| Skills | "skills SDK", "SDK skills", "agent skills SDK" |

### API Reference

| Topic | Keywords |
| --- | --- |
| TypeScript Reference | "TypeScript SDK reference", "TypeScript API" |
| Python Reference | "Python SDK reference", "Python API" |
| Changelog | "SDK changelog", "SDK updates" |

## Quick Decision Tree

**What do you want to do?**

1. **Install the SDK** -> Query docs-management: "Agent SDK installation"
2. **Set up authentication** -> Query docs-management: "Agent SDK authentication"
3. **Manage ses

Related in Backend & APIs