transcribe
Skill0 starsChanged 7 months agoMITView on GitHub
Drop a video or audio URL — Athena fetches the audio, transcribes it, and returns a clean transcript plus a short summary. Works on YouTube, Instagram reels, TikTok, podcasts, and any yt-dlp-supported platform. Use when the user shares a link and wants the content extracted, not just bookmarked.
- Reads credentials
- Deletes or force-pushes
- Installs packages
51 other projects use a version of this.
Adopted by
Most recently taken up by
- aya-taleb/linkedin-boost-skillstheir own version, first seen Nov 16, 2026
- Ivan-propio/claude-skillstheir own version, first seen Nov 16, 2026
- aya-taleb/instagram-boost-skillstheir own version, first seen Nov 15, 2026
- EditAtlas/skillstheir own version, first seen Nov 15, 2026
- linxule/carreltheir own version, first seen Nov 8, 2026
- overment/skillstheir own version, first seen Nov 8, 2026
Used with
Projects with it also use spreadsheet, think and 9 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
JetBrainsSkillspreadsheet
Use when tasks involve creating, editing, analyzing, or formatting spreadsheets (`.xlsx`, `.csv`, `.tsv`) with formula-aware workflows, cached recalculation, and visual review.
Also in 3 projects that use this
vltingSkillthink
Lightweight plan-to-execution pipeline. Explores codebase, runs council deliberation, presents plan for approval, then executes via /run.
Also in 3 projects that use this
robzolkosSkilldone
Reset the working directory for the next task by ensuring no uncommitted changes exist, then switching to the main branch and pulling latest.
Also in 3 projects that use this
JaimeGBASkillingest
Digest an external source (article, paper, transcript, URL, book chapter) and integrate its content into the knowledge base
Also in 3 projects that use this
AnthropicSkillonboarding
Generate an onboarding checklist and first-week plan for a new hire. Use when someone has a start date coming up, building the pre-start task list (accounts, equipment, buddy), scheduling Day 1 and Week 1, or setting 30/60/90-day goals for a new team member.
Also in 3 projects that use this
MicrosoftSkilldiagnose
Use to systematically diagnose why scenarios fail — identifies root causes by analyzing agent traces, codebase, and behavioral patterns
Also in 3 projects that use this
Other versions51 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 51
- openai/skills★ 27ksame name
- gnekt/My-Brain-Is-Full-Crew★ 3.9ksame name
- badlogic/pi-skills★ 2.5ksame name
- greatSumini/cc-system★ 438same name
- JetBrains/skills★ 386same name
- bholmesdev/skills★ 179same name
- DojoCodingLabs/remotion-superpowers★ 153same name
- thiagofinch/mega-brain★ 95same name
- TserenTserenov/FMT-exocortex-template★ 64same name
- EditAtlas/skills★ 40same name
41 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository57 other files it gives its agents.
- .claude/rules/agents.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- knowledge/CLAUDE.mdCLAUDE.md
- agent-harness-constructionSkill
- agentic-engineeringSkill
- ai-first-engineeringSkill
- api-designSkill
- backend-patternsSkill
- blueprintSkill
- bookmarkSkill
- brain-dumpSkill
- building-explainerSkill
- calendar-managerSkill
- code-engineerSkill
- compileSkill
- continuous-agent-loopSkill
- continuous-learningSkill
- copywriterSkill
- cost-aware-llm-pipelineSkill
- councilSkill
- database-migrationsSkill
- day-plannerSkill
- debriefSkill
- deep-researchSkill
- deployment-patternsSkill
- docker-patternsSkill
- e2e-testingSkill
- claude-apiSkill
- coding-standardsSkill
- eng-inboxSkill
- updateSkill
- enterprise-agent-opsSkill
- eval-harnessSkill
- frontend-patternsSkill
- humanizerSkill
- iterative-retrievalSkill
- log-expenseSkill
- memory-auditSkill
- migrateSkill
- minimalist-uiSkill
- onboardSkill
- full-output-enforcementSkill
- postgres-patternsSkill
- redesign-existing-projectsSkill
- regex-vs-llm-structured-textSkill
- researchSkill
- search-firstSkill
- security-reviewSkill
- security-scanSkill
- self-upgradeSkill
- high-end-visual-designSkill
- spending-summarySkill
- design-taste-frontendSkill
- tdd-workflowSkill
- verification-loopSkill
- video-ideasSkill
- weekly-reviewSkill
The file
We split this skill into the rules it gives an agent
10 rules. 0 are common, 9 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 44 edited versions we read keep these.
9
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 47
If neither Groq nor whisper-cli is available, tell the user how to set up Groq (free tier, 30s) and stop.
- Distinctive: line 55
If user dropped a URL with no other instruction, ask one short question: "Want me to transcribe it?" Wait for confirmation.
- Distinctive: line 107
If the transcript is short (under 500 words), inline the full text.
- Very specific: line 108
Don't editorialize the transcript itself — it's the speaker's words, not Athena's interpretation.
- Distinctive: line 110
If the audio is mostly music or non-verbal, say so: "Mostly background music, no transcribable speech." Don't fabricate.
- Distinctive: line 116
Does NOT chain to content-creation skills (no auto-remix to LinkedIn posts, etc.).
- Distinctive: line 117
Does NOT save to long-term memory automatically — user must ask.
- Distinctive: line 118
Does NOT translate. If the transcript comes back in another language, deliver it as-is and offer translation as a follow-up.
- Distinctive: line 119
Does NOT extract video frames or screenshots — audio only.
- Distinctive: line 120
Does NOT work on protected content where yt-dlp can't access (DRM, paywall).
“Common” is measured: kept by at least 6 in 10 of the 44 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Transcribe
Pulls audio from any supported URL, transcribes it, and surfaces the content. Pure ingestion — what the user does with it (memory, notes, content remix) is downstream.
When to Trigger
Auto-fire on URL drops — if the user pastes a link from any of these platforms with no other instruction, ask "Want me to transcribe it?" then run:
| Platform | Method |
| YouTube / Shorts | yt-dlp → audio → transcribe |
| Instagram Reels | yt-dlp (with cookies) → audio → transcribe |
| TikTok | yt-dlp → audio → transcribe |
| Podcasts (RSS/MP3 link) | direct download → transcribe |
| Twitter/X video | yt-dlp → audio → transcribe |
| Any audio/video URL yt-dlp accepts | same flow |
Explicit triggers:
- "Transcribe this"
- "What does this video say"
- "Summarize this clip"
- "Pull the transcript from [URL]"
- "/transcribe [URL]"
Do NOT trigger for:
- Article links (use WebFetch instead — no audio to transcribe)
- Links the user has clearly already watched and is referencing
- The user pasting a link to share with Athena, not to ingest
Requirements
| Tool | Install | Purpose |
yt-dlp | Mac: brew install yt-dlp / Ubuntu: pipx install yt-dlp | Fetches audio from any video URL |
ffmpeg | Mac: brew install ffmpeg / Ubuntu: apt-get install ffmpeg | Audio conversion |
GROQ_API_KEY | Free tier at console.groq.com — set in bot/.env or .env | Whisper transcription (primary path) |
whisper-cli (optional, Mac fallback) | brew install whisper-cpp | Local transcription if no Groq key |
If neither Groq nor whisper-cli is available, tell the user how to set up Groq (free tier, 30s) and stop.
Steps
Step 1: Confirm intent
If user dropped a URL with no other instruction, ask one short question: "Want me to transcribe it?" Wait for confirmation. Skip this if user explicitly said transcribe.
Step 2: Fetch audio
bash scripts/fetch-audio.sh "<URL>" /tmp/transcribe-$$Returns the path to audio.mp3. If yt-dlp fails (private video, geo-block, expired link), report cleanly: "Couldn't fetch — [reason]. Got a different link?"
Step 3: Transcribe
bash scripts/transcribe.sh /tmp/transcribe-$$/audio.mp3Returns plain text on stdout. Capture it.
Step 4: Clean up
rm -rf /tmp/transcribe-$$Step 5: Deliver
Output format:
**Transcript** ([duration] · [platform])
[3-5 sentence summary — what the speaker actually says, not metadata. Lead with the thesis.]
---
**Full transcript:**
[Full text. If over ~3000 words, save to `personal/inbox/transcripts/<slug>-<date>.md` and link instead.]Step 6: Offer next moves (one line, not a menu)
Pick the most likely follow-up based on context:
- Coaching/learning content → "Want me to extract the key takeaways?"
- Long-form interview/podcast → "Want me to save this to your inbox?"
- Tutorial/how-to → "Want me to pull out the action items?"
- Otherwise → no follow-up offer; just end clean.
Output Rules
- Lead with the summary, not the metadata. The user wants to know what was said.
- If the transcript is short (under 500 words), inline the full text. If long, save to disk and link.
- Don't editorialize the transcript itself — it's the speaker's words, not Athena's interpretation.
- The summary IS Athena's interpretation — be sharp, not neutral.
- If the audio is mostly music or non-verbal, say so: "Mostly background music, no transcribable speech." Don't fabricate.
What This Skill Does NOT Do
- Does NOT chain to content-creation skills (no auto-remix to LinkedIn posts, etc.).
- Does NOT save to long-term memory automatically — user must ask.
- Does NOT translate. If the transcript comes back in another language, deliver it as-is and offer translation as a follow-up.
- Does NOT extract video frames or screenshots — audio only.
- Does NOT work on protected content where yt-dlp can't access (DRM, paywall). Report and stop.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

