본문으로 건너뛰기
cccskills
무료GitHub에 공개

agent-sdk-development

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.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(2)

  • SKILL.md15.2 KB
  • source.json1.1 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

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_idTopic
platform-claude-com-docs-en-agent-sdk-overviewSDK overview and getting started
platform-claude-com-docs-en-agent-sdk-typescriptTypeScript SDK API reference
platform-claude-com-docs-en-agent-sdk-pythonPython SDK API reference
platform-claude-com-docs-en-agent-sdk-sessionsSession management and resumption
platform-claude-com-docs-en-agent-sdk-streaming-vs-single-modeInput mode selection
platform-claude-com-docs-en-agent-sdk-custom-toolsCreating custom tools
platform-claude-com-docs-en-agent-sdk-permissionsPermission configuration
platform-claude-com-docs-en-agent-sdk-modifying-system-promptsSystem prompt customization
platform-claude-com-docs-en-agent-sdk-cost-trackingCost and usage tracking
platform-claude-com-docs-en-agent-sdk-todo-trackingTodo list integration
platform-claude-com-docs-en-agent-sdk-structured-outputsStructured output features
platform-claude-com-docs-en-agent-sdk-hostingProduction hosting patterns
platform-claude-com-docs-en-agent-sdk-mcpMCP server integration
platform-claude-com-docs-en-agent-sdk-pluginsPlugin loading
platform-claude-com-docs-en-agent-sdk-subagentsSubagent usage
platform-claude-com-docs-en-agent-sdk-skillsSkills integration
platform-claude-com-docs-en-agent-sdk-slash-commandsSlash 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

TopicKeywords
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

TopicKeywords
API Key"Agent SDK authentication", "ANTHROPIC_API_KEY"
Bedrock"CLAUDE_CODE_USE_BEDROCK", "Bedrock SDK"
Vertex"CLAUDE_CODE_USE_VERTEX", "Vertex SDK"

Sessions

TopicKeywords
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

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

Custom Tools

TopicKeywords
Creating Tools"custom tools SDK", "creating custom tools"
Tool Schema"tool schema", "tool definition SDK"
Tool Handlers"tool handlers", "tool execution SDK"

Permissions

TopicKeywords
Tool Permissions"allowedTools", "disallowedTools", "tool permissions SDK"
Permission Mode"permissionMode SDK", "permission strategy"
Handling Permissions"handling permissions SDK", "permission callbacks"

System Prompts

TopicKeywords
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

TopicKeywords
Cost Tracking"cost tracking SDK", "token usage", "billing SDK"
Todo Tracking"todo tracking SDK", "todo lists SDK", "task management"

Structured Outputs

TopicKeywords
Structured Outputs"structured outputs SDK", "JSON results", "validated outputs"
Schema Definition"output schema SDK", "result validation"

Hosting and Deployment

TopicKeywords
Hosting Overview"hosting Agent SDK", "production deployment"
Ephemeral Sessions"ephemeral sessions", "pattern 1 hosting"
Persistent Sessions"persistent sessions", "pattern 2 hosting"

Plugins and MCP

TopicKeywords
Plugins"plugins SDK", "loading plugins", "programmatic plugins"
MCP Integration"MCP SDK", "MCP servers SDK", "extending with MCP"

Branding

TopicKeywords
Branding Guidelines"agent branding", "Claude Agent naming", "SDK branding"

SDK Feature Integration

TopicKeywords
Subagents"subagents SDK", "SDK subagents", "subagent integration"
Skills"skills SDK", "SDK skills", "agent skills SDK"
Slash Commands"slash commands SDK", "SDK commands", "custom commands SDK"

API Reference

TopicKeywords
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 sessions -> Query docs-management: "session management SDK", "resume option"
  4. Fork a session -> Query docs-management: "forking sessions", "forkSession"
  5. Choose input mode -> Query docs-management: "streaming vs single mode"
  6. Create custom tools -> Query docs-management: "custom tools SDK"
  7. Configure permissions -> Query docs-management: "allowedTools", "permissionMode SDK"
  8. Modify system prompts -> Query docs-management: "modifying system prompts"
  9. Use CLAUDE.md files -> Query docs-management: "CLAUDE.md SDK", "settingSources"
  10. Track costs -> Query docs-management: "cost tracking SDK"
  11. Add todo tracking -> Query docs-management: "todo tracking SDK"
  12. Get structured outputs -> Query docs-management: "structured outputs SDK"
  13. Host in production -> Query docs-management: "hosting Agent SDK"
  14. Use subagents -> Query docs-management: "subagents SDK"
  15. Integrate skills -> Query docs-management: "skills SDK", "agent skills SDK"
  16. Add slash commands -> Query docs-management: "slash commands SDK"
  17. Load plugins -> Query docs-management: "plugins SDK"

Topic Coverage

SDK Installation and Setup

  • npm package: @anthropic-ai/claude-agent-sdk
  • pip package: claude-agent-sdk
  • TypeScript and Python SDK options
  • Migration from Claude Code SDK

Authentication Methods

  • ANTHROPIC_API_KEY environment variable
  • Amazon Bedrock integration (CLAUDE_CODE_USE_BEDROCK)
  • Google Vertex AI integration (CLAUDE_CODE_USE_VERTEX)
  • Third-party provider configuration

Session Management Features

  • Automatic session creation
  • Session ID capture from init message
  • Session resumption with resume option
  • Forking sessions (forkSession/fork_session)
  • Session branching for experimentation
  • Context preservation across sessions

Input Mode Configuration

  • Streaming input mode (recommended)
  • Single input mode
  • Mode selection criteria
  • Performance considerations

Custom Tool Development

  • Tool schema definition
  • Tool handler implementation
  • Tool registration with SDK
  • Tool execution patterns

Permission Configuration

  • allowedTools list
  • disallowedTools list
  • permissionMode settings
  • Permission callbacks and handling

System Prompt Customization

  • CLAUDE.md file loading (settingSources)
  • appendSystemPrompt option
  • outputStyle for agent persona
  • Project-level vs user-level instructions

Cost and Usage Tracking

  • Token usage monitoring
  • Billing integration patterns
  • Usage reporting
  • Cost estimation

Todo List Integration

  • Todo tracking API
  • Task display and management
  • Progress monitoring
  • Todo state persistence

Structured Output Features

  • Output schema definition
  • JSON result validation
  • Type-safe results
  • TODO tracking agent example

Hosting Patterns

  • Ephemeral sessions pattern
  • Persistent sessions pattern
  • Production deployment strategies
  • Scaling considerations

Full Claude Code Features

  • Subagents (./.claude/agents/)
  • Agent Skills (./.claude/skills/)
  • Hooks (./.claude/settings.json)
  • Slash Commands (./.claude/commands/)
  • Plugins (programmatic loading)
  • Memory (CLAUDE.md files)

Branding Requirements

  • Allowed naming (Claude Agent, Claude)
  • Not permitted naming (Claude Code)
  • Product branding guidelines

Delegation Patterns

Standard Query Pattern

User asks: "How do I create a custom tool in the Agent SDK?"

1. Invoke docs-management skill
2. Use keywords: "custom tools SDK", "creating custom tools"
3. Load official documentation
4. Provide guidance based EXCLUSIVELY on official docs

Multi-Topic Query Pattern

User asks: "I want to build an agent with sessions, custom tools, and cost tracking"

1. Invoke docs-management skill with multiple queries:
   - "session management SDK", "session resumption"
   - "custom tools SDK", "creating custom tools"
   - "cost tracking SDK", "token usage"
2. Synthesize guidance from official documentation

Troubleshooting Pattern

User reports: "My session resumption isn't working"

1. Invoke docs-management skill
2. Use keywords: "session management SDK", "resume option", "session ID"
3. Check official docs for session patterns
4. Guide user through proper session handling

Troubleshooting Quick Reference

IssueKeywords for docs-management
Authentication failing"Agent SDK authentication", "ANTHROPIC_API_KEY"
Session not resuming"session resumption", "resume option"
Custom tool not working"custom tools SDK", "tool handlers"
Permissions blocking"allowedTools", "permissionMode SDK"
System prompt not loading"CLAUDE.md SDK", "settingSources"
Cost tracking issues"cost tracking SDK", "token usage"
Structured output invalid"structured outputs SDK", "schema definition"
Streaming not working"streaming input mode", "streaming vs single"

Related Skills

Skills that work well with agent-sdk-development:

  • docs-management - Primary delegation target; provides all official Agent SDK documentation
  • mcp-integration - MCP server configuration; Agent SDK can integrate with MCP servers
  • settings-management - Settings configuration; SDK respects Claude Code settings
  • hook-management - Hook configuration; SDK supports hooks via programmatic loading
  • current-date - Get current UTC date for version history and audit timestamps

Delegation example:

When working with Agent SDK + MCP integration:
1. Use agent-sdk-development for SDK-specific guidance
2. Use mcp-integration for MCP server configuration
3. Both skills delegate to docs-management for official documentation

Additional Resources

For test scenarios, multi-model testing notes, repository-specific guidance, and external references, see:

Version History

  • v1.1.0 (2025-11-27): Comprehensive audit and enhancement

    • Added Reference Loading Guide with explicit doc_id table for all 17 official Agent SDK docs
    • Added Test Scenarios section with 5 common use case scenarios
    • Added Related Skills section documenting skill composition patterns
    • Added Multi-Model Testing Notes section
    • Enhanced Last Verified section with Type B audit metadata
    • Verified keyword registry covers all official SDK documentation
  • v1.0.0 (2025-11-26): Initial release

    • Pure delegation architecture
    • Comprehensive keyword registry
    • Quick decision tree
    • Topic coverage for all Agent SDK features
    • Troubleshooting quick reference

Last Updated

Date: 2025-11-28 Model: claude-opus-4-5-20251101

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

007

무료

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

aibot88/sec_skill_store52026년 5월 27일 업데이트

Guides the creation of agile user stories and Gherkin feature files. Use when the user wants to create a user story, write acceptance criteria, define Gherkin scenarios, or author BDD feature files. This should trigger for requests such as Create a user story; Write a user story; I need to write a user story. Part of cursor-rules-java project

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

aibot88/sec_skill_store52026년 5월 27일 업데이트

Facilitates conversational discovery to create Architectural Decision Records (ADRs) for non-functional requirements using the ISO/IEC 25010:2023 quality model. Use when the user wants to document quality attributes, NFR decisions, security/performance/scalability architecture, or design systems with measurable quality criteria. This should trigger for requests such as Create ADR for Non-functional requirements; Document Non-functional requirements; Capture Non-functional requirements; Generate Non-functional requirements in an ADR. Part of cursor-rules-java project

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

aibot88/sec_skill_store52026년 5월 27일 업데이트

Run a health check on an existing project: dependency audit, security scan, test runner detection, CI/CD evaluation, and missing configuration analysis. Maps the three execution gates (pre/in/post) from /10x-bootstrapper to an assessment framework for existing codebases. Reads optional context/foundation/stack-assessment.md from /10x-stack-assess to focus checks on identified gaps. Writes context/foundation/health-check.md with findings, prioritized fixes, and an agent-readiness verdict. Use when the user has an existing project and wants to verify its health before working with an agent. Trigger phrases: "health check", "check my project", "audit my project", "is my project healthy", "sprawdź projekt", "audyt projektu", "health-check", "project health". Use AFTER /10x-stack-assess (brownfield chain), BEFORE agent onboarding (m1-l4).

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

aibot88/sec_skill_store52026년 5월 27일 업데이트

10x-team

무료

You MUST use this when building projects end-to-end. Orchestrates all 12 team roles — automatically switches between CTO, architect, PM, engineers, SRE, security, DBA, QA, and EM based on the current phase of work. Starts with brainstorming before any implementation.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

aibot88/sec_skill_store52026년 5월 27일 업데이트

Use when you need to add or configure Maven plugins in your pom.xml — including quality tools (enforcer, surefire, failsafe, jacoco, pitest, spotbugs, pmd), security scanning (OWASP), code formatting (Spotless), version management, container image build (Jib), build information tracking, and benchmarking (JMH) — through a consultative, modular step-by-step approach that only adds what you actually need. This should trigger for requests such as Add Maven plugins in pom.xml; Improve Maven plugins in pom.xml. Part of cursor-rules-java project

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

aibot88/sec_skill_store52026년 5월 27일 업데이트

aibot88의 스킬 모두 보기

이 스킬의 문제 신고