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

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

65%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is highly actionable with a concrete executable pipeline and a clear workflow, but it loses conciseness through repeated JSON examples and overlapping output sections, and a referenced template path is missing. Adding a post-generation verification step would strengthen workflow clarity.

Suggestions

Consolidate the three script-JSON examples into a single canonical block and merge the overlapping Output Format, Output Handling, and Notes sections to reduce redundancy.

Add an explicit verification checkpoint after generation (e.g., confirm the MP3 file exists and the transcript is non-empty before presenting results) to satisfy the batch-operation feedback-loop expectation.

Fix or remove the dangling [Tech Explainer](templates/tech-explainer.md) reference — no templates/ directory exists in the bundle — or add the referenced file so progressive disclosure is sound.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient and avoids explaining concepts Claude already knows, but the script JSON structure is shown three times (Step 2, "Script JSON Format", and the worked example) and the Output Format, Output Handling, and Notes sections overlap, so it could be tightened.	2 / 3
Actionability	Provides a fully executable command with concrete absolute paths and a complete parameter list ("python /mnt/skills/public/podcast-generation/scripts/generate.py --script-file ... --output-file ..."), plus a copy-paste-ready JSON example.	3 / 3
Workflow Clarity	The three-step workflow (understand requirements, create script JSON, execute generation) is clearly sequenced, but there is no explicit validation or verification checkpoint after the batch audio generation, which caps workflow clarity at 2 per the rubric's batch-operation guideline.	2 / 3
Progressive Disclosure	There is reasonable sectioning and a bundled generate.py script, but the referenced [Tech Explainer](templates/tech-explainer.md) template points to a templates/ directory that does not exist, and most detail lives inline rather than being split into separate reference files.	2 / 3
	Total	9 / 12 Passed

Description

100%

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 is strong: it uses third person, includes an explicit 'Use when' trigger, and names concrete capabilities with natural user terms. It clearly communicates both the skill's purpose and its invocation conditions.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ("generate, create, or produce podcasts from text content"; "Converts written content into a two-host conversational podcast audio format with natural dialogue"), matching the anchor that names several specific concrete actions.	3 / 3
Completeness	Explicitly answers both what ("Converts written content into a two-host conversational podcast audio format") and when ("Use this skill when the user requests to generate, create, or produce podcasts"), with an explicit 'Use when' trigger clause.	3 / 3
Trigger Term Quality	Includes natural user-facing terms ("generate, create, or produce podcasts", "text content") that a user would plausibly say, providing good coverage rather than jargon.	3 / 3
Distinctiveness Conflict Risk	The two-host conversational podcast-from-text niche has distinct triggers (podcasts) and is unlikely to be confused with other skills.	3 / 3
	Total	12 / 12 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
relative_links	Relative link issues: 1 missing	Warning

	Total	15 / 16 Passed

Repository: bytedance/deer-flow
Path: skills/public/podcast-generation/SKILL.md
Commit: cd9432b

Reviewed: about 13 hours 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.