Content
92%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is lean, actionable, and built around a clearly sequenced, validated configuration workflow. The main weakness is progressive disclosure: the skill routes to @reference/*.md files that are not present in the bundle, so its otherwise-excellent navigation cannot be verified or followed.
Suggestions
Ship the referenced bundle files (references/providers.md, config.md, guide.md, commands.md, permissions.md, workflows.md) so the @reference routing actually resolves, or remove routes to files that do not exist.
If any routed reference is not yet authored, note it explicitly in the routing section rather than implying the file is available.
Consider whether the large feature-map table belongs inline in SKILL.md or would be better split into a one-level-deep reference file to tighten the overview further.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence — it never explains what a CLI/TUI/MCP/LSP is — and every section is task-relevant rather than padded with basics, fitting the lean-and-efficient anchor. | 3 / 3 |
Actionability | Gives concrete guidance: an exact config snippet, specific redaction keys ('apiKey', 'token', 'secret', 'password'), exact paths, and the rule to put 'provider/model' at the front of recent-model state — not abstract direction. | 3 / 3 |
Workflow Clarity | The 'Helping the User Configure' section is a 7-step numbered sequence ending in an explicit validation/checkpoint step ('Validate the parsed configuration with the narrowest relevant command and report the config ... files changed'), matching the clear-sequence-with-validation anchor. | 3 / 3 |
Progressive Disclosure | The 'Reference routing' section is excellently structured and clearly signals one-level-deep @reference/*.md files, but no references/ bundle directory exists, so the referenced files (providers.md, config.md, guide.md, etc.) cannot actually resolve. It is above the monolithic anchor but below 3 because the navigation points to missing files. | 2 / 3 |
Total | 11 / 12 Passed |