pydantic-ai-skills

A standardized, composable framework for building and managing Agent Skills within the Pydantic AI ecosystem.

Agent Skills are modular collections of instructions, scripts, tools, and resources that enable AI agents to progressively discover, load, and execute specialized capabilities for domain-specific tasks.

This package implements the Agent Skills specification for Pydantic AI using a tool-calling approach, maintaining full compatibility with the specification while adapting the loading mechanism for Pydantic AI's architecture. It is also compatible with Anthropic's Agent Skills framework.

Features

• Progressive Disclosure - Load skill information only when needed, reducing token usage
• Anthropic-Compatible - Skills are structurally compatible with Anthropic's Agent Skills
• Type-Safe - Built with Python dataclasses and type hints
• Validation - Automatic validation of skill metadata and structure
• Multiple Directories - Load skills from multiple sources
• Security - Path traversal prevention and safe script execution