Content
78%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 well-designed rename shim: lean, well-sectioned, with a genuinely actionable standalone fallback whose steps specify exactly what to record. Its only notable gap is the absence of a worked example of the intent brief it asks the agent to produce.
Suggestions
Add a compact example intent brief (3-5 lines) after the standalone steps so the expected output artifact is concrete rather than implied by its field list.
Fold the Source section's pointer into the opening redirect paragraph to remove the second reference to ../frame-intent/SKILL.md and shave a few tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The steps are dense and telegraphic ("with IDs, evidence for and against, confidence, and what would disprove them") with zero concept-explanation padding, but minor meta-redundancy — frame-intent is pointed to twice (intro and Source) and "Mention the new name once when useful" is trimmable — keeps it at anchor 4 rather than 5's 'every token earns its place'. | 4 / 5 |
Actionability | Field-level concrete guidance ("a measure, population, baseline, proposed target or threshold, source, owner, review timing, and what different results would change") makes the instruction-only skill genuinely executable, but no example intent brief is included, leaving a minor gap between anchor 4 and 5's 'specific examples cover the common cases'. | 4 / 5 |
Workflow Clarity | A clear 6-step sequence with an entry decision (sibling installed → redirect), a step-1 fallback ("Otherwise ask one or two consequential questions... and draft the usable parts provisionally"), a step-5 evidence-check branch, and step-6 quality gates ("Separate confirmed, inferred, proposed, and unknown claims; invent no evidence") — anchor 4, since there is no explicit re-check/error-recovery loop to reach anchor 5. | 4 / 5 |
Progressive Disclosure | An under-50-line skill with well-organized sections, one clearly signaled one-level-deep external reference, and a complete inline fallback explicitly justified for the sibling-absent case ("If only this directory was copied into a skill installation, the sibling may not exist. Use these essentials locally") — meets the simple-skill provision for anchor 5. | 5 / 5 |
Total | 17 / 20 Passed |