Content
88%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a high-quality, actionable interview-orchestration skill with a clearly sequenced workflow, explicit validation checkpoints, and concrete tool/prompt/field guidance. Its main limitation is progressive disclosure: everything lives in one large file with no reference split, and a couple of preamble/example passages could be tightened.
Suggestions
Move the per-layer canonical entry shapes and Interview Guidance By Layer into a reference file (e.g. references/layers.md) linked from SKILL.md, so the main file is a lean overview with one-level-deep references.
Tighten the Purpose section by dropping the philosophical opener ("The first job is not to automate the user…") and lead with the concrete five-step job list.
Add one fully-populated canonical entry example (all 11 common fields plus a layer's details filled in) to make the entry contract copy-paste concrete.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes Claude's competence — it never explains basic concepts (what a decision or knowledge is) and keeps guidance task-specific, but the philosophical Purpose preamble ("The first job is not to automate the user…") and the long worked summary-thought example could be trimmed, so it sits at 4 rather than a lean 5. | 4 / 5 |
Actionability | Fully actionable for an instruction-only skill: it names exact tools (search_thoughts, capture_thought, start_operating_model_session, save_operating_model_layer, etc.), gives concrete interview prompts ("Walk me through a real Monday from the last two weeks."), specifies the full canonical entry field contract per layer, and provides worked checkpoint and summary-thought examples covering the common cases. | 5 / 5 |
Workflow Clarity | A clear four-phase sequence (Session Start → Layer Interview → Final Review → Export) with explicit validation checkpoints — per-layer confirmation before each save, a contradiction pass via query_operating_model, and a revise-and-resave feedback loop — plus checklists in the Non-Negotiable Rules and Canonical Entry Contract, matching the 5 anchor; the destructive/batch cap does not apply because validation is present. | 5 / 5 |
Progressive Disclosure | Well-organized with clear, purposeful section headers and easy in-file navigation, and self-containment is defensible for an interactive interview skill, but it is a ~280-line monolith with no external references and reference-like material (canonical contracts, per-layer guidance) kept inline, so it does not reach the split, one-level-deep-reference structure of the 5 anchor. | 4 / 5 |
Total | 18 / 20 Passed |