Content
85%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, well-sequenced audit workflow with almost no filler — the scoring rubric, report template, and per-step exit criteria are exemplary. The main weakness is structure: the skill is a single monolithic file whose host-reference material inflates token cost on every load instead of being split into one-level-deep reference files.
Suggestions
Move the Host reference section (Claude Code load precedence, silent-skip rules, frontmatter field table, model resolution, and the Codex schema table) into separate reference files such as references/claude-code-agents.md and references/codex-agents.md, keeping SKILL.md as a concise overview that links to them.
Deduplicate the `claude plugin validate` guidance (currently stated in both the Host reference and Step 2) — state it once and cross-reference it.
The model tier signal table and pricing figures are lookup material consulted only during scoring; move them next to the scoring criteria or into a reference file so Steps 1-6 read as a lean runbook.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and table-driven with almost no padding — nearly every line is host-specific runtime fact Claude cannot reliably know. Minor redundancy keeps it below a 5: the `claude plugin validate` advice ("v2.1.233 or later") and the strict-YAML portability warning each appear in both the Host reference and Step 2. | 4 / 5 |
Actionability | Fully executable throughout: copy-paste discovery commands (`find -L .claude/agents -name "*.md"`), a point-by-point scoring rubric with per-criterion point values, a complete report template, concrete edge cases with fixes, and per-step "Done when" exit criteria. | 5 / 5 |
Workflow Clarity | Steps 1-6 are clearly sequenced with explicit validation checkpoints (loadability via `claude plugin validate`, collision checks, "Done when" gates per step), a triage mode for >20 agents, and an explicit confirmation gate before file deletion — so the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | No bundle files exist; the ~90-line Host reference (load precedence, silent-skip rules, the full frontmatter field table, Codex schema) is inline lookup material that loads on every invocation and clearly belongs in separate reference files (e.g., references/claude-code.md, references/codex.md). Section headers give it structure, but content that should be separate is inlined. | 3 / 5 |
Total | 17 / 20 Passed |