Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is admirably concise and mostly actionable, with a clear install→config→usage flow. Its main gaps are non-literal '{baseDir}' placeholders, absent validation steps, and a referenced wrapper script that is not actually bundled.
Suggestions
Replace '{baseDir}' placeholders with a concrete note on how to resolve the skill directory, or show an explicit resolved example, so commands are copy-paste ready.
Add a verification step after install (e.g., 'confirm runtime/ sherpa-onnx-offline-tts exists and models/ contains the .onnx file') to close the workflow gap.
Either include the referenced bin/sherpa-onnx-tts wrapper as a bundled scripts/ file or remove/clarify the reference so progressive disclosure is not left dangling.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: brief install steps, a necessary json5 config snippet, a PATH export, one usage command, and a few tight notes — it assumes Claude's competence and does not explain what TTS or sherpa-onnx is. | 3 / 3 |
Actionability | Provides a usage command and a concrete config block, but examples use a '{baseDir}' placeholder rather than copy-paste-ready paths, and the actual runtime/model download commands are not given in the body (they live in frontmatter metadata). | 2 / 3 |
Workflow Clarity | Install is a clearly numbered two-step sequence followed by config, but there are no validation checkpoints (e.g., verify the runtime binary exists or the model dir is correct), so it sits at 'steps present, checkpoints missing'. | 2 / 3 |
Progressive Disclosure | Sections are well organized and the file is short, but the body references a wrapper at '{baseDir}/bin/sherpa-onnx-tts' that is not present as a bundle file, leaving a dangling, unclearly-signaled reference. | 2 / 3 |
Total | 9 / 12 Passed |