用途：创建或现代化技能包（skill bundle），把可移植核心与运行时扩展分离，并提供本仓库的双运行时、目录、图与组合规则。通用脚手架与评测机制建议使用 Agent Skills 开放规范及标准 skill-creator。
主要能力：脚手架技能、修复技能列表被截断或遗漏、审计技能、选择支持文件边界、添加运行时专属元数据、测试触发与导航行为、维护 Claude 专属行为、跨运行时发布、决定用技能还是智能体。
核心约定：可移植基线要求 skill-name/SKILL.md 含明确 name 与触发丰富的 description；license、compatibility、metadata 为可移植可选字段；allowed-tools 属开放规范但运行时支持可能不同。正文聚焦选择、工作流、完成标准与导航，细节放 references/，确定性辅助放 scripts/，模板放 assets/。技能包需可单独复制使用，每个支持文件都要从工作流或导航链接。运行时扩展字段须对照当前官方文档核实，依赖运行时专属行为时在 compatibility 中注明目标运行时。
工作流：先写两三个具体用户任务（含不应触发的邻近案例）；创建前搜索图与现有技能包，已有能力则扩展；搭建可移植核心；选择目标运行时并只加已验证元数据；拆分支持文件并链接；运行静态检查及触发、非触发、导航、运行时评测；正文或路由变化时重建并校验图与评测清单；检查 diff 并修复失败；记录路由行为。完成声明需注明证据级别：静态校验、运行时加载、观察到的路由或任务质量评测。validate_skill.py 通过只证明结构与本地链接，不证明运行时加载、选择或答案更好。
设计规则：共享技能默认采用务实、结果导向的参考风格；description 需能从真实用户语言中选中，约 120–180 字符、25 词以内；路由与组合工作流建模为显式阶段；不得让富化静默丢弃候选或证据；相邻候选独立评估；不要为适配发现列表而压缩有用正文；无复现对照、带日期证据与披露限制时不得发布模型质量或省 token 数字。
导航资源：skill-context-budgets.md、maintenance-workflows.md、frontmatter-reference.md、skill-patterns.md、skill-validation.md、anthropic-skills-guide.md、dual-distribution.md、skill-vs-agent-decision.md、data/sources.json。脚本：scripts/validate_skill.py、validate_catalog.py、audit_skill_metadata.py、build_skill_graph.py、test_validate_skill.py。相关技能：agents-subagents、agents-hooks、agents-mcp。
限制：外部事实、字段语义、运行时限制、打包行为、已知缺陷与版本特定变通须对照一手来源核实；无法核实时说明并标记未验证。具体收费、价格、平台支持范围等资料暂未提供。