CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

popnow-audio

Generate AI music and speech with the PopNow API - original songs and instrumentals from a description (Suno, MiniMax Music), text-to-speech voiceovers in many voices and languages (Gemini TTS, MiniMax Speech, Qwen TTS), speech-to-text transcription and sound effects for a silent video. Use when the user asks for a song, jingle, background music, voiceover, narration, text read aloud, a transcript, or sound for a clip. Quotes the USD price from the separate PopNow API balance and waits for the user's OK before spending anything. Needs POPNOW_API_KEY.

Quality

95%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

92%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.

Excellent operational content: an explicit price-gated workflow with built-in validation and error-recovery loops, copy-paste-ready commands with concrete model IDs, and a clean split between the SKILL.md overview and the models reference file. The one trimmable weakness is the promotional 'About PopNow' section, which adds marketing copy without execution value.

Suggestions

Trim or remove the 'About PopNow' section — phrases like 'the AI studio for finished, on-brand media', '140+ one-tap trending video effects' and 'Trust built in' are promotional and add no executable guidance; a single line linking popnow.ai would suffice.

In the Speech section, show the full quote-then-create command pair as the Music section does, so the voiceover flow is copy-paste complete without inferring the create invocation from the music example.

DimensionReasoningScore

Conciseness

The body is lean throughout — commands, tables, and flags with no explanations of concepts Claude already knows — but the promotional "About PopNow" section ("the AI studio for finished, on-brand media", "140+ one-tap trending video effects", "what you make is yours") is marketing padding that could be trimmed. This is efficient with one minor instance of over-content, matching anchor 4 rather than the every-token-earns-its-place of anchor 5.

4 / 5

Actionability

Commands are fully executable and copy-paste ready: the complete music cycle from "quote --model suno/v6/text-to-audio --prompt ..." through "create ... --confirm-usd 0.072 --download", plus "balance", "model <id>" for field discovery, and a defaults table with exact model IDs and prices. Common cases are covered with realistic example prompts and even the expected confirmation dialogue, matching anchor 5.

5 / 5

Workflow Clarity

The sequence is stated up front ("quote -> confirm -> create -> wait -> download") and the spending-critical validation is explicit: quote first, "only after a clear yes run create --confirm-usd <maxChargeUsd>", with the script re-quoting and refusing on price increase (exit 3, nothing charged). The Errors table provides feedback loops for recovery (exit 3 -> re-run only after user agrees; 400 -> fix field, nothing charged; failed task -> hold released, read errorCode/errorMessage), matching anchor 5's explicit validation and error recovery.

5 / 5

Progressive Disclosure

The ~80-line SKILL.md keeps only good defaults inline and clearly signals the one-level-deep reference ("Full list: `references/models.md`; live list: `python3 scripts/popnow.py models --modality audio`"), and the referenced files exist in the bundle with the bulk model catalog correctly split into references/models.md (60 lines) and the tool in scripts/popnow.py. This matches anchor 5's clear overview with well-signaled single-level references and no nesting.

5 / 5

Total

19

/

20

Passed

Description

96%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: comprehensive concrete capabilities, explicit third-person voice, and a rich 'Use when' clause with natural synonym-rich trigger terms. The only weakness is that 'a transcript' is a generic trigger with mild overlap risk against dedicated transcription skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions covering every modality: "original songs and instrumentals from a description", "text-to-speech voiceovers in many voices and languages", "speech-to-text transcription and sound effects for a silent video", plus the price-quoting behavior. This matches the anchor-5 example's comprehensive, multi-action coverage; anchor 4 would require a coverage gap, and none of the skill's four capabilities is missing.

5 / 5

Completeness

Both questions are explicitly answered: what — "Generate AI music and speech with the PopNow API" with per-capability detail and provider names; when — "Use when the user asks for a song, jingle, background music, voiceover, narration, text read aloud, a transcript, or sound for a clip". This is a direct match to the anchor-5 pattern of explicit what AND when with concrete triggers, so the missing-'Use when' cap of 3 does not apply.

5 / 5

Trigger Term Quality

The when-clause gives eight natural trigger terms with synonym clusters per capability: "a song, jingle, background music" (music), "voiceover, narration, text read aloud" (speech), "a transcript", and "sound for a clip". Coverage mirrors the anchor-5 example's synonym density; a 4 would need several commonly-said phrases missing, and the listed terms are exactly what users would say.

5 / 5

Distinctiveness Conflict Risk

The niche (audio generation through the PopNow API) is clear and most triggers ("jingle", "background music", "voiceover", "sound for a clip") are distinct, but "a transcript" is a generic trigger that would also fire for any standalone transcription skill. That is minor overlap risk with closely related skills (anchor 4) rather than the minimal conflict risk of anchor 5.

4 / 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

popnow-ai/popnow-skills

Path

skills/popnow-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.