Content
77%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-engineered writing skill: the two-phase workflow is unambiguous, validation is built into every gate, and the guidance is concrete enough to execute without guesswork. The costs are duplication between prose sections and the red-flags table, and a monolithic ~360-line body whose more specialized material (the tabs spec, including what look like project-specific Tanstack package lines) would be better split into reference files.
Suggestions
Deduplicate: keep the Forbidden section or the red-flags table for each rule (em dashes, neighbor matching, history leak), not both, cutting the body by roughly a third without losing any rule.
Move the package-manager tabs specification (block syntax, mode rules, framework lines) into a references file such as references/package-manager-tabs.md and leave a one-line pointer plus the core rule (never stack npm/pnpm/yarn in one fence) in SKILL.md.
Generalize or remove the Tanstack-specific install lines (@tanstack/ai-*) which look like leftovers from a particular docs site and add tokens irrelevant to most invocations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly rule-dense and efficient, but there is real duplication: the em-dash ban appears in Forbidden, again in the red-flags table, and again in the neighbor-matching section; the neighbor-matching caveat is stated twice; and the 27-row red-flags table restates body rules nearly verbatim. This fits 'mostly efficient but could be tightened' rather than 4, where trimming would be minor, though it never degenerates into padding that would justify 2. | 3 / 5 |
Actionability | For an instruction-only skill the guidance is maximally concrete: an exact docs-folder search order (docs/, documentation/, content/docs/, site/, website/docs/), a complete copy-paste tab component example with exact mode names, bad/good example pairs for openers, lists, and history-leak, and a mechanical pre-done self-check (search added text for the forbidden glyphs, then run the simple-english self-check). Specific examples cover the common cases, matching the top anchor. | 5 / 5 |
Workflow Clarity | The multi-step process is explicitly sequenced: a flow diagram, a gating precondition for Phase 2 ("Do not write page content until you have stated the readers and the tone, and simple-english plus i-have-adhd are loaded"), a Phase 1 validation step ("Check every reader has a path"), an error path ("If either file is missing, stop and tell the user"), and pre-done checks with a fix-and-retry loop for surviving glyph hits. The red-flags table doubles as a checklist, matching the anchor for clear sequence with explicit validation and feedback loops. | 5 / 5 |
Progressive Disclosure | The single SKILL.md runs ~360 lines with no bundle files and no references; it is well-sectioned (so not a 2) but content that plausibly belongs in separate reference files is inlined, notably the detailed package-manager tabs specification and the long red-flags table. This fits 'some structure but could be better organized; content that should be separate is inline' rather than 4, where placement would be mostly appropriate. | 3 / 5 |
Total | 16 / 20 Passed |