Pp Claude Agent SDK Python Docs

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/developer-tools/claude-agent-sdk-python-docs/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Claude Agent SDK Python Docs — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the claude-agent-sdk-python-docs-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install claude-agent-sdk-python-docs --cli-only

2. Verify: claude-agent-sdk-python-docs-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

go install github.com/mvanhorn/printing-press-library/library/developer-tools/claude-agent-sdk-python-docs/cmd/claude-agent-sdk-python-docs-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

Fetch the raw Claude Code docs index, search the Python Agent SDK reference, and extract exact symbols, examples, and citations. Novel verification and context commands help agents use the SDK without guessing.

When to Use This CLI

Use this CLI when you need exact Claude Agent SDK Python documentation, examples, signatures, or citations in an agent-friendly shape. It is strongest for implementation planning, code review, and preventing SDK hallucinations.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI to run Claude Agent SDK applications.
• Do not use this CLI for TypeScript SDK questions unless the docs mirror has been expanded to TypeScript pages.
• Do not use this CLI as a replacement for live Claude Code authentication or account setup.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Docs-grounded verification

• verify — Check Python code imports and qualified names against documented Claude Agent SDK symbols.

  Use this before trusting generated SDK code or reviewing a PR that imports claude_agent_sdk.

  claude-agent-sdk-python-docs-pp-cli verify ./src --agent

• diff — Compare current docs entity hashes against an optional baseline file.

  Use this to detect whether SDK docs facts have changed against a saved baseline.

  claude-agent-sdk-python-docs-pp-cli diff --since latest --agent

• audit-links — Validate internal anchors, guide links, and section references in the fetched docs corpus.

  Use this before relying on context bundles or citations in generated code reviews.

  claude-agent-sdk-python-docs-pp-cli audit-links --agent

Agent-native context

• context — Build a compact source-cited docs bundle for one SDK implementation task.

  Use this when an agent needs exact docs context without loading full Markdown pages.

  claude-agent-sdk-python-docs-pp-cli context "custom tools" --agent --select sections.title,examples.code,citations.url

• recipe — Compose a deterministic implementation scaffold from documented snippets and exact signatures.

  Use this when you need a copyable starting point constrained to documented SDK patterns.

  claude-agent-sdk-python-docs-pp-cli recipe "streaming ClaudeSDKClient" --agent

SDK surface intelligence

• map — Map functions, classes, types, options, tools, hooks, and message blocks by entity type.

  Use this to discover the available SDK surface before choosing an implementation path.

  claude-agent-sdk-python-docs-pp-cli map --kind classes,types,options --agent

• coverage examples — Report which documented symbols have extracted examples and which do not.

  Use this to find example-backed SDK APIs and documentation coverage gaps.

  claude-agent-sdk-python-docs-pp-cli coverage examples --agent

Command Reference

pages — Fetch Claude Agent SDK documentation pages

• claude-agent-sdk-python-docs-pp-cli pages custom-tools — Fetch the Agent SDK custom tools guide
• claude-agent-sdk-python-docs-pp-cli pages index — Fetch the Claude Code documentation index
• claude-agent-sdk-python-docs-pp-cli pages mcp — Fetch the Agent SDK MCP guide
• claude-agent-sdk-python-docs-pp-cli pages overview — Fetch the Agent SDK overview
• claude-agent-sdk-python-docs-pp-cli pages permissions — Fetch the Agent SDK permissions guide
• claude-agent-sdk-python-docs-pp-cli pages python — Fetch the Python Agent SDK reference
• claude-agent-sdk-python-docs-pp-cli pages quickstart — Fetch the Agent SDK quickstart
• claude-agent-sdk-python-docs-pp-cli pages sessions — Fetch the Agent SDK sessions guide
• claude-agent-sdk-python-docs-pp-cli pages structured-outputs — Fetch the Agent SDK structured output guide

Freshness Contract

The generated pages endpoints and hand-authored docs intelligence commands read the public Claude Code docs over HTTPS. The docs intelligence commands intentionally reject --data-source local; use --data-source auto or --data-source live for those commands. For structured retrieval, prefer read, search, symbol, examples, guide, or context over raw pages binary endpoints.

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

claude-agent-sdk-python-docs-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Find the right option fields for a client setup

claude-agent-sdk-python-docs-pp-cli search "ClaudeAgentOptions" --type pages --agent --select items.title,items.url,items.snippet

Returns only the high-signal fields an agent needs instead of the full reference page.

Build a custom-tools implementation bundle

claude-agent-sdk-python-docs-pp-cli context "custom tools" --agent --select sections.title,examples.code,citations.url

Pairs --agent with --select so downstream agents get just examples, section titles, and citations.