Agent Skills › rohitg00/ai-engineering-from-scratch › skill-contract-reviewer

skill-contract-reviewer

GitHub

用于在 Agent Skill 打包发布前进行合规性审查。通过验证 SKILL.md 身份字段、运行检查脚本及对比任务形状，确保技能符合可移植契约标准并选择最小化原语组合。

phases/13-tools-and-protocols/22-skills-and-agent-sdks/outputs/skill-contract-reviewer/SKILL.md rohitg00/ai-engineering-from-scratch

Trigger Scenarios

Agent Skill 即将成为可复用工件时需要验证 SKILL.md 是否符合便携契约规范时

Install

npx skills add rohitg00/ai-engineering-from-scratch --skill skill-contract-reviewer -g -y

More Options

Non-standard path

npx skills add https://github.com/rohitg00/ai-engineering-from-scratch/tree/main/phases/13-tools-and-protocols/22-skills-and-agent-sdks/outputs/skill-contract-reviewer -g -y

Use without installing

npx skills use rohitg00/ai-engineering-from-scratch@skill-contract-reviewer

指定 Agent (Claude Code)

npx skills add rohitg00/ai-engineering-from-scratch --skill skill-contract-reviewer -a claude-code -g -y

安装 repo 全部 skill

npx skills add rohitg00/ai-engineering-from-scratch --all -g -y

预览 repo 内 skill

npx skills add rohitg00/ai-engineering-from-scratch --list

SKILL.md

Frontmatter

{
    "name": "skill-contract-reviewer",
    "license": "MIT",
    "metadata": {
        "lesson": "22"
    },
    "description": "Validate an Agent Skill package and choose the right instruction, capability, or lifecycle primitive before implementation."
}

Skill contract reviewer

Use this skill when a workflow is about to become a reusable agent artifact.

Set SKILL_ROOT to the absolute directory containing this installed SKILL.md. Do not assume the process working directory is the bundle.
Set TARGET_ROOT to the absolute original workspace working directory and resolve the proposed skill directory under that root.
Read $SKILL_ROOT/references/contract.md and validate the portable SKILL.md identity fields.
Read $SKILL_ROOT/references/decision-model.md and separate repository context, reusable method, external capability, lifecycle timing, deterministic logic, and isolated delegation.
Before execution, show the exact resolved argument vector. Run python3 "$SKILL_ROOT/scripts/check_skill.py" "$TARGET_SKILL", where TARGET_SKILL is the absolute proposed skill directory under TARGET_ROOT.
Inspect the JSON report. Fix every error before discussing host-specific extensions.
Compare the proposed artifact with $SKILL_ROOT/assets/task-shapes.json and return the smallest composable set of primitives.

Do not claim that a runtime extension is part of the portable contract. Do not treat a valid skill as permission to run scripts or access tools.

Return the validation report, the selected primitives, and one sentence explaining each selection. Include execution evidence with the resolved script path, resolved target path, cwd, exact argv, and exit code. If the host cannot expose one of those observations, mark it unverified instead of inventing it.