CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

podcast-generation

Use this skill when the user requests to generate, create, or produce podcasts from text content. Converts written content into a two-host conversational podcast audio format with natural dialogue.

Quality

80%

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 ./skills/public/podcast-generation/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 highly actionable, with a complete executable pipeline, exact JSON schema, and a strong worked example, plus a clear workflow and an explicit failure-mode checkpoint. Its weaknesses are redundant restating of the JSON format and output-format details across sections, and a template reference pointing to a nonexistent file.

Suggestions

Fix or remove the dangling "[Tech Explainer](templates/tech-explainer.md)" reference — no templates/ directory exists in the bundle, so the link currently leads nowhere.

Merge the Step 2 JSON structure with the "Script JSON Format" section and fold "Output Format" into "Script Writing Guidelines" to eliminate the repeated schema and format details.

Add brief error-recovery guidance after the failure-diagnostics note (e.g., what to check in stderr and when regeneration is worth retrying) to close the workflow's validation loop.

DimensionReasoningScore

Conciseness

The JSON structure is documented twice (Step 2 and the "Script JSON Format" section), "Output Format" restates the two-host/"Hello Deer"/10-minute details already given in "Script Writing Guidelines", and "Overview" overlaps "Core Capabilities". It is mostly efficient and assumes Claude's competence, but the redundancy means it could be meaningfully tightened, matching the 3 anchor rather than the minor-trim profile of 4.

3 / 5

Actionability

The skill provides a fully executable command ("python /mnt/skills/public/podcast-generation/scripts/generate.py --script-file ... --output-file ... --transcript-file ...") with each parameter documented, an exact JSON schema with field semantics, and a complete worked example including realistic dialogue lines. Copy-paste ready guidance covers the common case, matching the 5 anchor.

5 / 5

Workflow Clarity

A clear three-step sequence (understand requirements, create script JSON, execute generation) with an explicit validation checkpoint ("The command exits with status 1 and writes diagnostics to stderr if generation fails. Only present the MP3 after a successful command"). There is no error-recovery loop describing what to do after a failure, so it matches the 4 anchor (most checkpoints present, minor gaps) rather than 5.

4 / 5

Progressive Disclosure

The body is organized into clear sections and correctly defers the template to a load-on-match pointer ("Read the following template file only when matching the user request"), but the sole reference "[Tech Explainer](templates/tech-explainer.md)" points to a file that does not exist in the bundle. Scored against the actual bundle structure (only scripts/generate.py exists), the dangling reference leaves navigation unreliable, matching the 3 anchor rather than the 4 anchor's 'references mostly clear'.

3 / 5

Total

15

/

20

Passed

Description

82%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 cleanly and explicitly states both what the skill does and when to use it, with natural trigger phrasing and a distinct niche. Its main limitation is that it describes only the end-to-end conversion action, leaving concrete capabilities like script authoring, TTS synthesis, and transcript output unstated.

DimensionReasoningScore

Specificity

Names the domain and one concrete action ("Converts written content into a two-host conversational podcast audio format with natural dialogue") but omits script creation, TTS synthesis, and transcript generation, so coverage is not comprehensive. This matches the anchor for naming the domain with 1-2 concrete actions rather than the several specific actions required for 4.

3 / 5

Completeness

It explicitly answers both parts: "Use this skill when the user requests to generate, create, or produce podcasts from text content" (when) and "Converts written content into a two-host conversational podcast audio format with natural dialogue" (what). Both are concrete and explicit with trigger phrases, matching the 5 anchor; the 4 anchor's caveat that 'when' could be more explicit does not apply.

5 / 5

Trigger Term Quality

"generate, create, or produce podcasts from text content" gives good natural keyword coverage a user would actually say, but common variations like "audio version", "narrate", or "TTS" are absent. A few natural terms are missing, matching the 4 anchor rather than the comprehensive synonym/extension coverage of 5.

4 / 5

Distinctiveness Conflict Risk

"podcasts from text content" carves out a clear niche with distinct triggers that would not naturally fire for other skills. Minimal conflict risk, matching the 5 anchor.

5 / 5

Total

17

/

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

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

bytedance/deer-flow

Path

skills/public/podcast-generation/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.