---
title: "pydantic/pydantic-ai skills · skilld"
description: "How Python does AI. Agents, realtime voice, image generation, embeddings. Every model, every interface, typed end to end."
canonical_url: "https://skilld.dev/gh/pydantic/pydantic-ai"
meta:
  "og:description": "How Python does AI. Agents, realtime voice, image generation, embeddings. Every model, every interface, typed end to end."
  "og:image": "https://skilld.dev/_og/d/a_~c2tpbGxkLCBhZ2VudCBza2lsbHMgd3JpdHRlbiBieSByZWFsIG1haW50YWluZXJz%2Cc_Page.takumi%2Cdescription_~Q3VyYXRlZCBhZ2VudCBza2lsbHMgYnkgaHVtYW5zLCB3cml0dGVuIGJ5IHJlYWwgbWFpbnRhaW5lcnMgaW4gdGhlaXIgb3duIEdpdEh1YiByZXBvcw%2Cp_Ii9naC9weWRhbnRpYy9weWRhbnRpYy1haSI%2Cs_pYMJQaWNHiRdwsS8.png"
  "og:image:alt": "skilld, agent skills written by real maintainers"
  "og:image:height": "600"
  "og:image:type": image/png
  "og:image:width": "1200"
  "og:title": "pydantic/pydantic-ai skills"
  "twitter:description": "How Python does AI. Agents, realtime voice, image generation, embeddings. Every model, every interface, typed end to end."
  "twitter:image": "https://skilld.dev/_og/d/a_~c2tpbGxkLCBhZ2VudCBza2lsbHMgd3JpdHRlbiBieSByZWFsIG1haW50YWluZXJz%2Cc_Page.takumi%2Cdescription_~Q3VyYXRlZCBhZ2VudCBza2lsbHMgYnkgaHVtYW5zLCB3cml0dGVuIGJ5IHJlYWwgbWFpbnRhaW5lcnMgaW4gdGhlaXIgb3duIEdpdEh1YiByZXBvcw%2Cp_Ii9naC9weWRhbnRpYy9weWRhbnRpYy1haSI%2Cs_pYMJQaWNHiRdwsS8.png"
  "twitter:image:alt": "skilld, agent skills written by real maintainers"
  "twitter:title": "pydantic/pydantic-ai skills"
---

> Index of every page on this site: [llms.txt](https://skilld.dev/llms.txt)

[All skills](https://skilld.dev/skills)

[![pydantic avatar](https://skilld.dev/_img/avatar?url=https%3A%2F%2Fgithub.com%2Fpydantic.png)](https://skilld.dev/gh/pydantic)

# **pydantic/pydantic-ai**

How Python does AI. Agents, realtime voice, image generation, embeddings. Every model, every interface, typed end to end.

main Updated 30 minutes ago [GitHub](https://github.com/pydantic/pydantic-ai)

![README badge for pydantic/pydantic-ai](https://skilld.dev/b/pydantic/pydantic-ai?theme=light&label=0)

## Repository statistics

- Indexed skills

  **20**
- Skill groups

  **1**
- GitHub stars

  **21,320**
- Forks

  **3,228**

## Skills

20 total

Sort skills

[/add-new-model](https://skilld.dev/gh/pydantic/pydantic-ai/add-new-model)

Add support for a newly-released language or image generation model in pydantic-ai (e.g. openai:gpt-5.6, anthropic:claude-sonnet-5, openai:gpt-image-2). Use when a provider ships a new model id and you need to wire literals, profile flags, adapters, and tests to recognize it. Handles SDK-lag, gateway list conventions, capability probing, and direct image-model geometry. Also use when Anthropic or OpenAI deprecates or retires a model, to update the deprecation tables.

Updatedyesterday

[/pushing-commits-to-the-repo](https://skilld.dev/gh/pydantic/pydantic-ai/pushing-commits-to-the-repo)

Open and advance a PR — write current metadata, apply the bounded pre-push review gate and its exemptions, push, watch CI, and triage comments. Use whenever you open a PR or push a commit.

Updated2 days ago

[/pydantic-ai-harness](https://skilld.dev/gh/pydantic/pydantic-ai/pydantic-ai-harness)

Extend Pydantic AI agents with capabilities from pydantic-ai-harness -- the Coder coding agent, file and shell tools in local or sandboxed workspaces (Modal, E2B, Render, Sprites, Daytona, boxd, smolvm, BoxLite), Code Mode, sub-agents and planning, model routing, memory and skills, context compaction, guardrails and spend limits, web research and browsers, hosted SaaS integrations, step persistence, and background agents on Render Workflows. Use when the user mentions pydantic-ai-harness or pydantic\_ai\_harness, imports a harness capability such as Coder, CodeMode, FileSystem, Shell, SubAgents, ModelRouter, Memory, or ToolGuardrail, or wants a Pydantic AI agent that edits files, runs commands or agent-written Python, delegates, routes work between models, remembers, manages long context, stays within limits, or runs model and tool operations as chained Render task runs.

Updated2 days ago

[/building-pydantic-ai-agents](https://skilld.dev/gh/pydantic/pydantic-ai/building-pydantic-ai-agents)

Build AI agents with Pydantic AI — tools, capabilities (including on-demand loading), workspaces, structured output, streaming, testing, and multi-agent patterns. Use when the user mentions Pydantic AI, imports pydantic\_ai, or asks to build an AI agent, add tools/capabilities, attach a workspace, defer capability loading, stream output, define agents from YAML, or test agent behavior.

Updated3 days ago

[/pre-push-review](https://skilld.dev/gh/pydantic/pydantic-ai/pre-push-review)

Review candidate content locally under the scope, exemptions, and three-review budget defined by pushing-commits-to-the-repo

Updated18 days ago

[/complete-partial-pr](https://skilld.dev/gh/pydantic/pydantic-ai/complete-partial-pr)

Evaluate and complete an issue or PR where the submitted patch fixes only a narrow symptom of the reported pain point. Use when a contribution may miss adjacent integration surfaces, provider/spec semantics, roundtrip behavior, tests, docs, or historical maintainer decisions.

Updated24 days ago

[/adding-a-provider-api-feature](https://skilld.dev/gh/pydantic/pydantic-ai/adding-a-provider-api-feature)

Add a new provider API capability (prompt caching, strict/structured tool calling, thinking/reasoning effort, service tier, safety settings, logprobs, etc.) to Pydantic AI. Use when wiring a provider feature through the library — it enforces reasoning from the existing cross-provider abstraction before designing anything, and picking default-on vs opt-in deliberately. Not for adding a new model id (that's a different flow) or a bug fix.

Updated29 days ago

[/poweruser-feature-audit](https://skilld.dev/gh/pydantic/pydantic-ai/poweruser-feature-audit)

Independent power-user audit of a big new-feature PR. Research the feature domain from external sources before reading any implementation code, design the ideal test suite from a power-user's perspective, then gap-compare it against the PR to produce evidence-backed, precedent-linked review items. Use when a large feature PR (new provider API surface, new modality, new subsystem) needs an unbiased second opinion grounded in what the underlying APIs and real integrators require. Not a diff review.

Updatedlast month

[/docs-parity-reviewer](https://skilld.dev/gh/pydantic/pydantic-ai/docs-parity-reviewer)

Use as the final documentation gate before a \`pydantic-ai-harness\` capability PR merges. Verifies that a user-facing change keeps the capability README under \`src/pydantic\_ai\_harness/pydantic\_ai\_harness/\` and its \`docs/harness/\` page in sync with each other and with the code, that every snippet is runnable, and that links follow repo convention. Reports gaps; does not edit. Skip it for changes that touch no harness capability or its docs.

Updated2 months ago

[/migrating-langchain-to-pydantic-ai](https://skilld.dev/gh/pydantic/pydantic-ai/migrating-langchain-to-pydantic-ai)

Migrate Python LangChain, LangGraph, or Deep Agents applications to Pydantic AI and, when the source uses harness features, Pydantic AI Harness. Use for LangChain agents, chains, LCEL, direct LangGraph graphs, persistence, interrupts, streaming, and \`create\_deep\_agent\` projects with planning, filesystem or sandbox backends, skills, memory, subagents, permissions, approvals, or Deep Agents Code hosts.

Updated2 months ago

[/migrating-agno-to-pydantic-ai](https://skilld.dev/gh/pydantic/pydantic-ai/migrating-agno-to-pydantic-ai)

Migrate Python Agno applications to Pydantic AI and, only when needed, Pydantic AI Harness. Use when source code imports \`agno\` or relies on Agno agents, teams, workflows, sessions, memory, knowledge, tools, hooks, guardrails, approvals, skills, streaming, or AgentOS.

Updated2 months ago

[/migrating-pi-to-pydantic-ai](https://skilld.dev/gh/pydantic/pydantic-ai/migrating-pi-to-pydantic-ai)

Migrate TypeScript Pi coding-agent applications, extensions, or packages to Python with Pydantic AI and Pydantic AI Harness. Use when source code imports \`@earendil-works/pi-\*\`, calls \`createAgentSession\`, registers Pi extensions, or relies on Pi tools, hooks, skills, sessions, compaction, providers, TUI, RPC, or packages.

Updated2 months ago

[/migrating-vercel-ai-sdk-and-eve-to-pydantic-ai](https://skilld.dev/gh/pydantic/pydantic-ai/migrating-vercel-ai-sdk-and-eve-to-pydantic-ai)

Migrate TypeScript Vercel AI SDK or Eve applications to Python with Pydantic AI and, only when needed, Pydantic AI Harness. Use when source code imports \`ai\`, \`@ai-sdk/\*\`, or \`eve\`, or relies on \`generateText\`, \`streamText\`, \`ToolLoopAgent\`, \`useChat\`, Eve agents, tools, skills, subagents, approvals, sessions, channels, schedules, or sandboxes.

Updated2 months ago

[/migrating-openai-agents-sdk-to-pydantic-ai](https://skilld.dev/gh/pydantic/pydantic-ai/migrating-openai-agents-sdk-to-pydantic-ai)

Migrate Python OpenAI Agents SDK applications to Pydantic AI and, when warranted, Pydantic AI Harness. Use for \`agents.Agent\`, \`Runner\`, function tools, handoffs, guardrails, sessions, human approval, streaming, or \`SandboxAgent\`. Do not use for applications built directly on the OpenAI Responses API without the Agents SDK runtime.

Updated2 months ago

[/migrating-google-adk-to-pydantic-ai](https://skilld.dev/gh/pydantic/pydantic-ai/migrating-google-adk-to-pydantic-ai)

Migrate Python Google Agent Development Kit (ADK) applications to Pydantic AI. Use for \`LlmAgent\`, \`Runner\`, sessions, state, memory, tools, callbacks, plugins, graph or dynamic workflows, resumability, events, artifacts, MCP, and ADK deployment boundaries.

Updated2 months ago

[/migrating-mastra-to-pydantic-ai](https://skilld.dev/gh/pydantic/pydantic-ai/migrating-mastra-to-pydantic-ai)

Migrate TypeScript Mastra applications to Python with Pydantic AI and, only when needed, Pydantic AI Harness. Use when source code imports \`@mastra/\*\` or relies on Mastra agents, tools, workflows, memory, processors, streaming, approvals, skills, or subagents.

Updated2 months ago

[/migrating-claude-agent-sdk-to-pydantic-ai](https://skilld.dev/gh/pydantic/pydantic-ai/migrating-claude-agent-sdk-to-pydantic-ai)

Migrate Python applications from the Claude Agent SDK to Pydantic AI and, only when needed, Pydantic AI Harness. Use when source code imports \`claude\_agent\_sdk\` or relies on Claude Code's agent loop, sessions, built-in tools, hooks, permissions, skills, or subagents. Do not use for the Anthropic Messages SDK or Claude Managed Agents.

Updated2 months ago

[/migrating-deep-agents-to-pydantic-ai-harness](https://skilld.dev/gh/pydantic/pydantic-ai/migrating-deep-agents-to-pydantic-ai-harness)

Migrate Python LangChain Deep Agents applications to Pydantic AI and Pydantic AI Harness. Use when the source uses the upstream \`deepagents\` package or demonstrably reproduces its middleware, backends, skills, memory, subagents, or sandbox contracts. Use \`migrating-langchain-to-pydantic-ai\` for plain LangChain, LangGraph, or LCEL migrations and \`pydantic-ai-harness\` for greenfield Harness usage.

Updated2 months ago

[/i-have-adhd](https://skilld.dev/gh/pydantic/pydantic-ai/i-have-adhd)

Shape every response for an ADHD reader who reviews the work but does not do the coding — the agent does. Use whenever responding to ANY message — coding, debugging, planning, casual. Lead with the result or the decision. Surface anything needing the user's input as a structured question, never buried in prose they'll skim past. No preamble, no recap, no closers. State errors matter-of-factly. Make finished work visible. Trigger even on casual messages and even when brevity wasn't requested.

Updated4 months ago

[/testing-skill](https://skilld.dev/gh/pydantic/pydantic-ai/testing-skill)

Record, rewrite, and debug VCR cassettes for HTTP recordings. Use when running tests with --record-mode, verifying cassette playback, or inspecting request/response bodies in YAML cassettes.

Updated6 months ago

## Add to your README

The badge links readers to this page. It shows the skilld mark and no counts, and it follows the reader's light or dark GitHub theme.

`<a href="https://skilld.dev/gh/pydantic/pydantic-ai"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://skilld.dev/b/pydantic/pydantic-ai?theme=dark"> <source media="(prefers-color-scheme: light)" srcset="https://skilld.dev/b/pydantic/pydantic-ai?theme=light"> <img alt="Skill repository on skilld.dev" src="https://skilld.dev/b/pydantic/pydantic-ai?theme=light"> </picture> </a>`

```json
{"@context":"https://schema.org","@graph":[{"@id":"https://skilld.dev/#website","@type":"WebSite","description":"Curated agent skills by humans, written by real maintainers in their own GitHub repos","name":"skilld","url":"https://skilld.dev/"},{"@id":"https://skilld.dev/gh/pydantic/pydantic-ai#webpage","@type":"WebPage","description":"How Python does AI. Agents, realtime voice, image generation, embeddings. Every model, every interface, typed end to end.","name":"pydantic/pydantic-ai skills","url":"https://skilld.dev/gh/pydantic/pydantic-ai","isPartOf":{"@id":"https://skilld.dev/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://skilld.dev/gh/pydantic/pydantic-ai"]}]}]}
```