ElevenLabs text-to-speech with mac-style say UX.
74
Quality
66%
Does it follow best practices?
Impact
91%
3.50xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./openclaw/skills/sag/SKILL.mdQuality
Discovery
32%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description identifies the core technology (ElevenLabs TTS) but is too terse to be effective for skill selection. It lacks explicit trigger guidance, concrete action verbs, and natural user keywords. The 'mac-style say UX' reference is cryptic and doesn't help Claude understand when to use this skill.
Suggestions
Add a 'Use when...' clause with explicit triggers like 'Use when the user wants to convert text to speech, generate audio from text, or mentions ElevenLabs, TTS, or voice generation'.
List specific capabilities such as 'Convert text to natural-sounding speech, generate audio files, select different voices'.
Include common user terms like 'TTS', 'voice', 'audio', 'speak', 'read aloud' to improve trigger matching.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (text-to-speech) and references a specific tool (ElevenLabs) with a UX comparison (mac-style say), but doesn't list concrete actions like 'convert text to audio', 'generate voice files', or 'adjust voice parameters'. | 2 / 3 |
Completeness | Provides a brief 'what' (text-to-speech with ElevenLabs) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Includes 'text-to-speech' and 'ElevenLabs' which are relevant keywords, but misses common variations users might say like 'TTS', 'voice generation', 'audio', 'speak', 'read aloud', or 'voice synthesis'. | 2 / 3 |
Distinctiveness Conflict Risk | ElevenLabs is a specific service which helps distinguish it, but 'text-to-speech' is broad enough that it could conflict with other TTS skills; the 'mac-style say UX' adds some distinction but is unclear. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an excellent skill file that demonstrates strong token efficiency while remaining highly actionable. It provides concrete CLI examples, specific model recommendations, and clear guidance for voice responses without any unnecessary explanation of concepts Claude already knows. The organization is logical and the content is immediately usable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely lean and efficient. No unnecessary explanations of what TTS is or how APIs work. Every line provides actionable information Claude needs. | 3 / 3 |
Actionability | Provides concrete, copy-paste ready commands throughout. Examples are executable (`sag "Hello there"`, `sag -v Clawd -o /tmp/voice-reply.mp3`), and specific tags/options are clearly listed. | 3 / 3 |
Workflow Clarity | For this simple CLI tool, the workflow is appropriately clear. The 'Chat voice responses' section shows a clear two-step process (generate then include). The 'First fix' progression for pronunciation issues provides logical sequencing. | 3 / 3 |
Progressive Disclosure | Well-organized with clear sections. For a skill under 50 lines with no need for external references, the structure is appropriate with logical groupings (quick start, model notes, pronunciation rules, audio tags, chat responses). | 3 / 3 |
Total | 12 / 12 Passed |
Validation
72%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 8 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 8 / 11 Passed | |
50ef2f3
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.