Content
65%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 dense, disciplined instruction-only skill: it assumes the reader's competence, gives concrete per-file-type standards and decision procedures, and structures its references one level deep. Its main weaknesses are that the examples and rewrite workflow it depends on are not shipped in this bundle, breaking most of its links and leaving the core rewrite procedure external, plus minor repetition between the layout table and the per-file-type sections.
Suggestions
Ship the referenced bundle files (examples/ directory, workflows/rewrite.md) or inline the minimal rewrite steps so every link resolves; the body currently directs the reader to files that are not present.
Inline a short, explicit rewrite workflow with validation checkpoints (verify each claim, stop on unread source, owner approval for departures) rather than delegating entirely to the missing workflows/rewrite.md.
Remove the duplication between the § Layout table's reader/holds columns and the "Read by..." lines in § Per file type, honoring the skill's own rule to "State each fact once. Point at the first statement instead of repeating it."
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and rule-per-line ("Write short sentences. Put one idea in each sentence.", "Delete sales language, quips, metaphors, and hedges.") and explains nothing Claude already knows; every contrast table teaches a rule. It falls short of anchor 5 only through minor repetition: the Layout table's reader/holds columns restate the "Read by..." lines of the § Per file type sections. | 4 / 5 |
Actionability | Concrete, specific guidance throughout: an ordered eight-section README structure, per-type "Never:" lists, a numbered stop-at-first-yes decision tree in "One home per fact", and named tools ("decisions search", "kendex apply"). Not anchor 5 because the worked examples it directs the reader to read first ("read it before writing one", 12+ links to examples/) are absent from the bundle, so that step cannot be executed as shipped. | 4 / 5 |
Workflow Clarity | The multi-step rewrite process is sequenced at a high level ("follows workflows/rewrite.md at the scope asked for... extracts what is unique, then writes each file in scope from a blank page") with a verification rule ("verifies each claim against its owning source", "An unread source leaves verification unresolved") and an owner-approval gate for departures. Not anchor 5 because the step-by-step procedure itself, including error-recovery checkpoints for a batch rewrite, lives in workflows/rewrite.md, which is not present in this bundle, leaving the in-body checkpoints implicit. | 4 / 5 |
Progressive Disclosure | The link structure is well designed: one level deep, per-section, clearly signaled ("Example: [examples/readme.md](examples/readme.md)", [workflows/rewrite.md](workflows/rewrite.md), [references/assistant-home.md](references/assistant-home.md)). But scored against the actual bundle, only references/assistant-home.md exists; examples/ (12+ links), workflows/rewrite.md, and ../decider/SKILL.md are missing, so most navigation does not resolve — violating the skill's own rule that "Relative links in Markdown must resolve." Anchor 3 (structure present, but organization undermined by unresolved references) rather than 4. | 3 / 5 |
Total | 15 / 20 Passed |