v1.4.0

What's Changed

• Update AGENTS.md by @DougTrajano in #64
• chore: upstream watch 2026-08-01 (no changes needed) by @DougTrajano in #66
• chore: upstream watch 2026-08-07 (no changes needed) by @DougTrajano in #67
• chore: upstream watch 2026-08-14 (no changes needed) by @DougTrajano in #68
• feat: add SkillScriptExecutor protocol and sandbox executor examples by @DougTrajano in #69
• fix: derive release version from the git tag instead of pushing to main by @DougTrajano in #70

Full Changelog: 1.3.0...1.4.0

v1.3.0

What's Changed

• Add example with Pydantic AI Gateway/Logfire and Ollama Cloud Models by @DougTrajano in #56
• build(deps-dev): update uvicorn requirement from <0.47.0,>=0.46.0 to >=0.46.0,<0.52.0 by @dependabot[bot] in #57
• build(deps-dev): update datasets requirement from <5.0.0,>=4.8.0 to >=4.8.0,<6.0.0 by @dependabot[bot] in #58
• build(deps-dev): update ruff requirement from <0.16.0,>=0.15.0 to >=0.15.0,<0.17.0 by @dependabot[bot] in #59
• build(deps-dev): update arxiv requirement from <4.0.0,>=3.0.0 to >=3.0.0,<5.0.0 by @dependabot[bot] in #60
• Add include/exclude skill selection; fix strict docs build by @DougTrajano in #61
• Rewrite README to be concise and link to the docs site by @DougTrajano in #62

New Contributors

• @dependabot[bot] made their first contribution in #57

Full Changelog: 1.2.0...1.3.0

v1.2.0

What's Changed

• feat: discover all readable text files as skill resources (added exclude_resources arg (#54) by @DougTrajano in #55

Full Changelog: 1.1.0...1.2.0

v1.1.0

What's Changed

• feat: support agent specs for SkillsCapability by @DougTrajano in #53

Full Changelog: 1.0.0...1.1.0

v1.0.0

v1.0.0 — First stable release 🎉

pydantic-ai-skills has been stable and in production use for several months. This release marks the official v1.0.0, signaling a committed, stable public API. It also brings the package fully in line with Pydantic AI v2 (capabilities-first/harness design) while keeping support for the v1 line back to 1.105.

Highlights

• Pydantic AI v2 ready. Verified against pydantic-ai 1.105.0, 2.0.0, and latest in CI. SkillsCapability integrates cleanly with the v2 capabilities=[...] API.
• Deferred capability loading. SkillsCapability now supports defer_loading=True (with a stable id and optional description), so the entire skills system can stay hidden behind the agent's load_capability tool until the model needs it. Useful for agents that bundle many capabilities. When deferred, the catalog entry is auto-summarized from the available skill names, overridable via description.

Changed

• Minimum supported pydantic-ai raised to pydantic-ai-slim>=1.105 (where on-demand / deferred capability loading was introduced). ⚠️ Breaking for environments pinned below 1.105.
• Switched internal RunContext usage to the public pydantic_ai.RunContext import.

Fixed

• Corrected from pydantic_ai.toolsets.skills import ... → pydantic_ai_skills across 44 docstring/doc examples (the old module path does not exist and would fail on copy-paste).

Internal

• Added a compatibility smoke test guarding the remaining private pydantic-ai internals (_griffe, _function_schema, _utils) so future upstream changes fail loudly in CI.
• Expanded the CI test matrix with a pydantic-ai-version axis (1.105.0, 2.0.0, latest).

What's Changed

• docs: add guide for hooks around skill loading by @DougTrajano in #50
• feat: adopt Pydantic AI v2 capabilities API [DEV-1215] by @DougTrajano in #52

Full Changelog: 0.11.0...1.0.0

v0.11.0

What's Changed

• feat: add S3SkillsRegistry for S3 and S3-compatible storage by @DougTrajano in #48

Full Changelog: 0.10.1...0.11.0

v0.10.1

What's Changed

• feat: coerce JSON string args to dict in run_skill_script by @MateEggDeHome in #46

New Contributors

• @MateEggDeHome made their first contribution in #46

Full Changelog: 0.10.0...0.10.1

v0.10.0

What's Changed

• feat(DEV-1194): replace SkillException hierarchy with ModelRetry + stdlib exceptions by @DougTrajano in #44

Full Changelog: 0.9.0...0.10.0

v0.9.0

What's Changed

• DEV-1192: drop pre-1.74 pydantic-ai compatibility shims by @DougTrajano in #41
• DEV-1193: add Skill.from_file() classmethod by @DougTrajano in #42

Full Changelog: 0.8.0...0.9.0

v0.8.0

What's Changed

• Added env_vars and context_env_vars_extractor in the LocalSkillScriptExecutor() to inject variables into file system scripts by @DougTrajano in #39
• Added documentation for debugging skill scripts by @DougTrajano in #40

Full Changelog: 0.7.0...0.8.0