pydantic-ai-skills
为Pydantic AI提供完整的技能包管理与执行能力。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pydantic-ai-skills。 它的用途是：为Pydantic AI提供完整的技能包管理与执行能力。 完整的 Skill 内容见：https://321skill.com/skills/pydantic-ai-skills/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我分析一下最近的arXiv上关于机器学习的三篇论文。”，它会先通过`list_skills`查看可用技能，然后`load_skill`加载‘文献搜索’技能，并根据技能指令，可能进一步`read_skill_resource`获取搜索指南，或`run_skill_script`执行一个抓取arXiv的脚本，最终整理出答案。
介绍
pydantic-ai-skills 是一个专为 Pydantic AI 框架设计的技能包管理库。它解决了开发者在构建AI智能体时，如何模块化、按需加载和管理复杂任务指令与资源的痛点。通过将技能定义为包含指令、参考文档和可执行脚本的文件夹，它实现了“渐进式披露”，智能体仅在需要时才加载完整技能细节，从而优化了提示词长度和Token消耗。
使用方式非常直观：开发者只需将技能文件夹放入指定目录，并通过 SkillsCapability 或 SkillsToolset 将其注入到智能体中。智能体随后会自动获得一个技能目录，并能通过四个核心工具（列出、加载技能、读取资源、运行脚本）来动态调用这些技能。
这个库非常适合使用Pydantic AI框架进行智能体开发的工程师、研究人员和全栈开发者，特别是那些需要智能体处理包含外部文档查询或脚本执行的复杂、专业化任务的场景。
建议在使用前详细阅读其文档，了解技能文件夹的标准结构（必须包含SKILL.md）。对于仅需基础指令注入的简单场景，可以考虑使用Pydantic AI Harness内置的轻量级技能功能。
核心特点
与Pydantic AI Harness内置的轻量级技能功能相比，本库实现了完整的技能包规范，支持技能内捆绑的参考文档读取和脚本执行，能够无缝运行遵循Anthropic技能仓库规范编写的技能，提供了远程注册、编程式技能定义和运行时重载等高级特性。
注意事项
仅适用于基于Pydantic AI框架开发的智能体，不适用于其他AI框架或直接调用大模型API的场景。
常见问题
pydantic-ai-skills 和 pydantic-ai-harness 里的 Skills 有什么区别？
harness的Skills是基础指令注入器，不处理技能包内的文件和脚本。本库是完整实现，支持资源文件、脚本执行和更多高级功能。
如何创建一个新的技能？
创建一个文件夹，其中必须包含一个带有YAML头信息和Markdown指令的SKILL.md文件，并可选择性添加REFERENCE.md、scripts和resources目录。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pydantic-ai-skills/raw/index.md 读取 pydantic-ai-skills 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pydantic-ai-skills/raw/index.md（查看排版版本）