用途：repo2skill 面向“制造或评审一个技能”的任务，例如新建技能、搭建 SKILL.md、排查技能无法通过门禁、评审技能提示质量。它只负责单个技能目录与本仓库标准之间的循环；仓库整体的智能体安全审计、代码库声明核验、智能体循环设计属于其它技能。
主要能力：提供已通过门禁的骨架，引导在其上编写真实内容，并完成机械门无法执行的语义评审。门禁 make gate-skill SKILL=<dir> 会运行结构校验（SKILL.md 与 README.md、kebab 命名、描述长度、悬空引用、模板与 PARAMETERS.md 的双射）、密钥扫描、Prompting Playbook 的 PP-1 到 PP-7 检查、标准元数据检查、assets/ 下的单元测试套件，以及评估。门禁只验证“存在性”，内容实质由评审者按 references/semantic-review.md 逐一检查。
使用方式：先定位辅助脚本目录，用 SKILL_DIR=$(find ~/.claude ~/.config ~/.agents -type d -name 'repo2skill' 2>/dev/null | head -1) 查找并验证 assets 或 scripts 存在。运行 python3 "$SKILL_DIR/assets/scaffold_skill.py" <name> --dir <repo-root> 生成骨架，可用 --author、--version、--tags 参数；它拒绝非法名称与已存在目录。先用 make gate-skill SKILL=<name> 确认新骨架为绿，再按 references/authoring-guide.md 替换所有 TODO(repo2skill) 标记，每改一个文件就重跑门禁。随后按 references/semantic-review.md 做语义评审，最后从仓库根运行 make gate-skill SKILL=<name> 和 make gate，直到两者全绿且 grep -rn "TODO(repo2skill)" <name>/ 无输出。
限制：需要 Python 3.10 或更新版本，命令以 python3 书写；若 $SKILL_PYTHON 未设置，需在 macOS 上跳过安装桩并找到可用解释器。缺少 Python 时按技能自带降级方案处理，否则停止并告知用户。全部资料未提供收费、价格或平台要求等信息。