Content
100%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, concise, and actionable skill body that indexes into per-language references, provides executable commands and a complete config schema, and includes explicit validation and error-recovery steps in its workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean body with no concept primers (no 'what is an LSP'), tight runnable code blocks, and functional navigation tables; every token earns its place and Claude's competence is assumed. | 5 / 5 |
Actionability | Provides copy-paste-ready commands (detect-lsp.ts, verify-lsp.ts, command -v), a complete config JSON schema with annotated fields, and concrete config-loader rules covering the common cases. | 5 / 5 |
Workflow Clarity | Explicit Detect→Install→Configure→Verify sequence with a real validation checkpoint (verify-lsp roundtrip) and an error-recovery feedback loop ('FAIL: language server not installed = go back to step 2') with OK/FAIL/SKIP decoding. | 5 / 5 |
Progressive Disclosure | SKILL.md is an overview/index routing by file extension to one-level-deep, real references/<lang>/README.md files plus a Scripts table; navigation is clearly signaled and the bundle structure matches the references. | 5 / 5 |
Total | 20 / 20 Passed |