Content
80%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is lean, non-padded, and highly actionable with concrete paths, example phrasings, and an ADR gate, but its session guidance reads as behavioral tips rather than a checkpointed workflow, and the two referenced format files do not exist in the bundle.
Suggestions
Provide the referenced CONTEXT-FORMAT.md and ADR-FORMAT.md files (or inline the formats), since both links currently resolve to nonexistent files.
Reframe the 'During the session' guidance as an explicit sequenced workflow with validation checkpoints (e.g., verify glossary consistency after each update) to lift workflow clarity.
Tighten the opening paragraph's defensive clarification about merely reading CONTEXT.md, which adds length without actionable value.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — it never explains what a domain model or ADR is — with every section earning its place; the brief opening clarification nudges but does not cross into verbosity, matching the level-3 anchor. | 3 / 3 |
Actionability | It gives concrete file paths (CONTEXT.md, docs/adr/, CONTEXT-MAP.md), copy-ready dialogue examples ('Your glossary defines "cancellation" as X, but you seem to mean Y'), and a specific 3-criteria ADR gate; for an instruction-only skill this is concrete and actionable per the rubric's code-vs-instruction note. | 3 / 3 |
Workflow Clarity | The 'During the session' subsections are sequenced (challenge → sharpen → discuss → cross-reference → update inline → offer ADRs) and the ADR criteria act as a gate, but the steps are behavioral guidelines rather than a hardened process with explicit validation checkpoints, matching the level-2 anchor. | 2 / 3 |
Progressive Disclosure | The body is well-sectioned and signals one-level-deep references via '使用 [CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md) 中的格式' and [ADR-FORMAT.md](./ADR-FORMAT.md), but neither referenced file exists in the bundle, so the disclosure leads to dead links rather than detail, which keeps it below level 3. | 2 / 3 |
Total | 10 / 12 Passed |