Skip to content

Coding Agent Skills

If you’re building Pydantic AI applications with a coding agent, you can install the Pydantic AI skill from the pydantic/skills repository to give your agent up-to-date framework knowledge.

Agent skills are packages of instructions and reference material that coding agents load on demand. With the skill installed, coding agents have access to Pydantic AI patterns, architecture guidance, and common task references covering tools, capabilities, structured output, streaming, testing, multi-agent delegation, hooks, and agent specs.

When your coding agent creates a new Pydantic AI application, the skill has it set up Pydantic Logfire for observability (unless you already use another OpenTelemetry backend), so you can see every agent run, model request, and tool call from the first version. It also knows the Pydantic AI Gateway, one key for models from several providers, and the gateway/ model strings that use it.

For the rest of Logfire, such as instrumenting the rest of your application, querying traces, or running evals, the pydantic/skills repository has Logfire skills too: install the logfire plugin, or point your agent at pydantic.dev/ai-setup.md for the guided setup.

Installation

Claude Code

Install the official Pydantic AI plugin from the Anthropic marketplace, which is available by default:

Terminal
claude plugin install pydantic-ai@claude-plugins-official

As an alternative, you can install from the pydantic/skills marketplace, which bundles the Pydantic AI skill alongside other Pydantic-maintained skills:

Terminal
claude plugin marketplace add pydantic/skills
claude plugin install ai@pydantic-skills
claude plugin install logfire@pydantic-skills

Cross-Agent (agentskills.io)

Install the Pydantic AI skill using the skills CLI:

Terminal
npx skills add pydantic/skills

This works with 30+ agents via the agentskills.io standard, including Claude Code, Codex, Cursor, and Gemini CLI.

Library Skills

Pydantic AI also ships its skills bundled with the package, so you can install them directly from your project’s dependencies via library-skills.io:

Terminal
uvx library-skills --all

The --all flag is required because the skills are bundled in pydantic-ai-slim, which is a transitive dependency of the pydantic-ai meta-package. Without it, library-skills only scans direct dependencies and won’t discover them.

Add --claude to also install into .claude/skills/ alongside the default .agents/skills/ directory, since Claude Code doesn’t read from .agents/.

This installation also includes migration skills for moving applications from other agent frameworks to Pydantic AI.

See Also