CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

elevenlabs

Convert documents and text to audio using ElevenLabs text-to-speech. Use this skill when the user wants to create a podcast, narrate a document, read aloud text, generate audio from a file, or convert text to speech.

Quality

87%

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

SKILL.md
Quality
Evals
Security

Quality

Content

80%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.

A well-structured, highly actionable skill body whose implementation is correctly externalized into working bundle scripts. The main weakness is the podcast workflow's lack of validation and error-recovery checkpoints for what is a batch, credit-consuming API operation.

Suggestions

Add validation checkpoints to the podcast workflow: verify the generated script JSON is well-formed with only 'host1'/'host2' speakers before invoking the podcast command, and confirm the output file exists and is non-trivial in size before reporting success.

Add error-recovery guidance for API failures or quota limits mid-generation (e.g., how to detect and resume/retry a failed chunk) so the batch TTS operation has a feedback loop.

Trim the redundant 'When to Use This Skill' section (it duplicates the frontmatter description) and tighten minor filler lines to improve token efficiency.

DimensionReasoningScore

Conciseness

The body is dominated by lean, executable commands and a tight workflow, but the 'When to Use This Skill' trigger list duplicates the frontmatter description and a few lines ('Use this to find voice IDs for the user') could be trimmed. Not anchor 5 due to this redundancy; well above anchor 3 since it never explains concepts Claude already knows.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance throughout: exact CLI invocations ('python skills/elevenlabs/scripts/elevenlabs.py tts --file doc.pdf --output narration.mp3'), a complete config JSON block, the podcast script JSON format, and a concrete temp-file workflow. Matches anchor 5; specific examples cover the common single-voice, document, and podcast cases.

5 / 5

Workflow Clarity

The podcast workflow is a clearly numbered 5-step sequence with exact commands, but validation checkpoints are entirely absent — no check that the generated script JSON is well-formed, no verification the output file was produced, and no API error/quota handling. Podcast generation is a batch operation (per-segment API calls plus chunked TTS and ffmpeg concatenation), so per the judging guideline a batch workflow without validation is capped at 3; it cannot take anchor 4 which requires most checkpoints present.

3 / 5

Progressive Disclosure

The body is a clean overview with well-organized sections, and all implementation weight is appropriately split into the two real bundle scripts (scripts/elevenlabs.py and scripts/extract.py), both referenced with correct paths exactly one level deep. No bulk API reference or reference-doc content is inlined, matching anchor 5 rather than anchor 4 which expects minor organization or placement gaps.

5 / 5

Total

17

/

20

Passed

Description

87%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.

A strong description with an explicit 'Use this skill when...' clause and multiple concrete, natural trigger phrases. The main improvements are mentioning the two-host podcast capability and adding a few missing terms like 'TTS' and file extensions.

DimensionReasoningScore

Specificity

Lists several concrete actions ('Convert documents and text to audio', 'create a podcast', 'narrate a document', 'read aloud text', 'generate audio from a file'), but coverage has minor gaps — the two-host conversational podcast mode and supported document formats are not mentioned. Fits anchor 4 rather than 5 because coverage is not comprehensive, and clearly above anchor 3 which expects only 1-2 concrete actions.

4 / 5

Completeness

Explicitly answers both questions: 'Convert documents and text to audio using ElevenLabs text-to-speech' states what it does, and 'Use this skill when the user wants to create a podcast, narrate a document, read aloud text, generate audio from a file, or convert text to speech' gives concrete trigger phrases. This matches the anchor 5 example structure exactly; anchor 4 would require a weaker or less specific 'when' clause.

5 / 5

Trigger Term Quality

Natural phrases users would say are well covered ('create a podcast', 'narrate a document', 'read aloud', 'convert text to speech', 'generate audio from a file'), but a few common terms are missing such as the 'TTS' acronym, 'audio version', and file extensions like .mp3. Anchor 5 requires synonym and extension completeness, so this sits at anchor 4.

4 / 5

Distinctiveness Conflict Risk

Clear niche (ElevenLabs text-to-speech audio generation) with distinct triggers ('podcast', 'narrate', 'read aloud', 'convert to speech') that would not naturally fire for unrelated skills. Minimal conflict risk, matching anchor 5 rather than anchor 4 which expects notable overlap with closely related skills.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

sanjay3290/ai-skills

Path

skills/elevenlabs/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.