Not in the top 1,000 by GitHub stars
DougTrajano/pydantic-ai-skills
This package implements Agent Skills (https://agentskills.io) support with progressive disclosure for Pydantic AI. Supports filesystem and programmatic skills.
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
examples/skills/arxiv-search/SKILL.md
Week of Oct 26, 2026 · Line counts unavailable
Before Not checked yet → After Local scripts
First observation → f80614610e86
No earlier version was observed for comparison.
examples/skills/data-analysis/SKILL.md
Week of Oct 26, 2026 · Line counts unavailable
Before Not checked yet → After Local scripts
First observation → f80614610e86
No earlier version was observed for comparison.
examples/skills/pydanticai-docs/SKILL.md
Week of Oct 26, 2026 · Line counts unavailable
Before Not checked yet → After Network or broad shell
First observation → f80614610e86
No earlier version was observed for comparison.
examples/skills/web-research/SKILL.md
Week of Oct 26, 2026 · Line counts unavailable
Before Not checked yet → After Instructions only
First observation → f80614610e86
No earlier version was observed for comparison.
Verified commit f80614610e86463fb05ab10daad9a417c4d5b096
git clone --filter=blob:none --no-checkout https://github.com/DougTrajano/pydantic-ai-skills.git .hotskills/dougtrajano-pydantic-ai-skills && git -C .hotskills/dougtrajano-pydantic-ai-skills checkout --detach f80614610e86463fb05ab10daad9a417c4d5b096
# Copy each selected skill directory from .hotskills/dougtrajano-pydantic-ai-skills into .claude/skills/<skill-name>/git clone --filter=blob:none --no-checkout https://github.com/DougTrajano/pydantic-ai-skills.git .hotskills/dougtrajano-pydantic-ai-skills && git -C .hotskills/dougtrajano-pydantic-ai-skills checkout --detach f80614610e86463fb05ab10daad9a417c4d5b096
# Copy each selected skill directory from .hotskills/dougtrajano-pydantic-ai-skills into .agents/skills/<skill-name>/Heat
1.6- 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
30-day change not yet available: not enough history.
Individual skills in this repository
- arxiv-search
examples/skills/arxiv-search - data-analysis
examples/skills/data-analysis - pydanticai-docs
examples/skills/pydanticai-docs - web-research
examples/skills/web-research
How it works
arxiv-search
When your agent uses it
Search arXiv preprint repository for papers in physics, mathematics, computer science, quantitative biology, and related fields.
What it loads into context
Frontmatter
48 tokensAlways available to the agent
SKILL.md
374 tokensWhen the skill is activated
Reference documents
0 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- When to Use This Skill
- Skill Scripts
- Output Format
- Dependencies
Scripts executed separately
scripts/arxiv_search.py
Files
SKILL.mdcore1,788 bytesscripts/arxiv_search.pyruns1,829 bytes
Read SKILL.md
# arXiv Search Skill
This skill provides access to arXiv, a free distribution service and open-access archive for scholarly articles in physics, mathematics, computer science, quantitative biology, quantitative finance, statistics, electrical engineering, systems science, and economics.
## When to Use This Skill
Use this skill when you need to:
- Find preprints and recent research papers before journal publication
- Search for papers in computational biology, bioinformatics, or systems biology
- Access mathematical or statistical methods papers relevant to biology
- Find machine learning papers applied to biological problems
- Get the latest research that may not yet be in PubMed
View the complete source on GitHubdata-analysis
When your agent uses it
Profile and aggregate a bundled sales dataset - group revenue by region, category, channel or month, apply filters, and compute sums, means, medians and ranges. Use for questions about sales figures, trends, or which segments perform best.
What it loads into context
Frontmatter
75 tokensAlways available to the agent
SKILL.md
666 tokensWhen the skill is activated
Reference documents
0 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- When to Use This Skill
- Skill Scripts
- Data Source
- Sandbox Behaviour
Scripts executed separately
scripts/aggregate.pyscripts/profile_dataset.py
Files
SKILL.mdcore2,867 bytesresources/sales.csvasset5,050 bytesscripts/aggregate.pyruns3,822 bytesscripts/profile_dataset.pyruns2,716 bytes
Read SKILL.md
# Data Analysis Skill
Answers questions about a bundled sales dataset (`resources/sales.csv`): 96 rows
covering six months, four regions, four product categories and three sales
channels.
This is the reference skill for exercising sandbox executors. Both scripts are
standard library only and read their data from the skill folder, so they do real
work with no network, no third-party packages and no host access — exactly the
shape a sandbox is meant to run.
## When to Use This Skill
- "Which region had the highest revenue?" → `aggregate`View the complete source on GitHubpydanticai-docs
When your agent uses it
Use this skill whenever the user is working with the Pydantic AI framework — including building AI agents, defining structured outputs with Pydantic models, wiring up tools/function calling, configuring model providers (OpenAI, Anthropic, Gemini, etc.), managing dependencies via agent context, handling streaming responses, or debugging agent runs. Trigger this skill even for adjacent tasks like "how do I make my agent return JSON", "set up a multi-step agent", "add a tool to my agent", or "validate LLM output with Pydantic" — any time Pydantic AI is mentioned or implied as the target framework.
What it loads into context
Frontmatter
163 tokensAlways available to the agent
SKILL.md
1,301 tokensWhen the skill is activated
Reference documents
4,942 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- What is Pydantic AI?
- Core Concepts
- Additional Topics
- Agent Behavior Rules
Files
SKILL.mdcore5,241 bytesSKILL.mdcore5,241 bytesSKILL.mdcore5,241 bytesSKILL.mdcore5,241 bytesSKILL.mdcore5,241 bytesreferences/AGENT.mddoc3,188 bytesreferences/DEPENDENCIES.mddoc2,009 bytesreferences/FUNCTION_TOOLS.mddoc2,255 bytesreferences/MCP.mddoc2,363 bytesreferences/MESSAGES.mddoc2,244 bytesreferences/MODELS.mddoc3,956 bytesreferences/OUTPUT.mddoc1,897 bytesreferences/TOOLS_AND_TOOLSETS.mddoc2,570 bytes
Read SKILL.md
# Pydantic AI Documentation Skill
## What is Pydantic AI?
Pydantic AI is a production-grade Python agent framework for building type-safe, dependency-injected Generative AI applications. It supports multiple LLM providers, structured outputs via Pydantic models, and composable multi-agent patterns.
Doc: <https://ai.pydantic.dev/>
---
## Core Concepts
### 1. Agent Instantiation
View the complete source on GitHubweb-research
When your agent uses it
Use this skill for requests related to web research; it provides a structured approach to conducting comprehensive web research.
What it loads into context
Frontmatter
29 tokensAlways available to the agent
SKILL.md
523 tokensWhen the skill is activated
Reference documents
0 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- When to Use This Skill
- Research Process
- Best Practices
Files
SKILL.mdcore2,475 bytes
Read SKILL.md
# Web Research Skill
This skill provides guidance on conducting comprehensive web research. It emphasizes planning, efficient information gathering, and systematic synthesis of findings.
**Note:** This skill provides a methodology and best practices for web research. It does not include executable scripts or tools beyond what's available in your agent's toolset.
## When to Use This Skill
Use this skill when you need to:
- Research complex topics requiring multiple information sources
- Gather and synthesize current information from the web
- Conduct comparative analysis across multiple subjects
- Produce well-sourced research reports with clear citationsView the complete source on GitHubSkills included
- arxiv-search
- data-analysis
- pydanticai-docs
- web-research
Repository facts
- License
- MIT
- Created
- Dec 18, 2025
- Last pushed
- Nov 6, 2026
- Forks
- 29
- Open issues
- 0
- Project activity
- Active
Before you install
Network or broad shellAutomated signals, not a guarantee
Checked Nov 4, 2026
Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.
Show 4 notes
examples/skills/pydanticai-docs/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedexamples/skills/pydanticai-docs/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedexamples/skills/pydanticai-docs/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedexamples/skills/pydanticai-docs/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzed
- No broad tool permissions
- No dangerous shell commands
- 43 network referencesin 9 files: pydanticai-docs/SKILL.md:16 pydanticai-docs/references/MODELS.md:66 pydanticai-docs/references/MCP.md:27 and 6 more
- No hidden or obfuscated text
- No instruction overrides
- 3 executable scriptsin 3 files: arxiv-search/scripts/arxiv_search.py:1 data-analysis/scripts/aggregate.py:1 data-analysis/scripts/profile_dataset.py:1
- 17 references to secretsin 3 files: pydanticai-docs/references/MODELS.md:9 pydanticai-docs/references/DEPENDENCIES.md:22 pydanticai-docs/SKILL.md:62
- No requests to vote in Hot
Show all 63 signals by file
examples/skills/arxiv-search/scripts/arxiv_search.py
- Executable scriptline 1
#!/usr/bin/env python3
examples/skills/data-analysis/scripts/aggregate.py
- Executable scriptline 1
#!/usr/bin/env python3
examples/skills/data-analysis/scripts/profile_dataset.py
- Executable scriptline 1
#!/usr/bin/env python3
examples/skills/pydanticai-docs/SKILL.md
- Network accessline 16
Doc: <https://ai.pydantic.dev/> - Access to secretsline 62
[Credential-related source omitted] - Network accessline 97
| Topic | Reference file | Doc link | |---|---|---| | Message history / multi-turn conversations | `references/MESSAGES.md` | <https://ai.pydantic.dev/core-concepts/message-history/index.md> | - Network accessline 98
|---|---|---| | Message history / multi-turn conversations | `references/MESSAGES.md` | <https://ai.pydantic.dev/core-concepts/message-history/index.md> | | Model / provider setup (all providers) | `references/MODELS.md` | <https://ai.pydan - Network accessline 99
| Message history / multi-turn conversations | `references/MESSAGES.md` | <https://ai.pydantic.dev/core-concepts/message-history/index.md> | - Network accessline 100
| Model / provider setup (all providers) | `references/MODELS.md` | <https://ai.pydantic.dev/models/overview/index.md> | - Network accessline 101
| Toolsets (`FunctionToolset`, composition) | `references/TOOLS_AND_TOOLSETS.md` | <https://ai.pydantic.dev/tools-toolsets/toolsets/index.md> | - Network accessline 102
| MCP server integration | `references/MCP.md` | <https://ai.pydantic.dev/mcp/client/index.md> | - Network accessline 103
| Multi-agent applications | doc link only | <https://ai.pydantic.dev/guides/multi-agent-applications/index.md> | - Network accessline 104
| Graphs (pydantic-graph) | doc link only | <https://ai.pydantic.dev/graph/graph/index.md> | - Network accessline 105
| Evals (pydantic-evals) | doc link only | <https://ai.pydantic.dev/evals/evals/index.md> | - Network accessline 106
| Durable execution | doc link only | <https://ai.pydantic.dev/durable_execution/overview/index.md> | - Network accessline 107
| Retries | doc link only | <https://ai.pydantic.dev/core-concepts/retries/index.md> | - Network accessline 108
| Testing (`TestModel`, `override`) | doc link only | <https://ai.pydantic.dev/guides/testing/index.md> | - Network accessline 109
| Logfire integration | doc link only | <https://ai.pydantic.dev/integrations/logfire/index.md> | - Network accessline 110
| Native tools (formerly builtin tools) | doc link only | <https://ai.pydantic.dev/tools-toolsets/native-tools/index.md> | - Network accessline 111
| Streaming | doc link only | <https://ai.pydantic.dev/core-concepts/agent/index.md> |
examples/skills/pydanticai-docs/references/AGENT.md
examples/skills/pydanticai-docs/references/DEPENDENCIES.md
- Access to secretsline 22
[Credential-related source omitted] - Access to secretsline 29
[Credential-related source omitted] - Network accessline 36
async def main(): async with httpx.AsyncClient() as client: - Network accessline 37
async with httpx.AsyncClient() as client: - Access to secretsline 38
[Credential-related source omitted] - Network accessline 62
<https://ai.pydantic.dev/core-concepts/dependencies/index.md>
examples/skills/pydanticai-docs/references/FUNCTION_TOOLS.md
examples/skills/pydanticai-docs/references/MCP.md
- Network accessline 27
server = MCPServerStreamableHTTP('http://localhost:8000/mcp') - Network accessline 55
weather = MCPServerStreamableHTTP('http://localhost:3001/mcp', tool_prefix='weather') - Network accessline 56
calc = MCPServerStreamableHTTP('http://localhost:3002/mcp', tool_prefix='calc') - Network accessline 75
- Client guide: <https://ai.pydantic.dev/mcp/client/index.md> - Network accessline 76
- Overview: <https://ai.pydantic.dev/mcp/overview/index.md> - Network accessline 77
- API reference: <https://ai.pydantic.dev/api/mcp/index.md>
examples/skills/pydanticai-docs/references/MESSAGES.md
examples/skills/pydanticai-docs/references/MODELS.md
- Access to secretsline 9
[Credential-related source omitted] - Access to secretsline 10
[Credential-related source omitted] - Access to secretsline 11
[Credential-related source omitted] - Access to secretsline 12
[Credential-related source omitted] - Access to secretsline 13
[Credential-related source omitted] - Access to secretsline 14
[Credential-related source omitted] - Access to secretsline 15
[Credential-related source omitted] - Access to secretsline 16
[Credential-related source omitted] - Access to secretsline 18
[Credential-related source omitted] - Access to secretsline 21
[Credential-related source omitted] - Access to secretsline 38
[Credential-related source omitted] - Access to secretsline 41
[Credential-related source omitted] - Access to secretsline 44
[Credential-related source omitted] - Network accessline 66
- Overview: <https://ai.pydantic.dev/models/overview/index.md> - Network accessline 67
- OpenAI: <https://ai.pydantic.dev/models/openai/index.md> - Network accessline 68
- Anthropic: <https://ai.pydantic.dev/models/anthropic/index.md> - Network accessline 69
- Google: <https://ai.pydantic.dev/models/google/index.md> - Network accessline 70
- Groq: <https://ai.pydantic.dev/models/groq/index.md> - Network accessline 71
- Mistral: <https://ai.pydantic.dev/models/mistral/index.md> - Network accessline 72
- Bedrock: <https://ai.pydantic.dev/models/bedrock/index.md> - Network accessline 73
- OpenRouter: <https://ai.pydantic.dev/models/openrouter/index.md>
examples/skills/pydanticai-docs/references/OUTPUT.md
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.
Some files could not be read; the facts below still hold.
Signal confidence: 63 facts
- Executable script in code of a file that runsarxiv-search/scripts/arxiv_search.py:1High confidence
- Executable script in code of a file that runsdata-analysis/scripts/aggregate.py:1High confidence
- Executable script in code of a file that runsdata-analysis/scripts/profile_dataset.py:1High confidence
- Network access in prose of the SKILL.mdpydanticai-docs/SKILL.md:16Low confidence
- Access to secrets in code of the SKILL.mdpydanticai-docs/SKILL.md:62High confidence
- Network access in prose of the SKILL.mdpydanticai-docs/SKILL.md:97Low confidence
- Network access in prose of the SKILL.mdpydanticai-docs/SKILL.md:98Low confidence
- Network access in prose of the SKILL.mdpydanticai-docs/SKILL.md:99Low confidence
- Network access in prose of the SKILL.mdpydanticai-docs/SKILL.md:100Low confidence
- Network access in prose of the SKILL.mdpydanticai-docs/SKILL.md:101Low confidence
- Network access in prose of the SKILL.mdpydanticai-docs/SKILL.md:102Low confidence
- Network access in prose of the SKILL.mdpydanticai-docs/SKILL.md:103Low confidence
- Network access in prose of the SKILL.mdpydanticai-docs/SKILL.md:104Low confidence
- Network access in prose of the SKILL.mdpydanticai-docs/SKILL.md:105Low confidence
- Network access in prose of the SKILL.mdpydanticai-docs/SKILL.md:106Low confidence
- Network access in prose of the SKILL.mdpydanticai-docs/SKILL.md:107Low confidence
- Network access in prose of the SKILL.mdpydanticai-docs/SKILL.md:108Low confidence
- Network access in prose of the SKILL.mdpydanticai-docs/SKILL.md:109Low confidence
- Network access in prose of the SKILL.mdpydanticai-docs/SKILL.md:110Low confidence
- Network access in prose of the SKILL.mdpydanticai-docs/SKILL.md:111Low confidence
- Network access in prose of documentationpydanticai-docs/references/AGENT.md:69Low confidence
- Network access in prose of documentationpydanticai-docs/references/AGENT.md:70Low confidence
- Access to secrets in code of documentationpydanticai-docs/references/DEPENDENCIES.md:22Low confidence
- Access to secrets in code of documentationpydanticai-docs/references/DEPENDENCIES.md:29Low confidence
- Network access in code of documentationpydanticai-docs/references/DEPENDENCIES.md:36Low confidence
- Network access in code of documentationpydanticai-docs/references/DEPENDENCIES.md:37Low confidence
- Access to secrets in code of documentation: a variable, placeholder or call, not a stored valuepydanticai-docs/references/DEPENDENCIES.md:38Low confidence
- Network access in prose of documentationpydanticai-docs/references/DEPENDENCIES.md:62Low confidence
- Network access in prose of documentationpydanticai-docs/references/FUNCTION_TOOLS.md:66Low confidence
- Network access in prose of documentationpydanticai-docs/references/FUNCTION_TOOLS.md:67Low confidence
- Network access in code of documentationpydanticai-docs/references/MCP.md:27Low confidence
- Network access in code of documentationpydanticai-docs/references/MCP.md:55Low confidence
- Network access in code of documentationpydanticai-docs/references/MCP.md:56Low confidence
- Network access in prose of documentationpydanticai-docs/references/MCP.md:75Low confidence
- Network access in prose of documentationpydanticai-docs/references/MCP.md:76Low confidence
- Network access in prose of documentationpydanticai-docs/references/MCP.md:77Low confidence
- Network access in prose of documentationpydanticai-docs/references/MESSAGES.md:68Low confidence
- Network access in prose of documentationpydanticai-docs/references/MESSAGES.md:69Low confidence
- Access to secrets in prose of documentation: a variable, placeholder or call, not a stored valuepydanticai-docs/references/MODELS.md:9Low confidence
- Access to secrets in prose of documentation: a variable, placeholder or call, not a stored valuepydanticai-docs/references/MODELS.md:10Low confidence
- Access to secrets in prose of documentation: a variable, placeholder or call, not a stored valuepydanticai-docs/references/MODELS.md:11Low confidence
- Access to secrets in prose of documentation: a variable, placeholder or call, not a stored valuepydanticai-docs/references/MODELS.md:12Low confidence
- Access to secrets in prose of documentation: a variable, placeholder or call, not a stored valuepydanticai-docs/references/MODELS.md:13Low confidence
- Access to secrets in prose of documentation: a variable, placeholder or call, not a stored valuepydanticai-docs/references/MODELS.md:14Low confidence
- Access to secrets in prose of documentation: a variable, placeholder or call, not a stored valuepydanticai-docs/references/MODELS.md:15Low confidence
- Access to secrets in prose of documentation: a variable, placeholder or call, not a stored valuepydanticai-docs/references/MODELS.md:16Low confidence
- Access to secrets in prose of documentationpydanticai-docs/references/MODELS.md:18Low confidence
- Access to secrets in prose of documentation: a variable, placeholder or call, not a stored valuepydanticai-docs/references/MODELS.md:21Low confidence
- Access to secrets in code of documentation: a variable, placeholder or call, not a stored valuepydanticai-docs/references/MODELS.md:38Low confidence
- Access to secrets in code of documentation: a variable, placeholder or call, not a stored valuepydanticai-docs/references/MODELS.md:41Low confidence
and 13 more
Works with
| Agent | Status | Evidence | Install to |
|---|---|---|---|
| Claude Code | Native | Path .claude/commands/upstream-watch.md | .claude/skills/<skill-name>/ |
| Codex | Native | Manifest AGENTS.md | .agents/skills/<skill-name>/ |
| Cursor | Compatible | Standard SKILL.md examples/skills/arxiv-search/SKILL.md | .cursor/skills/<skill-name>/ |
| Gemini CLI | Compatible | Standard SKILL.md examples/skills/arxiv-search/SKILL.md | .gemini/skills/<skill-name>/ |
| GitHub Copilot | Compatible | Standard SKILL.md examples/skills/arxiv-search/SKILL.md | .github/skills/<skill-name>/ |
| OpenCode | Compatible | Standard SKILL.md examples/skills/arxiv-search/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.