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.
The skill is highly actionable with an exemplary step/checkpoint workflow, but it is a monolithic single file: the host-reference lookup tables should live in references/ files, and version-locked details (CLI version gates, model pricing) bloat the token budget and will age. Strengths are execution guidance and validation; weaknesses are conciseness and file structure.
Suggestions
Move the Claude Code and Codex host-reference sections (load precedence, frontmatter field table, Codex key table) into references/ files (e.g. references/claude-code.md, references/codex.md) and keep SKILL.md as an overview with clearly signaled one-level-deep links.
Trim time-sensitive specifics from the main flow — the v2.1.233 version gates and the Opus/Haiku per-million-token prices — or consolidate them into a single clearly marked version-sensitive note so they can be maintained in one place.
Shorten the illustrative audit report in Step 6 to the table skeleton only, cutting the fully worked per-agent example to reduce tokens without losing the format contract.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and factual (runtime skip rules, field tables, precedence), but includes unquarantined time-sensitive specifics — "v2.1.233 or later" (twice) and Opus 5.5 at $4/$20 / Haiku 5.5 at $0.10/$0.50 pricing — plus a long illustrative report block that could be trimmed. Mostly efficient yet noticeably tighten-able, so it sits at 3 rather than 4, and well above the padding of 2. | 3 / 5 |
Actionability | Provides copy-paste-ready commands (find -L .claude/agents -name "*.md", claude plugin validate .claude/agents, ctxharness doctor --format json), point-allocated scoring tables, and a complete report template. Fully executable guidance covering the common cases, matching the 5 anchor rather than the 4 anchor's "minor gaps". | 5 / 5 |
Workflow Clarity | Six clearly sequenced steps each end in an explicit "Done when:" checkpoint, with loadability validation in Step 2 (claude plugin validate), score thresholds in Step 4, and destructive deletion gated behind an explicit "yes, remove it" confirmation. This matches the 5 anchor (explicit validation steps, feedback loops, checklists); the 4 anchor's "minor validation gaps" does not apply. | 5 / 5 |
Progressive Disclosure | No bundle files exist and everything is inline in one ~250-line SKILL.md; the ~95-line host reference (load precedence, 18-field frontmatter table, Codex table) is reference material that belongs in a references/ file. In-file structure is good (clear headers and tables), so this is 3 ("content that should be separate is inline") rather than 2, but not 4 since no content is split out. | 3 / 5 |
Total | 16 / 20 Passed |