CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tts

Text-to-speech synthesis with ElevenLabs and system voices

60

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./src/skills/bundled/tts/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is an excellent, lean, fully executable API reference: concrete commands, complete code samples, and useful data tables with no padding. Its main structural weakness is that everything — the full API reference, voice catalog, and provider tables — is inlined in SKILL.md rather than split into one-level-deep reference files, and the multi-provider fallback is asserted as a best practice without concrete steps.

Suggestions

Move the full TypeScript API reference, ElevenLabs voice table, and provider comparison into references/ files (e.g. references/api.md, references/voices.md), keeping quick-start usage and the most common commands inline in SKILL.md with clearly signaled links.

Turn the fallback best practice into a concrete, ordered step (e.g. check ELEVENLABS_API_KEY is set; on absence or API failure, fall back to provider 'say'/'espeak') to add an explicit validation checkpoint.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: every section is either executable code with minimal one-line comments, a data table (voices, providers) with library-specific values, or terse best-practice bullets. No concepts Claude already knows are explained, matching 'Lean and efficient; every token earns its place'; it is not anchor 4 because there is no over-explanation to trim.

5 / 5

Actionability

The content is fully executable and copy-paste ready: concrete chat commands ('/speak "Market alert" --voice rachel'), complete TypeScript calls for createTTSService, synthesize, speak with options, streaming, listVoices, preview, queue management, and SSML — covering the common cases. This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

The core single action (synthesize/speak text) is unambiguous with concrete invocations for each provider, and provider setup per platform is clearly laid out. However, there are minor validation gaps: no explicit checkpoint for verifying ELEVENLABS_API_KEY presence before use, and the fallback guidance ('Use say/espeak if ElevenLabs unavailable') is a bullet without steps. This fits 'Clear sequence with most checkpoints present; minor validation gaps' rather than 5 (no error-recovery feedback loop) and clearly above 3 (the happy path is fully concrete).

4 / 5

Progressive Disclosure

The SKILL.md is a ~220-line complete API reference inlined in the main file with good section headers but no bundle files at all (no references/, scripts/, or assets/ exist). The voice table, provider table, and full API reference are content that clearly belongs in separate reference files — matching 'Some structure but could be better organized; ... content that should be separate is inline' (cf. the '200 lines of API reference that could be in a separate file' example). It is above anchor 2 because section headers make it navigable, and below anchor 4 because none of the bulk reference material is split out.

3 / 5

Total

17

/

20

Passed

Description

53%Weight 40%Scale 1-5

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 states a clear, concrete 'what' but stops there: it lacks any 'Use when...' trigger clause and omits natural user phrasings like 'read aloud' or 'speak'. Provider names give it reasonable distinctiveness, but it undersells the skill's actual capabilities.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to speak or read text aloud, play audio alerts, or when TTS/speech synthesis is needed.'

Include natural synonyms users actually say — 'read aloud', 'speak', 'say text', 'TTS', 'audio output' — alongside 'text-to-speech synthesis'.

Mention the other concrete capabilities shown in the body (voice listing/preview, streaming synthesis, message queueing, multiple providers) to round out coverage.

DimensionReasoningScore

Specificity

The phrase 'Text-to-speech synthesis with ElevenLabs and system voices' names the domain and one concrete action (synthesis) plus the providers, matching the 'names domain and 1-2 concrete actions, but not comprehensive' anchor (cf. 'Processes PDF files and extracts content'). It is above anchor 2 because 'synthesis' is a concrete action, not merely generic processing, but below anchor 4 because no other capabilities (voice listing, streaming, queueing) are mentioned.

3 / 5

Completeness

There is a clear 'what' (speech synthesis via ElevenLabs and system voices) but no 'Use when...' clause or equivalent trigger guidance, so completeness is capped at 3 per the guideline ('A missing "Use when..." clause or equivalent explicit trigger guidance should cap completeness at 3'). It is above anchor 2 because the 'what' is concrete, and below anchor 4 because no 'when' guidance is present even weakly.

3 / 5

Trigger Term Quality

Relevant keywords exist ('Text-to-speech', 'synthesis', 'ElevenLabs', 'voices'), but common natural phrases users would say are missing — 'read aloud', 'speak', 'say', 'TTS', 'audio'. This matches 'Some relevant keywords but missing common variations or synonyms' (cf. 'Works with PDF files'); it is below anchor 4 because the everyday phrasings users naturally use are absent.

3 / 5

Distinctiveness Conflict Risk

Speech synthesis with named providers (ElevenLabs, system voices) is a fairly distinct niche with little chance of triggering for the wrong skill, matching 'Mostly distinct; minor overlap risk with closely related skills'. It is below anchor 5 because the description is terse and does not carve out an unmistakable trigger boundary, and above anchor 3 because it is more specific than a generic 'works with document files' style description.

4 / 5

Total

13

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

alsk1992/CloddsBot

Path

src/skills/bundled/tts/SKILL.md

Reviewed

Table of Contents

Is this your skill?

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.