Content
71%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.
A well-structured, reference-backed body with a clear two-tier storage model, a numbered consumption protocol with a failure branch, and clean one-level progressive disclosure into six real reference files. The main weakness is redundancy — the two-tier rule and access-method details are restated across three sections — plus some abstract policy phrasing where concrete checks would be more actionable.
Suggestions
Merge the 'Single Source of Truth Rule' and 'Output Format' sections into the Storage Locations table area: both largely restate what the table already says, and the heading-level and label-preservation rules can be one short list.
State the access-method enumeration (URL, MCP name, file path, command) once — in the Storage Locations table — and have the Reference Protocol step 3 simply say 'use the access method declared in the project tier'.
Replace abstract policy phrases like 'verify them within current authority' and 'continue from governing and repository evidence' with a concrete example of one verification check and one fallback action, so downstream consumers know exactly what to do.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is compact and free of explanations of concepts Claude already knows, but the two-tier split is stated three times (the Storage Locations table, the "Single Source of Truth Rule" section, and the "Output Format" section), and access-method enumerations ("URL, MCP name, file path, command") repeat across the table and the Reference Protocol. This matches the 3 anchor (mostly efficient but could be tightened) rather than the 4 anchor's "minor instances". | 3 / 5 |
Actionability | Guidance is largely concrete and executable: exact paths (`docs/project-context/external-resources.md`), a fixed heading text ("External Resources Used"), a numbered reference protocol, and templates in `references/template.md` with literal markdown. Abstract policy phrasing such as "verify them within current authority" and "continue from governing and repository evidence" lacks concrete checks or examples, holding it below the fully executable 5 anchor. | 4 / 5 |
Workflow Clarity | The Reference Protocol is a clear 1-2-3 sequence with an explicit failure branch ("When the file is absent or the resource is unreachable, continue from governing and repository evidence. Each consumer records the limitation in its applicable output."), and capture/update flow is delegated to hearing.md's stepwise process. The update-on-environment-change path and the split between capturing and consuming could be more sharply checkpointed, so it sits at 4 rather than 5. | 4 / 5 |
Progressive Disclosure | The body is a well-organized ~45-line overview and every detail file is a real, one-hop reference, each annotated with its purpose ("Decision-specific capture and storage", "Frontend domain axes", etc.). Although hearing.md also links to the domain-cue files, those files are all directly listed in SKILL.md's References section, so no content is buried two levels deep — this matches the 5 anchor (clear overview, well-signaled one-level references, appropriate split). | 5 / 5 |
Total | 16 / 20 Passed |