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.
An exemplary instruction-only skill: dense with executable tool-specific commands, a clearly sequenced workflow with a user-confirmation checkpoint and structured error-recovery guidance, and no wasted tokens. The absence of code examples is appropriate for a CLI-driven task and the guidance is fully actionable without them.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line carries tool-specific facts Claude cannot know (`repowise config` subcommands and flags, the `--format json` output shape, the refusal error taxonomy) with zero explanation of generic concepts and no padding. This matches "every token earns its place"; there is nothing to trim without losing information. | 5 / 5 |
Actionability | Provides executable commands with flags and arguments (`repowise config list --changed`, `explain <key> --format json`, `set <key> <value>`), exact value formats ("A switch takes `true`/`false`, a list takes `a,b` or `[a, b]`"), the JSON field list, and per-error remediation (`invalid_value` — "`accepts` says what fits"). Fully copy-paste-ready instruction covering the common cases. | 5 / 5 |
Workflow Clarity | A clear Inspect → Recommend → Change sequence with numbered steps, explicit checkpoints ("Ask the user first, naming the key, the new value and the effect. Never change a setting on your own initiative"), and feedback loops for error recovery (refusals exit 1 with structured errors whose messages steer the fix). Validation is built in via `set` validating the value. | 5 / 5 |
Progressive Disclosure | A single-command, single-task skill with no external references needed: all content is appropriately inline and organized under scannable headers (When to use it, Inspect, Recommend, Change). Nothing that belongs in a separate file is inlined, satisfying the simple-skill exception for well-organized sections. | 5 / 5 |
Total | 20 / 20 Passed |