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-structured, highly actionable instruction skill with an exemplary phased workflow and explicit verification steps. Its weaknesses are the dangling reference to a nonexistent quota-limit-style-guide.md file, the large inlined style guide that could live in references/, and minor redundancy and self-inconsistency (the body uses 'e.g.' while its own rules forbid it).
Suggestions
Add the missing `quota-limit-style-guide.md` to `references/` (or remove the pointer) — the body directs the reader to a resource file that does not exist in the bundle.
Move the ~120-line Phase 1 style guide into a `references/style-guide.md` file and keep a short summary of the highest-impact rules in SKILL.md.
Fix internal inconsistencies: the grammatically broken 'Adhering to these principles...' opening line and the body's own use of 'e.g.' / 'foo' examples that violate the skill's abbreviation and placeholder rules.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a dense, mostly project-specific style guide (prettier-ignore placement, relative-link rules, callout syntax, Gemini CLI naming) — exactly what Claude does not already know — with concrete inline examples rather than padding. Minor over-explanation of basic grammar mechanics (serial comma, 'Address the reader as "you"') and slight redundancy (callout formatting stated in both 'Formatting and syntax' and 'Structure') keep it below anchor 5 but well above the verbose anchors. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: exact prettier-ignore comment syntax for .md and .mdx, a literal callout example, specific file paths (`docs/sidebar.json`, `packages/`, `CONTRIBUTING.md`), and the `npm run format` / `npm install` recovery step. Not a 5 because it directs the reader to a `quota-limit-style-guide.md` resource file that does not exist in the bundle, and the named tools `replace`/`write_file` are not the actual file-editing tool names — minor gaps in an otherwise executable instruction set. | 4 / 5 |
Workflow Clarity | Four clearly sequenced phases (standards → preparation → execution → verification), with numbered sub-steps in Phase 2 (clarify, investigate, audit, connect, plan) and a dedicated Phase 4 verification: accuracy check, self-review, link check, and a format step with an explicit error-recovery loop ('If `npm run format` fails... run `npm install` first'). This matches anchor 5's clear sequence, explicit validation steps, and feedback loops for error recovery. | 5 / 5 |
Progressive Disclosure | The bundle has one reference file (`references/docs-auditing.md`) and it is properly signaled with a markdown link from Phase 2 step 6 — but the body also points to a `quota-limit-style-guide.md` 'resource file' that does not exist anywhere in the bundle, and ~120 lines of style-guide standards are inlined in SKILL.md rather than split out. Broken navigation plus inline content that belongs in a reference file matches anchor 3 ('references present but not clearly signaled; content that should be separate is inline') better than anchor 4's 'minor organization gaps'. | 3 / 5 |
Total | 16 / 20 Passed |