CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-tts-engine

Use this skill to add a new TTS engine to Voicebox. It walks through dependency research, backend implementation, frontend wiring, PyInstaller bundling, and frozen-build testing. Always start with Phase 0 (dependency audit) before writing any code.

Quality

91%

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

85%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: correct file-level detail, explicit validation gates, and a clean single-reference split. The only improvements are tightening two redundant narrative bits and inlining the two deferred command sets.

Suggestions

Trim the v0.2.3 anecdote and the Goal section, which restate the frontmatter description, to reduce token overhead (conciseness).

Inline the throwaway-venv creation and CPU smoke-test commands (and optionally the Phase 0.2 grep patterns) so step 2 is fully executable without opening the referenced doc (actionability).

DimensionReasoningScore

Conciseness

The body is dense with project-specific knowledge (file paths, failure-mode table, registry mechanics) and explains nothing Claude already knows. Minor trims remain: the v0.2.3 war story ("three patch releases because Phase 0 was skipped") and the Goal section largely repeat the frontmatter. This fits 4 (efficient with minor trimmable instances), not 5 where every token earns its place.

4 / 5

Actionability

Concrete, copy-paste commands (mkdir/git clone/just dev/cat), exact per-phase file lists, and a symptom-to-fix table cover the common cases. Minor gaps: the throwaway-venv setup and CPU test commands are not given, and the Phase 0.2 grep searches are deferred to the referenced doc. Mostly executable with minor gaps matches 4 rather than fully-executable 5.

4 / 5

Workflow Clarity

A clear ordered workflow (read guide → Phase 0 research → Phases 1–4 → PyInstaller bundling → dev verification → checklist) with explicit validation gates ("before proceeding", "Test the full chain: model download → load → generate → voice cloning") and a final Implementation Checklist gate. The failure-mode table supplies error-recovery fixes, matching the 5 anchor's feedback loops and checklists.

5 / 5

Progressive Disclosure

The body is a concise operational overview that delegates all phase detail to a single, clearly signaled one-level-deep reference ("Read this file in its entirety before starting" → docs/content/docs/developer/tts-engines.mdx). No bundle files exist to bury or duplicate content, and navigation is trivial. This matches the clear-overview 5 anchor.

5 / 5

Total

18

/

20

Passed

Description

92%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: it names the niche task, lists five concrete pipeline stages, and opens with an explicit use-trigger. Its only weakness is the missing spelled-out "text-to-speech" synonym.

DimensionReasoningScore

Specificity

"add a new TTS engine to Voicebox" plus five concrete named actions ("dependency research, backend implementation, frontend wiring, PyInstaller bundling, and frozen-build testing") give comprehensive, concrete coverage of the domain. Voice is third person ("It walks through"), so no voice penalty applies.

5 / 5

Completeness

Explicitly answers "what" (the five-stage walk-through) and "when" via the equivalent trigger clause "Use this skill to add a new TTS engine to Voicebox". Both are concrete and explicit, matching the 5 anchor rather than 4 where the when-clause would be less specific.

5 / 5

Trigger Term Quality

Natural phrases like "add a new TTS engine", "Voicebox", and "PyInstaller" cover what a user would say, but the spelled-out synonym "text-to-speech" is missing. Good keyword coverage with a few natural terms missing matches the 4 anchor, not the 5 anchor's full synonym/extension sweep.

4 / 5

Distinctiveness Conflict Risk

Scoped to a single named project (Voicebox) and a single task type (adding a TTS engine), with distinct trigger terms. Minimal conflict risk with any other skill; matches the clear-niche 5 anchor.

5 / 5

Total

19

/

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

jamiepine/voicebox

Path

.agents/skills/add-tts-engine/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.