Content
67%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.
The body is an efficient, copy-paste-ready setup guide with genuine validation checkpoints and error-recovery guidance for installation failures. Its main weakness is that the skill's stated purpose — controlling the device — is never demonstrated with a concrete command; only install, verification, and inspection commands appear, and the live-mode build instruction is underspecified.
Suggestions
Add one concrete control example (e.g., the CLI command that invokes a callable capability from 'capabilities --json' output) so the core task is executable, not just setup.
Replace 'build with -tags ble_live' with the actual build command (module path and output binary) or reference where the source is obtained.
Give the inspection/live-mode paragraph its own section header (e.g., '## Inspecting capabilities and live mode') so the operational guidance is not dangling after the prerequisites section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and command-driven with no explanation of concepts Claude already knows — install command, verify step, PATH guidance, and inspection commands each earn their tokens. Minor trims are possible (e.g., the dense final paragraph bundling capabilities, status, live-mode, and session-IPC notes), so it fits 'Efficient; minor instances of over-explanation that could be trimmed' rather than anchor 5's every-token-counts ideal. | 4 / 5 |
Actionability | Setup and inspection are concretely executable ('npx -y @mvanhorn/printing-press-library install ble-opaque-binary --cli-only', 'ble-opaque-binary-pp-cli --version', 'capabilities --json', 'status --json', 'doctor', 'scan --live'), and it even specifies install directories per OS. However, the skill's core purpose — controlling the device — has no example invocation, and 'build with -tags ble_live' is a hint, not an executable command. Missing key details for the main task fits 'Some concrete guidance but incomplete'. | 3 / 5 |
Workflow Clarity | The install-verify workflow is well sequenced with an explicit validation checkpoint ('Verify: ble-opaque-binary-pp-cli --version', 'Do not proceed with skill commands until verification succeeds') and feedback loops for two failure modes (npx failure fallback; PATH 'command not found' remedy). It sits at anchor 4 rather than 5 because the sequence from setup to actually operating the device is left implicit. | 4 / 5 |
Progressive Disclosure | At ~17 lines with no external files needed (no references/, scripts/, or assets/ exist in the bundle), this is a simple single-file skill that could merit a 5 under the simple-skill note. It lands at 4 because the usage/live-mode paragraph sits outside any section header — the body has only '## Prerequisites: Install the CLI', leaving the operational commands unsectioned. | 4 / 5 |
Total | 15 / 20 Passed |