Content
81%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 highly actionable, clearly sequenced writing-process skill with explicit validation checkpoints and no padding from known-concept explanations. Its weaknesses are duplication (the red-flags table and two overlapping history-leak sections) and an all-in-one ~360-line file where some reference material could be split out.
Suggestions
Trim the red-flags table to entries not already stated verbatim in earlier sections, or merge it with the Forbidden section to remove the duplicate rules.
Merge "Write for the reader, not the history" and "Don't leak the build process" into one section, since both enforce the same no-history-leak principle with overlapping examples.
Move the package-manager tabs template and its framework package lines into a reference file (e.g. references/package-manager-tabs.md) and link to it from the body to slim the main file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly dense, earned rules with no filler explanations of known concepts, but the ~25-row red-flags table restates rules verbatim from earlier sections (em dash, match-neighbors, history leak, install tabs), and "Write for the reader, not the history" and "Don't leak the build process" cover substantially overlapping ground. This matches "mostly efficient but could be tightened" better than the minor-trim anchor 4. | 3 / 5 |
Actionability | Fully executable instruction-level guidance: exact docs-folder search paths, a copy-paste package-manager tabs template with real framework package lines, concrete bad/good rewrite pairs, an exact self-check (search added text for the forbidden glyphs), and hard failure handling (stop if simple-english or i-have-adhd is missing). | 5 / 5 |
Workflow Clarity | The two-phase workflow is explicitly sequenced (flow diagram, three run moments, numbered find-docs and Phase 1 steps), gated before writing (readers, tone, prerequisite skills loaded), and closed with explicit validation loops: glyph search -> fix -> re-search, the simple-english self-check, and stop-and-report on missing files. | 5 / 5 |
Progressive Disclosure | The single file is well-sectioned and easy to navigate, and references to the sibling skills are clearly signaled one level deep with exact paths. It falls short of anchor 5 because the ~30-line package-manager tabs data block is inlined reference material that could live in a separate file, and the skill carries everything in one ~360-line file with no bundle. | 4 / 5 |
Total | 17 / 20 Passed |