skill-contract-reviewer
Validate an Agent Skill package and choose the right instruction, capability, or lifecycle primitive before implementation.
- License 许可
- MIT
- 最近更新
- 2026-10-01
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- 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.
02 资源文件 4
- 资产文件assets/task-shapes.json634 B
- 参考文档references/contract.md1.0 KB
- 参考文档references/decision-model.md1.0 KB
- 脚本scripts/check_skill.py6.9 KB
03 SKILL.md 正文
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.
04 同仓库更多 Skills
start-learning
One-time onboarding for the AI Engineering from Scratch curriculum (523 lessons, 20 phases). Interviews the learner, runs the placement quiz, and writes LEARNING.md, a persistent study plan the learn skill drives. Trigger phrases: "start learning", "set up the course", "begin the curriculum", "onboard me", "create my learning plan"
mcpa-certification
AI-native tutor and onboarding workflow for the MCPA (Model Context Protocol Associate) certification in AI Engineering from Scratch. Use when a learner wants to prepare for the MCPA, resume their certification path, learn the next lesson interactively, run and verify practical labs, take the diagnostic or a full mock, or remediate weak exam domains from GitHub with Claude Code, Codex, ChatGPT, Cursor, or another agent.
learn
Interactive lesson tutor for the AI Engineering from Scratch curriculum. Reads LEARNING.md, fetches the next lesson, teaches it section by section in the terminal, quizzes at the end, and records progress. Works cloned or entirely over raw.githubusercontent.com — no setup required. Trigger phrases: "next lesson", "teach me", "continue the course", "let's learn", "resume learning"
learn-mcp
Focused interactive tutor for the Model Context Protocol (MCP) path in AI Engineering from Scratch. Start or resume this route when a learner wants to build, secure, debug, verify, or operate MCP clients, servers, transports, gateways, registries, or conformance gates. Teaches one lesson per invocation and records wire evidence in MCP-LEARNING.md.
learn-agent-skills
Focused interactive tutor for the Agent Skills Engineering path in AI Engineering from Scratch. Start or resume this route when a learner wants to create, discover, invoke, secure, evaluate, package, or port Agent Skills. Teaches one lesson per invocation and records evidence in AGENT-SKILLS-LEARNING.md.
find-your-level
Interactive quiz that maps your AI/ML knowledge to a starting point in the 523-lesson, 20-phase AI Engineering from Scratch curriculum. Trigger phrases: "where should I start", "find my level", "what do I know", "which phase", "assess my knowledge", "placement test", "skip ahead"