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

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

81%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-organized, actionable skill body with a clearly sequenced workflow, explicit validation checkpoints, and a strong error-recovery table. Minor gaps are inlined detail vs. the external doc and a single reference for progressive disclosure.

Dimension	Reasoning	Score
Conciseness	The body is lean and directive, assuming Claude's competence (no explanation of what TTS or PyInstaller is); only minor narrative padding like "The v0.2.3 release was three patch releases because Phase 0 was skipped" could be trimmed.	4 / 5
Actionability	It provides concrete file paths, executable commands (just dev, cat, mkdir, git clone), and specific PyInstaller directives, but the core Phase 0 grep searches and detailed implementation steps are delegated to the external doc rather than inlined.	4 / 5
Workflow Clarity	A clear six-step sequence with explicit validation gates (Phase 0 CPU test "before proceeding", dev-mode full-chain verify), a checklist gate ("Every item must be checked before handing the build to the user"), and an error-recovery table mapping symptoms to fixes.	5 / 5
Progressive Disclosure	SKILL.md is a well-structured overview pointing to one clearly-signaled one-level-deep reference (tts-engines.mdx) for detail, but the body inlines substantial detail (file lists, failure-mode table) and relies on a single external reference rather than a richer split.	4 / 5
	Total	17 / 20 Passed

Description

83%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, specific description that clearly states a concrete niche and an explicit "Use this skill to" trigger, with comprehensive action coverage. Its only weakness is a singular trigger condition and the absence of the "text-to-speech" synonym.

Dimension	Reasoning	Score
Specificity	The description enumerates five concrete actions — "dependency research, backend implementation, frontend wiring, PyInstaller bundling, and frozen-build testing" — giving comprehensive coverage of what the skill does, matching the anchor for multiple specific concrete actions.	5 / 5
Completeness	It explicitly answers both what (add a TTS engine, with five sub-steps) and when ("Use this skill to add a new TTS engine to Voicebox"), but the trigger is singular and does not enumerate multiple concrete trigger conditions required for a 5.	4 / 5
Trigger Term Quality	"add a new TTS engine to Voicebox" is a natural trigger phrase a user would say, but the description omits the "text-to-speech" synonym, leaving a few natural terms missing rather than comprehensive coverage.	4 / 5
Distinctiveness Conflict Risk	The niche is highly specific — adding a TTS engine to the named product Voicebox — with distinct triggers and minimal overlap risk with other skills.	5 / 5
	Total	18 / 20 Passed

Validation

100%

Warnings & errors only

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
Commit: 51f49de

Reviewed: ~1 month ago

Table of Contents

Discovery Implementation Validation

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.