Content
86%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 ruleset skill: the body carries only compact actionable directives, externalizes the full rule bodies one level deep with a clear resolution order, and every instruction is concrete down to specific banned phrases and executable commands. The only trims needed are the maintainer-facing Updating section and a small piece of loader meta-commentary.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: 21 one-line directives with concrete banned phrases, no explanations of concepts Claude already knows. Minor trimmable content remains — the maintainer-facing 'Updating' section (~8 lines) and the meta note 'Frontmatter metadata is scanned eagerly at session start' do not serve the invoking agent. This is anchor 4 (efficient, minor instances that could be trimmed), not anchor 5, and well above anchor 3. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully concrete: each rule pairs a directive with specific tokens ('in order to', 'pushes the boundaries', 'use' over 'leverage', 'proves' vs 'suggests'); the handshake gives a verbatim reply string; the CLI path is executable ('uv tool install agent-style', 'agent-style audit FILE'); and the reference resolution order names real paths. Matches anchor 5 — copy-paste-ready, specific direction covering the common cases. | 5 / 5 |
Workflow Clarity | A simple single-purpose skill whose core action (apply the 21 rules when revising prose) is unambiguous, with a clearly sequenced 3-step resolution order for locating full rule bodies (project root → vendored snapshot → upstream). It falls short of anchor 5 because it never says when the compact directives suffice versus when to consult the full rule bodies in references/RULES.md. No destructive or batch operations, so no validation cap applies. | 4 / 5 |
Progressive Disclosure | The body is a compact overview while the 814-line full rule set is appropriately externalized to references/RULES.md (verified to exist), alongside UPSTREAM-PIN, NOTICE.md, and LICENSES/CC-BY-4.0.txt — all real, one level deep, and clearly signaled with an explicit resolution order. The one out-of-bundle path (scripts/update-upstream.sh) is explicitly scoped to the plugin root as maintainer context, not navigation, so it does not break the structure. Matches anchor 5. | 5 / 5 |
Total | 18 / 20 Passed |