Skill1k repo starsupdated 6d ago

skill-contract-reviewer

Validate an Agent Skill package and choose the right instruction, capability, or lifecycle primitive before implementation.

View source Repository: ai-engineering-from-scratch-zh

Install in Claude Code

Copy

git clone --depth 1 https://github.com/fancyboi999/ai-engineering-from-scratch-zh /tmp/skill-contract-reviewer && cp -r /tmp/skill-contract-reviewer/phases/13-tools-and-protocols/22-skills-and-agent-sdks/outputs/skill-contract-reviewer ~/.claude/skills/skill-contract-reviewer

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# Skill 契约审查器

当工作流即将成为可复用的 agent 产物时，使用此 skill。

1. 将 `SKILL_ROOT` 设为包含本已安装 `SKILL.md` 的绝对目录。不要假定进程工作目录就是 Bundle。
2. 将 `TARGET_ROOT` 设为原始工作区的绝对工作目录，并在该根目录下解析候选 skill 目录。
3. 读取 `$SKILL_ROOT/references/contract.md`，验证可移植 `SKILL.md` 的标识字段。
4. 读取 `$SKILL_ROOT/references/decision-model.md`，区分仓库上下文、可复用方法、外部能力、生命周期时机、确定性逻辑和隔离委派。
5. 执行前展示精确解析后的参数向量。运行 `python3 "$SKILL_ROOT/scripts/check_skill.py" "$TARGET_SKILL"`，其中 `TARGET_SKILL` 是 `TARGET_ROOT` 下候选 skill 的绝对目录。
6. 检查 JSON 报告。讨论 host 专属扩展前，修复全部错误。
7. 将候选产物与 `$SKILL_ROOT/assets/task-shapes.json` 比较，返回最小可组合原语集合。

不要声称运行时扩展属于可移植契约。不要将有效 skill 视作运行脚本或访问工具的权限。

返回验证报告、所选原语和解释每项选择的一句话。附上执行证据：解析后的脚本路径、目标路径、cwd、精确 argv 与退出码。若 host 无法暴露其中某项观察，将其标为未验证，不要虚构。