Not in the top 1,000 by GitHub stars

Fuenfgeld/pydantic-ai-skills

Production-ready Claude Code skills for building AI agents with Pydantic AI. Includes dependency injection, tools, validators, streaming, multi-agent orchestration, and evaluation framework patterns.

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

skills/pydantic-ai-agents/SKILL.md

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → baf50b57e870

No earlier version was observed for comparison.

Compare on GitHub

skills/pydantic-evals/SKILL.md

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → baf50b57e870

No earlier version was observed for comparison.

Compare on GitHub

View on GitHubAdd to my skills

Verified commit baf50b57e8705f1e4f858d9bfffb06edcc321efe

git clone --filter=blob:none --no-checkout https://github.com/Fuenfgeld/pydantic-ai-skills.git .hotskills/fuenfgeld-pydantic-ai-skills && git -C .hotskills/fuenfgeld-pydantic-ai-skills checkout --detach baf50b57e8705f1e4f858d9bfffb06edcc321efe # Copy each selected skill directory from .hotskills/fuenfgeld-pydantic-ai-skills into .claude/skills/<skill-name>/
10GitHub stars
0stars in 7 days
2skills in this repository
3commits in 30 days

Heat

1.3
  • Star growth, last 7 daysNot available
  • Star growth, last 24 hoursNot available
  • Rank movement, last 7 daysNot available
  • Commits, last 30 daysNot available
  • Accounts asking about it through MCP, last 7 daysNot available
  • Hot votes this weekNot available

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

Oct 25, 2026Oct 25, 202610

30-day change not yet available: not enough history.

Individual skills in this repository

How it works

pydantic-ai-agents

When your agent uses it

Build and debug Pydantic AI v2 agents using best practices for dependencies, instructions, tools, capabilities, hooks, and structured output validation. Use when the user wants to: (1) Create a new Pydantic AI agent, (2) Debug or fix an existing agent, (3) Add features like tools, validators, capabilities, hooks, or dynamic instructions, (4) Integrate OpenRouter for multi-model access, (5) Add Logfire for debugging/observability, (6) Structure agent architecture with dependency injection, (7) Migrate an agent from Pydantic AI v1 to v2.

What it loads into context

Frontmatter

140 tokens

Always available to the agent

SKILL.md

4,339 tokens

When the skill is activated

Reference documents

0 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

  1. Pydantic AI Developer Guide

Scripts executed separately

  • references/01_dependencies.py
  • references/02_prompts.py
  • references/03_tools.py
  • references/04_validators.py
  • references/05_main.py
  • references/06_openrouter.py
  • references/07_logfire.py
  • references/08_streaming.py
  • references/09_result_validators.py
  • references/10_model_settings.py
  • references/11_multi_agent.py
  • references/12_conversation_history.py
  • references/13_capabilities_native_tools.py
  • references/14_hooks.py
  • references/15_toolsets_mcp.py

Files

  • SKILL.mdcore17,474 bytes
  • SKILL.mdcore17,474 bytes
  • SKILL.mdcore17,474 bytes
  • SKILL.mdcore17,474 bytes
  • SKILL.mdcore17,474 bytes
  • SKILL.mdcore17,474 bytes
  • SKILL.mdcore17,474 bytes
  • SKILL.mdcore17,474 bytes
  • references/01_dependencies.pyruns1,392 bytes
  • references/02_prompts.pyruns3,046 bytes
  • references/03_tools.pyruns4,100 bytes
  • references/04_validators.pyruns5,449 bytes
  • references/05_main.pyruns8,357 bytes
  • references/06_openrouter.pyruns2,842 bytes
  • references/07_logfire.pyruns5,154 bytes
  • references/08_streaming.pyruns3,863 bytes
  • references/09_result_validators.pyruns6,416 bytes
  • references/10_model_settings.pyruns5,488 bytes
  • references/11_multi_agent.pyruns9,309 bytes
  • references/12_conversation_history.pyruns6,051 bytes
  • references/13_capabilities_native_tools.pyruns5,045 bytes
  • references/14_hooks.pyruns3,574 bytes
  • references/15_toolsets_mcp.pyruns3,214 bytes
Read SKILL.md

# Pydantic AI Reference Skill

**Targets Pydantic AI v2** (v2.0.0 released 2026-06-23). See the
[v1 → v2 migration notes](#10-v1--v2-migration-notes) at the end for the
breaking changes this skill's examples already incorporate.

## Pydantic AI Developer Guide

### 0. Environment Setup

Store API keys in a `.env` file and add it to `.gitignore`:
```
[Credential-related source omitted]
[Credential-related source omitted]
View the complete source on GitHub

Skills included

  • pydantic-ai-agents
  • pydantic-evals

Repository facts

License
MIT
Created
Jan 20, 2026
Last pushed
Oct 17, 2026
Forks
2
Open issues
0
Project activity
Active

Before you install

Network or broad shell

Automated signals, not a guarantee

Checked Nov 7, 2026

Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.

Show 22 notes
  • skills/pydantic-ai-agents/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/pydantic-ai-agents/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/pydantic-ai-agents/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/pydantic-ai-agents/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/pydantic-ai-agents/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/pydantic-ai-agents/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/pydantic-ai-agents/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/pydantic-evals/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/pydantic-evals/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/pydantic-evals/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/pydantic-evals/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/pydantic-evals/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/pydantic-evals/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/pydantic-evals/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/pydantic-evals/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/pydantic-evals/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/pydantic-evals/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/pydantic-evals/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/pydantic-evals/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/pydantic-evals/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
Show all 97 signals by file

skills/pydantic-ai-agents/SKILL.md

  • Access to secretsline 18
    [Credential-related source omitted]
  • Access to secretsline 19
    [Credential-related source omitted]
  • Access to secretsline 20
    [Credential-related source omitted]
  • Access to secretsline 85
    [Credential-related source omitted]
  • Network accessline 87
    - Explicit: `OpenRouterModel` + `OpenRouterProvider` - OpenRouter model ids are always vendor-prefixed (e.g. `openai/gpt-5.2`,   `anthropic/claude-sonnet-4.6`) - see https://openrouter.ai/models
  • Network accessline 89
    `anthropic/claude-sonnet-4.6`) - see https://openrouter.ai/models
  • Access to secretsline 97
    [Credential-related source omitted]
  • Access to secretsline 103
    [Credential-related source omitted]
  • Network accessline 122
    #### Setup: 1. Get API key from https://logfire.pydantic.dev/
  • Network accessline 123
    1. Get API key from https://logfire.pydantic.dev/
  • Access to secretsline 124
    [Credential-related source omitted]
  • Access to secretsline 126
    [Credential-related source omitted]
  • Network accessline 396
    Full upgrade guide: https://ai.pydantic.dev/changelog/

skills/pydantic-ai-agents/references/01_dependencies.py

  • Executable scriptline 1
    Executable file
  • Access to secretsline 29
    [Credential-related source omitted]
  • Access to secretsline 40
    [Credential-related source omitted]

skills/pydantic-ai-agents/references/02_prompts.py

  • Executable scriptline 1
    Executable file
  • Access to secretsline 18
    [Credential-related source omitted]

skills/pydantic-ai-agents/references/03_tools.py

  • Executable scriptline 1
    Executable file
  • Access to secretsline 18
    [Credential-related source omitted]
  • Network accessline 48
    response = await ctx.deps.http_client.get(         f"https://api.example.com/users/{ctx.deps.user_id}/balance",
  • Network accessline 49
    f"https://api.example.com/users/{ctx.deps.user_id}/balance",
  • Access to secretsline 50
    [Credential-related source omitted]
  • Network accessline 83
    response = await ctx.deps.http_client.post(         "https://api.example.com/transactions",
  • Network accessline 84
    "https://api.example.com/transactions",
  • Access to secretsline 85
    [Credential-related source omitted]

skills/pydantic-ai-agents/references/04_validators.py

  • Executable scriptline 1
    Executable file

skills/pydantic-ai-agents/references/05_main.py

  • Executable scriptline 1
    Executable file
  • Access to secretsline 31
    [Credential-related source omitted]
  • Access to secretsline 69
    [Credential-related source omitted]
  • Network accessline 125
    Args:         ctx: Runtime context with HTTP client and auth         days: Number of days of history to fetch (default: 7)
  • Network accessline 127
    days: Number of days of history to fetch (default: 7)
  • Network accessline 132
    response = await ctx.deps.http_client.get(         f"https://api.example.com/users/{ctx.deps.user_id}/transactions",
  • Network accessline 133
    f"https://api.example.com/users/{ctx.deps.user_id}/transactions",
  • Access to secretsline 134
    [Credential-related source omitted]
  • Network accessline 155
    response = await ctx.deps.http_client.get(         f"https://api.example.com/users/{ctx.deps.user_id}/reputation",
  • Network accessline 156
    f"https://api.example.com/users/{ctx.deps.user_id}/reputation",
  • Access to secretsline 157
    [Credential-related source omitted]
  • Network accessline 183
    async with httpx.AsyncClient() as client:
  • Access to secretsline 187
    [Credential-related source omitted]
  • Network accessline 213
    async with httpx.AsyncClient() as client:
  • Access to secretsline 214
    [Credential-related source omitted]

skills/pydantic-ai-agents/references/06_openrouter.py

  • Executable scriptline 1
    Executable file
  • Access to secretsline 8
    [Credential-related source omitted]
  • Access to secretsline 20
    [Credential-related source omitted]
  • Network accessline 25
    # ============================================================================ # With OPENROUTER_API_KEY set in the environment, just prefix the OpenRouter # model id (always '<vendor>/<model>', see https://openrouter.ai/models):
  • Network accessline 26
    [Credential-related source omitted]
  • Access to secretsline 26
    [Credential-related source omitted]
  • Network accessline 27
    # model id (always '<vendor>/<model>', see https://openrouter.ai/models):
  • Access to secretsline 40
    [Credential-related source omitted]

skills/pydantic-ai-agents/references/07_logfire.py

  • Executable scriptline 1
    Executable file
  • Network accessline 6
    Prerequisites: - Set LOGFIRE_API_KEY in your .env file (get from https://logfire.pydantic.dev/)
  • Network accessline 7
    [Credential-related source omitted]
  • Access to secretsline 7
    [Credential-related source omitted]
  • Access to secretsline 21
    [Credential-related source omitted]
  • Access to secretsline 22
    [Credential-related source omitted]
  • Network accessline 119
    print("\nCheck your Logfire dashboard at https://logfire.pydantic.dev/ to see the traces!")

skills/pydantic-ai-agents/references/08_streaming.py

  • Executable scriptline 1
    Executable file
  • Access to secretsline 21
    [Credential-related source omitted]

skills/pydantic-ai-agents/references/09_result_validators.py

  • Executable scriptline 1
    Executable file
  • Access to secretsline 23
    [Credential-related source omitted]

skills/pydantic-ai-agents/references/10_model_settings.py

  • Executable scriptline 1
    Executable file
  • Access to secretsline 22
    [Credential-related source omitted]

skills/pydantic-ai-agents/references/11_multi_agent.py

  • Executable scriptline 1
    Executable file
  • Access to secretsline 22
    [Credential-related source omitted]

skills/pydantic-ai-agents/references/12_conversation_history.py

  • Executable scriptline 1
    Executable file

skills/pydantic-ai-agents/references/13_capabilities_native_tools.py

  • Executable scriptline 1
    Executable file

skills/pydantic-ai-agents/references/14_hooks.py

  • Executable scriptline 1
    Executable file

skills/pydantic-ai-agents/references/15_toolsets_mcp.py

  • Executable scriptline 1
    Executable file
  • Network accessline 48
    #   server = MCPToolset( #       command='uvx', args=['mcp-run-python', 'stdio'],  # stdio transport #       # or: url='http://localhost:8000/mcp'             # HTTP transport
  • Network accessline 49
    #       command='uvx', args=['mcp-run-python', 'stdio'],  # stdio transport #       # or: url='http://localhost:8000/mcp'             # HTTP transport #   )
  • Network accessline 50
    #       # or: url='http://localhost:8000/mcp'             # HTTP transport
  • Network accessline 67
    # #   from pydantic_ai.capabilities import MCP #   agent = Agent(..., capabilities=[MCP(url='https://mcp.example.com/mcp', native=True)])
  • Network accessline 68
    #   from pydantic_ai.capabilities import MCP #   agent = Agent(..., capabilities=[MCP(url='https://mcp.example.com/mcp', native=True)]) #
  • Network accessline 69
    #   agent = Agent(..., capabilities=[MCP(url='https://mcp.example.com/mcp', native=True)])

skills/pydantic-evals/SKILL.md

  • Access to secretsline 124
    [Credential-related source omitted]
  • Access to secretsline 236
    [Credential-related source omitted]
  • Access to secretsline 239
    [Credential-related source omitted]

skills/pydantic-evals/references/evaluator-types.md

  • Network accessline 280
    # Make actual API call         import httpx         async with httpx.AsyncClient() as client:
  • Network accessline 281
    import httpx         async with httpx.AsyncClient() as client:             response = await client.get(
  • Network accessline 282
    async with httpx.AsyncClient() as client:

skills/pydantic-evals/references/examples/add_custom_evaluators.py

  • Executable scriptline 1
    Executable file

skills/pydantic-evals/references/examples/agent.py

  • Executable scriptline 1
    Executable file
  • Access to secretsline 25
    [Credential-related source omitted]

skills/pydantic-evals/references/examples/compare_models.py

  • Executable scriptline 1
    Executable file

skills/pydantic-evals/references/examples/custom_evaluators.py

  • Executable scriptline 1
    Executable file

skills/pydantic-evals/references/examples/generate_dataset.py

  • Executable scriptline 1
    Executable file

skills/pydantic-evals/references/examples/models.py

  • Executable scriptline 1
    Executable file

skills/pydantic-evals/references/examples/unit_testing.py

  • Executable scriptline 1
    Executable file

skills/pydantic-evals/references/integration.md

  • Access to secretsline 53
    [Credential-related source omitted]
  • Network accessline 60
    """Fetch order details from API"""     response = await ctx.deps.http_client.get(         f"https://api.example.com/orders/{order_id}",
  • Network accessline 61
    [Credential-related source omitted]
  • Network accessline 62
    f"https://api.example.com/orders/{order_id}",
  • Access to secretsline 63
    [Credential-related source omitted]
  • Access to secretsline 80
    [Credential-related source omitted]
  • Access to secretsline 329
    [Credential-related source omitted]
  • Access to secretsline 330
    [Credential-related source omitted]

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Signal confidence: 97 facts

and 47 more

Works with

Agent compatibility, from the files in this repository
AgentStatusEvidenceInstall to
Claude CodeNativePath CLAUDE.md.claude/skills/<skill-name>/
CodexCompatibleStandard SKILL.md skills/pydantic-ai-agents/SKILL.md.agents/skills/<skill-name>/
CursorCompatibleStandard SKILL.md skills/pydantic-ai-agents/SKILL.md.cursor/skills/<skill-name>/
Gemini CLICompatibleStandard SKILL.md skills/pydantic-ai-agents/SKILL.md.gemini/skills/<skill-name>/
GitHub CopilotCompatibleStandard SKILL.md skills/pydantic-ai-agents/SKILL.md.github/skills/<skill-name>/
OpenCodeCompatibleStandard SKILL.md skills/pydantic-ai-agents/SKILL.md.opencode/skills/<skill-name>/
  • Native The repository ships a manifest, folder or frontmatter field for this agent.
  • Compatible A standard SKILL.md that this agent can read.
  • Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.