用途：按 agentskills.io 规范做结构化合规校验，面向新建技能结构与已有技能的审计和修复。内容质量与知识传递请改用 skill-creator-v2。
主要能力：
- 创建：选择小写 kebab-case 名称（1–64 字符），mkdir -p skill-name/references，写含 name 与 description 的 YAML frontmatter，正文用祈使句且少于 500 行，把细节拆到 references/，脚本放 scripts/，最后运行 skills-ref validate ./skill-name 或走校验清单。
- 审计：核对必填字段、字符限制、命名规则，排查非法 frontmatter 字段，确认目录结构仅允许 scripts/、references/、assets/，扫描非标准顶层文件，统计 SKILL.md 行数，评估 description 质量与渐进式披露，检查脚本接口，输出带严重级别与修复建议的报告。
- 修复常见问题：非规范字段移入 metadata 或删除；名称与目录不一致需改名；allowed-tools 须从 YAML 数组改为空格分隔字符串；脚本不得有交互式提示，改用 CLI 标志/stdin；超过 500 行拆到 references/；删除 README/LICENSE/CHANGELOG；把 rules/ 等重命名为 references/ 或 assets/；补充具体触发词。
用法：安装用 uv tool install skills-ref 或 pip install skills-ref；校验用 skills-ref validate ./my-skill，读取属性用 skills-ref read-properties ./my-skill。无工具时按 validation-checklist.md 手工走查。
限制：规范只强制 name 与 description；合规不等于内容优秀。allowed-tools 为实验性。完整规则以 agentskills.io 规范为准。具体收费与平台信息暂未提供。