DougTrajano/pydantic-ai-skills
This package implements Agent Skills (https://agentskills.io) support with progressive disclosure for Pydantic AI. Supports filesystem and programmatic skills.
What it solves
It provides a way to give AI agents specialized capabilities without bloating the prompt. Instead of loading every possible instruction and tool into the agent's memory at once, it allows agents to dynamically load only the specific "skills" they need for a given task.
How it works
Skills are organized as modular packages (folders) containing a SKILL.md file for instructions, optional reference documents, and executable scripts. The library uses a concept called "progressive disclosure": the agent initially sees only a catalog of skill names and descriptions. When a specific task requires a skill, the agent uses provided tools to load the full instructions, read bundled resources, or execute the scripts associated with that skill.
Who it’s for
Developers building agents with Pydantic AI who need to manage a large library of specialized tasks and want to keep their prompts efficient and costs low.
Highlights
- Dynamic Loading: Agents can list, load, and execute skills on demand rather than having all instructions in the initial prompt.
- Flexible Storage: Skills can be defined as files on a disk, programmatically in Python, or loaded from remote registries like Git and S3.
- Detailed Toolset: Provides built-in tools for listing skills, loading instructions, reading resources, and running scripts.
- Granular Control: Supports including or excluding specific skills for different agents from a shared library.