Content
88%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 strong, highly operational skill: fully executable commands with validation checkpoints, confirmation gating, and explicit recovery behavior across all three harnesses. The only weaknesses are mild redundancy in cross-harness warnings and a missed opportunity to split per-harness procedures into reference files rather than keeping ~200 lines inline.
Suggestions
Consolidate the repeated warning about not mapping Claude hook profiles onto Codex/Kimi into a single statement in the routing section, removing the near-duplicate sentences in the Codex and Kimi sections.
Move the per-harness procedures (Claude Code, Codex, Kimi) into one-level-deep reference files (e.g., references/claude-setup.md) and keep the routing table plus a short summary per harness in SKILL.md, so only the relevant procedure is loaded into context.
Merge the near-duplicate version-string guardrail sentences ('Reject unexpected version text instead of interpolating it into a shell command' and 'Never construct a shell command from Codex JSON values') into one shared security note.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence (no explanations of plugins, npx, or hooks basics), but the warning not to map Claude hook profiles onto other harnesses is stated three times ('Do not offer Claude scopes or map ECC's four Claude hook profiles onto Codex', 'do not ask the Claude four-profile hook question', 'Never claim that Claude's off | minimal | standard | strict profiles were applied to Codex') and the version-string guardrails near-duplicate each other. This matches 'efficient; minor instances... that could be trimmed' rather than 'every token earns its place'. | 4 / 5 |
Actionability | Every step has copy-paste-ready commands with enumerated placeholder values ('user | project | local', 'off | minimal | standard | strict'), explicit fallbacks when $CLAUDE_PLUGIN_ROOT is unavailable, exact Codex commands and an exact argument array, and full Kimi commands. Fully executable with the common cases covered, matching the top anchor rather than the 'minor gaps' anchor at 4. | 5 / 5 |
Workflow Clarity | Clear numbered sequence (inventory → collect exactly two choices → preview/confirm once → apply → verify) with explicit validation gates: 'Require a zero exit status and a setup result whose scope and hooks equal the selected values', an independent re-run of 'claude plugin list --json', 'Continue only when exactly one enabled ecc@ecc entry exists at the selected scope', and stop-and-report recovery for ambiguous states. Validation and error-recovery are explicit, so the destructive-operation cap does not apply. | 5 / 5 |
Progressive Disclosure | No bundle files exist, so everything is inline in one well-sectioned SKILL.md with a clear harness-routing header structure and coherent sections — good structure with easy navigation. However, the ~110-line Claude Code section (and the Codex/Kimi sections) could be split into one-level-deep per-harness reference files with routing kept in the overview, which is why this is 'minor organization gaps' rather than the 'content appropriately split' top anchor. It is clearly above the 'content that should be separate is inline' with weak structure described at 3. | 4 / 5 |
Total | 18 / 20 Passed |