Content
86%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 exemplar of a lean, single-purpose skill: minimal setup steps, exact config, and one copy-paste usage command with a Windows variant. The only real gaps are the absence of an explicit install-verification step and reliance on a wrapper script and {baseDir} placeholder that are not visible in the bundle.
Suggestions
Add a one-line post-install verification, e.g. "ls \"$SHERPA_ONNX_MODEL_DIR\"/*.onnx" or a quick smoke test, so failures surface before first real use.
State what the wrapper script does (or inline its command) since {baseDir}/bin/sherpa-onnx-tts is referenced but not present in the bundle.
Clarify what --tokens-file and --data-dir defaults are, so overriding them is actionable rather than guesswork.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean throughout: "Local TTS using the sherpa-onnx offline CLI" opens with a one-line scope, install is two numbered steps, the config is a tight JSON5 snippet, and the usage section is a single runnable command plus four short notes. Nothing explains concepts Claude already knows (no "what is TTS", no library background), and every section earns its tokens — matching anchor 5 ("Lean and efficient; assumes Claude's competence"). | 5 / 5 |
Actionability | Concrete, executable guidance: an exact config snippet for openclaw.json, "export PATH=\"{baseDir}/bin:$PATH\"", and a copy-paste-ready command "bin/sherpa-onnx-tts -o ./tts.wav \"Hello from local TTS.\"" with a platform-specific Windows variant. Falls short of anchor 5 because the commands rely on the {baseDir} placeholder and a wrapper ("The wrapper lives in this skill folder") that is not visible in the provided bundle, and there is no command to verify the install succeeded (e.g. checking that the model dir resolved) before first use. | 4 / 5 |
Workflow Clarity | Clear sequence: download runtime, download model, set env vars in config, optionally add to PATH, run the usage example. Each install step states its expected extraction directory ("extracts into ~/.openclaw/tools/sherpa-onnx-tts/runtime"), and the usage command doubles as an implicit end-to-end test. It sits at anchor 4 ("Clear sequence with most checkpoints present; minor validation gaps") rather than 5 because there is no explicit checkpoint confirming the env vars resolve or that the output .wav was produced, and the troubleshooting notes are hints rather than a validate-then-retry loop. | 4 / 5 |
Progressive Disclosure | The body is under 50 lines with no external reference files needed, organized into clean ## Install and ## Usage sections plus a short Notes list; per the rubric's simple-skill guidance this earns a 5. The one referenced path, {baseDir}/bin/sherpa-onnx-tts, is clearly signaled as the wrapper entry point, and the 'pick a different model' note correctly points to the external tts-models release rather than inlining a model catalog. | 5 / 5 |
Total | 18 / 20 Passed |