Content
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, concise skill that effectively catalogs AI writing tropes with specific examples. Its main weakness is the lack of concrete before/after rewrite examples that would show Claude how to fix detected tropes, not just identify them. The progressive disclosure design is sound but the referenced detail files are missing from the bundle.
Suggestions
Add 1-2 concrete before/after examples showing a trope-laden passage rewritten to be more natural, to improve actionability.
Integrate the Quick Self-Check into the workflow steps (e.g., 'Step 2: Run through the self-check questions') and add guidance for what to do if multiple passes are needed.
Provide the referenced files (references/word-choice.md, etc.) in the bundle, or inline the most critical content if the files won't be available.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. It doesn't explain what AI writing tropes are in abstract terms — it jumps straight to actionable categories and specific examples. Every section earns its place, and the 'Key offenders' lists provide concrete examples without over-explaining why they're problematic (Claude already knows). | 3 / 3 |
Actionability | The skill provides concrete examples of what to avoid (specific words, patterns, structures) and a useful self-check checklist, but it lacks concrete examples of rewrites — showing a 'before' trope-laden passage and an 'after' corrected version would make it fully actionable. The guidance is 'rewrite that passage' without demonstrating how. | 2 / 3 |
Workflow Clarity | The 4-step workflow (draft → check → rewrite → re-read for density) is clear and appropriately simple for this task. However, there's no explicit validation or feedback loop — for instance, no guidance on what to do if pattern density is still too high after one pass, or how to judge when the piece is 'clean enough.' The self-check list partially compensates but isn't integrated into the workflow steps. | 2 / 3 |
Progressive Disclosure | The structure is well-organized with clear references to six separate detail files (references/word-choice.md, etc.), which is excellent progressive disclosure design. However, no bundle files were provided, so the referenced files don't actually exist in the evaluated bundle, meaning the references are broken pointers. The inline 'Key offenders' summaries partially mitigate this by giving enough to act on without the referenced files. | 2 / 3 |
Total | 9 / 12 Passed |