CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

blog-audio

Paid Gemini TTS audio for a finished blog post: summary, full read-aloud, or two-speaker dialogue, with an MP3 and an HTML5 embed. Asks for explicit consent before the first paid call. Runs only on an explicit request: /blog audio, "generate audio for this blog post", "narrate this blog post", "audio version of this post", or "podcast version of this post". Not for general speech or dictation questions.

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

77%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 exceptionally actionable and its workflows are gated with real validation checkpoints (key check, consent, dry-run estimate, model confirmation). Its weaknesses are repetition — skip/fallback and substitution caveats restated several times — and a primary reference, orchestration-details.md, that does not exist in the bundle.

Suggestions

Consolidate the skip-note/fallback guidance, which currently appears in four places (Cost and consent gate, API Key Check, Internal API, Error Handling), into one section that all workflows reference.

Tighten the 'Persistent runtime directory' section: state the markdown-substitution and fail-closed rules once instead of rephrasing them across multiple paragraphs.

Fix the orchestration-details.md reference: either add the file to references/ or remove the instruction to read it before loading project context, since it is currently a broken entry point.

DimensionReasoningScore

Conciseness

The body avoids teaching known concepts and its commands are tight, but the 'Persistent runtime directory' section restates the same markdown-substitution/fail-closed caveats multiple ways, and the skip-note rule is repeated across four sections (cost gate, API key check, Internal API, Error Handling). This fits the 3 anchor ('mostly efficient but could be tightened') better than the 4 anchor's 'minor instances of over-explanation'.

3 / 5

Actionability

Fully executable throughout: complete python3 wrapper invocations with voice, model, output, and --json flags; setup and dry-run verification commands; a key-check shell snippet; and ready-to-paste embed code for HTML, MDX, and WordPress covering the common cases.

5 / 5

Workflow Clarity

The 6-step generation workflow is clearly sequenced with explicit validation checkpoints (API key gate, consent gate, --dry-run cost estimate, confirming the resolved model ID before spending) and error-recovery guidance including a bounded one-retry policy — matching the 5 anchor's explicit validation and feedback loops.

5 / 5

Progressive Disclosure

Structure is otherwise good — voices.md is a real, clearly signaled one-level reference loaded on demand, and scripts are properly separated — but the body designates `orchestration-details.md` as the main reference to read first, and that file is absent from references/, leaving the instructed entry point broken. This is worse than the 4 anchor's minor organization gaps but above the 2 anchor's buried/minimal structure.

3 / 5

Total

16

/

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 states concrete capabilities, an explicit trigger list with natural user phrasings, a negative boundary, and the paid/consent framing, all in third person without padding. The only gap is a few missing natural trigger variants such as 'read this aloud' or 'text-to-speech'.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'summary, full read-aloud, or two-speaker dialogue, with an MP3 and an HTML5 embed' plus the consent behavior — with comprehensive coverage of the skill's scope, matching the top anchor rather than the 'minor gaps' level 4 example.

5 / 5

Completeness

Explicitly answers both what (Gemini TTS summary/full/dialogue with MP3 and HTML5 embed output) and when ('Runs only on an explicit request:' followed by concrete trigger phrases), exactly the 5 anchor pattern; the 4 anchor would require a less explicit 'when'.

5 / 5

Trigger Term Quality

Includes four natural user phrasings ('generate audio for this blog post', 'narrate this blog post', 'audio version of this post', 'podcast version of this post') plus the /blog audio command, but omits common variants such as 'read this aloud' or 'text-to-speech' as trigger terms, fitting the 4 anchor (good coverage, a few natural terms missing) better than 5.

4 / 5

Distinctiveness Conflict Risk

Clear niche (blog post audio narration via paid Gemini TTS) with an explicit negative boundary — 'Not for general speech or dictation questions' — minimizing conflict with adjacent skills; fits the 5 anchor rather than the minor-overlap 4 anchor.

5 / 5

Total

19

/

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

AgriciDaniel/claude-blog

Path

skills/blog-audio/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.