Content
93%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 lean, highly actionable instruction-only skill body: exact tool names, commands, and parameter values with a well-sequenced workflow and an availability-check feedback loop. The only minor gap is a lack of concrete verification at the workflow's edges (attachment path resolution, empty-transcript handling).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line delivers non-obvious information Claude could not infer: the exact MCP tool name, that 'language: "auto"' is the only supported value, path/symlink restrictions, and the npm-vs-desktop-app installer distinction. There is no concept explanation or padding to trim, matching the lean 5 anchor. | 5 / 5 |
Actionability | The guidance is fully concrete and executable: an exact install command ('npm --prefix "<PilotDeck directory>" run install:asr'), the exact tool to call ('mcp__funasr__transcribe_audio'), the exact parameter value, and precise path-handling instructions. For an instruction-only skill, this is copy-paste-ready actionable guidance covering the common cases. | 5 / 5 |
Workflow Clarity | A clear 5-step numbered sequence exists with an explicit feedback loop (check tool availability → run installer → retry the tool in the same session). It falls short of 5 only because step 1 ('Identify the registered audio attachment path in the session message') and the post-transcription steps lack concrete verification checkpoints, e.g. confirming the attachment path resolves before calling the tool or checking the transcript is non-empty before summarizing. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with well-organized sections (Workflow, Constraints) and appropriately defers troubleshooting detail to a clearly signaled one-level reference ('For platform, cache, download-source, and network troubleshooting details, read ../../docs/funasr-installation.md'). No bundle files exist to inline, so the structure fully satisfies the simple-skill guideline. | 5 / 5 |
Total | 19 / 20 Passed |