Agent Skills
› rohitg00/ai-engineering-from-scratch
› skill-contract-reviewer
skill-contract-reviewer
GitHub用于在Agent技能包实现前进行合同审查与验证。通过解析决策模型、运行检查脚本并比对任务形状，确保技能的便携性与合规性，最终输出验证报告及选定的最小可组合原语集合。
Trigger Scenarios
准备将工作流打包为可复用的Agent技能制品时
需要验证SKILL.md身份字段和契约合规性时
Install
npx skills add rohitg00/ai-engineering-from-scratch --skill skill-contract-reviewer -g -y
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_ROOTto the absolute directory containing this installedSKILL.md. Do not assume the process working directory is the bundle. - Set
TARGET_ROOTto the absolute original workspace working directory and resolve the proposed skill directory under that root. - Read
$SKILL_ROOT/references/contract.mdand validate the portableSKILL.mdidentity fields. - Read
$SKILL_ROOT/references/decision-model.mdand 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", whereTARGET_SKILLis the absolute proposed skill directory underTARGET_ROOT. - Inspect the JSON report. Fix every error before discussing host-specific extensions.
- Compare the proposed artifact with
$SKILL_ROOT/assets/task-shapes.jsonand 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.
Version History
- 39ea8a1 Current 2026-08-28 11:20
