descript — Claude Code skill: edit podcasts by transcript
A skill for editing talk content by rewriting the transcript instead of the timeline. Built for podcasts, interviews and talking-head video.
npx skills add social-media-skills/skills --skill descript -a claude-codeWhat descript does
The skill walks the agent through the WORDS framework: an accuracy pass on the transcript first, then filler and silence removal, paragraph-level restructuring, Studio Sound cleanup, captions and Automatic Multicam. One recording turns into the episode, clips, show notes and chapters. Delete a sentence in the text and the footage goes with it.
Before touching anything, it reads the recording's content skill plus brand-profile and voice-builder. The agent plans the edit and can trigger Underlord through the API or MCP where that connection exists. Verifying by ear and approving the cut stays with a human, and WoopSocial handles publishing the exports. Overdub is own-voice-only and consent-verified, and it works on flubbed words rather than paragraphs — long stretches drift synthetic and get re-recorded.
The sharp edge is meaning. Moving paragraphs around makes it easy to put words in a guest's mouth, so the rule is concision yes, meaning-flips never. Credits matter too: media minutes count everything you import, and features that used to be unlimited are now metered. Check tiers and credits inside the app, because published figures conflict.
What it helps with
- strip filler words and silences in one pass
- fix a flubbed word without re-recording the take
- split one recording into clips, show notes and chapters
- cut between speakers automatically from separate tracks
- generate captions from a corrected transcript
Example prompts for the agent
- Clean up this podcast in Descript: remove filler words and silences, then show me what's left
- Turn this interview into clips, show notes and chapters, but don't publish anything until I approve
- Check the transcript for errors before we start cutting
How to install descript
1Skills CLI (Vercel)
npx skills add social-media-skills/skills --skill descript -a claude-code2Manually: put the files in place
~/.claude/skills/descript/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/descript/
1Skills CLI (Vercel)
npx skills add social-media-skills/skills --skill descript -a codex2Manually: put the files in place
.agents/skills/descript/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add social-media-skills/skills --skill descript -a cursor2Manually: put the files in place
.cursor/skills/descript/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install social-media-skills/skills descript2Manually: put the files in place
.github/skills/descript/SKILL.md1Skills CLI (Vercel)
npx skills add social-media-skills/skills --skill descript -a gemini-cli2Platform CLI
gemini skills install https://github.com/social-media-skills/skills --path skills/descriptManually: put the files in place
.devin/skills/descript/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add social-media-skills/skills --skill descript -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about descript
How do I install descript in Claude?
Run npx skills add social-media-skills/skills --skill descript -a claude-code. The skill file then lives at ~/.claude/skills/descript/SKILL.md.
What does descript do?
It runs talk-content edits through transcript changes: audio cleanup, cutting, clips and show notes. The agent plans and triggers the work; a human verifies by ear and approves.
How is descript different from capcut or opus-clip?
Here the edit happens in the transcript text. capcut covers beat-synced visual short-form, while captions-and-clipping and opus-clip pick clips at scale — descript hands them the master.
Source text
SKILL.md · MIT
--- name: descript description: >- The Descript craft skill — edit talk content (podcasts, interviews, talking-head video) by editing the transcript instead of the timeline. Use when someone wants to edit in Descript, edit a podcast or interview, remove filler words/silences, clean up audio (Studio Sound), fix a flubbed word without re-recording (Overdub), auto-cut between speakers, turn one recording into clips + show notes + chapters, or asks about Descript's plans, credits, or Underlord. Uses the WORDS framework plus the interview rule: concision yes, meaning-flips never. Reads the recording's content skill + brand-profile/voice-builder first. The agent plans the edit (API/MCP where connected); the HUMAN verifies by ear and approves; WoopSocial publishes the exports. Overdub is consent-verified own-voice-only; tiers/credits are verified in-app. Distinct from capcut (visual short-form), captions-and-clipping/opus-clip (clip selection at scale), ai-voiceover (dedicated TTS), and podcast-and-audiograms (the strategy). version: 1.0.0 --- # descript The **talk-content editing tool skill** — write the edit in the transcript, Overdub with consent, refine the sound, dress the visuals, and ship the cuts. The agent plans (and can drive Underlord via API/MCP where connected); the **human verifies by ear and approves**; **WoopSocial publishes** the exports. (Ships with `tools/integrations/descript.md`.) ## The POV: the transcript is the timeline — decide in text, verify by ear For dialogue-heavy content, editing the transcript beats scrubbing a timeline: delete the sentence, the clip disappears; move the paragraph, the footage follows — reviews report ~60–70% editing-time cuts for talk content. But the paradigm has two sharp edges the top 1% respect. **(1) The voice spine:** Overdub's consent-verified, **own-voice-only** design is the model, not an obstacle — it exists so nobody types words into someone else's mouth; and the craft truth is it shines on flubbed *words*, not paragraphs (long Overdub drifts synthetic — re-record those). **(2) The meaning spine:** text-editing makes it dangerously easy to rearrange a guest into saying something they didn't — **concision yes, meaning-flips never**, and the human owns the final cut of anyone else's words. Operationally: the **accuracy pass is mandatory** (transcript errors become wrong edits AND wrong captions), and since the Sept 2025 overhaul, the workflow must be **credit-aware** — media minutes count everything you import, and formerly-unlimited AI features are metered. ## Read these first 1. The recording's content skill — **podcast-and-audiograms** / **youtube-long-form** / **educational-content**. 2. **brand-profile** + **voice-builder** (written outputs) + **design-and-templates** (captions/layout). ## The framework: WORDS (Depth: `references/the-words-framework.md`.) - **W — Write the edit:** accuracy pass first; then cut tangents/bad takes, one-step filler+silence removal (Underlord), restructure by moving paragraphs — decide in text, **verify by ear.** - **O — Overdub with consent:** own-voice-only, consent-verified; single words/short phrases (paragraphs = re-record); vocabulary/credit limits; disclose synthetic speech where required. - **R — Refine the sound:** Studio Sound once per source (credits; cleaner audio also improves the transcript); level speakers; extreme noise is a re-record, not a rescue. - **D — Dress the visuals:** Automatic Multicam (record separate tracks on purpose), captions from the corrected transcript, human-approved B-roll, Eye Contact used honestly; beat-sync/color route elsewhere. - **S — Ship the cuts:** one transcript → the episode + clips (Underlord flags, the **human picks** fairly) + show notes + chapters + a text post; route onward and publish via WoopSocial. ## The reality (verify-quarterly) 2026 Descript: **Underlord** (agentic co-editor — filler/silence in one step, bad-take flags, B-roll suggestions, clips, show notes) now triggerable via the **2026 public API (open beta) incl. MCP connections**; Overdub (~24–48h training; source-audio requirements have varied — verify); Studio Sound (~10 credits/use); Automatic Multicam; Eye Contact; ~92–95% transcription accuracy on clean audio, ~75–85% with noise/accents/jargon; ~23 languages; SOC 2 Type II; cloud-dependent (no offline). **Pricing: the Sept 2025 overhaul** moved to media minutes + AI-credit metering of formerly-unlimited features; documented bill-shock and no mid-cycle proration (G2, attributed); **tier figures conflict across sources — verify in-app.** Full detail: `references/descript-2026-reality.md`. The weekly loop, credit-aware checklist, the Overdub decision table, the interview-integrity checklist, and two worked examples: `references/workflows-and-templates.md`. ## Honest scope (never violate) - **The agent** plans the edit and can trigger Underlord/media actions **via the API/MCP where connected** (exact human steps otherwise — no pretended automation); the **human verifies by ear** (pacing/tone/fairness don't live in text) and approves — the agent never fabricates "that cut sounds great." **WoopSocial publishes** the finished exports; it does **not** edit media; podcast RSS distribution is separate (human; podcast-and-audiograms). - **Voice spine:** own-voice-only cloning; never a guest/competitor/public figure; never fabricated words in a real mouth; **AI-disclosure** for synthetic speech where required (EU AI Act; C2PA). **Meaning spine:** interview edits preserve meaning + clip context; approval offered on significant edits. **Never fabricate** tiers, credits, or metrics — verify in-app. (Full scope: `references/scope-and-connections.md`.) ## Distinct from its siblings (route correctly) **descript (this)** = text-based talk-content editing · **capcut** = beat-synced visual short-form (the hybrid: master here, style cuts there) · **captions-and-clipping / opus-clip** = clip selection at scale (this feeds them the master) · **podcast-and-audiograms** = the strategy this tool serves · **ai-voiceover (elevenlabs)** = dedicated TTS/narration (Overdub = own-voice corrections) · **talking-head-and-piece-to-camera** = the performance (Eye Contact patches a read, doesn't replace delivery) · **youtube-long-form** = the structure the recording follows. ## Where this connects Reads first: **podcast-and-audiograms** / **youtube-long-form** + **brand-profile/voice-builder** + **design-and-templates.** Feeds: **captions-and-clipping** / **opus-clip** (the master), **capcut** (short-form styling), **text-post-and-microblog** (the written cut), **email-and-newsletter** (show notes), **youtube-publishing-and-metadata.** Publishes via: exports → **scheduling-and-queue → WoopSocial** (social); RSS host (podcast — human). Tool file: **`tools/integrations/descript.md`.** Measure with: native + **analytics-and-reporting** on listen-through/watch-through + clips — never fabricated. ## Definition of done A talk-content edit made at the speed of text and verified by ear: transcript corrected first (names/jargon — errors become wrong edits and captions), tangents/bad takes cut and filler+silences removed in batched Underlord passes, restructure done in text and the result listened through; flubs fixed with consent-verified own-voice Overdub at word/phrase length only (paragraphs re-recorded; synthetic speech disclosed where required); Studio Sound run once per source; multicam/captions/layout dressed on-brand; the interview rule held (meaning + clip context preserved, approval offered, the human owning the final cut of anyone else's words); one corrected transcript shipped as the episode + human-picked clips + show notes + chapters, routed onward and published via WoopSocial; the workflow credit-aware under the post-Sept-2025 model (import only what you'll edit; verify tiers in-app); API/MCP automation only where actually connected; **no cloned third-party voices, no meaning-flips, no fabricated tiers/credits/metrics**; and correctly distinguished from capcut, captions-and-clipping/opus-clip, ai-voiceover, and podcast-and-audiograms.
© social-media-skills · MIT · social-media-skills/skills