Extract transcripts from podcasts and YouTube videos, then create beautifully formatted show notes and summaries automatically.
The Shownotes skill transforms Claude into a podcast discovery and transcription assistant. It can:
- π Search Apple Podcasts for episodes by name, topic, or show
- π¬ Search YouTube for podcast episodes and videos
- π Extract transcripts from YouTube videos
- π§ Request transcriptions for podcast audio files
- π Find existing transcripts in the shownotes.io database
- β¨ Create professional show notes with summaries, quotes, takeaways, and more
Transform raw podcast transcripts into:
- Comprehensive show notes in Markdown
- Interactive HTML pages with navigation and styling
- Key topics and section breakdowns
- Notable quotes from the episode
- Actionable takeaways for readers
- Shareable content for blogs and social media
# Add this repository as a marketplace
/plugin marketplace add forcequit/shownotes-skill
# Install the skill
/plugin install shownotes@shownotes-skill-
Clone this repository:
git clone https://github.com/forcequit/shownotes-skill.git
-
Install as a plugin:
/plugin add /path/to/shownotes-skill
-
Start using it! Just mention podcasts or transcripts:
Find me the latest Lex Fridman podcast episode about AI
- Download
shownotes.skillfrom the releases page - In Claude.ai, navigate to your skills settings
- Import the
shownotes.skillfile - Start using it in conversations!
Find episodes from The Tim Ferriss Show about productivity
Claude will:
- Search Apple Podcasts
- Display up to 3 matching episodes with artwork and details
- Offer to transcribe your selected episode
Find and transcribe the latest Huberman Lab episode on YouTube
Claude will:
- Search YouTube for the video
- Extract the transcript
- Create professional show notes
Once you have a transcript, simply ask:
Create comprehensive show notes for this episode
Claude will generate:
- Executive summary with TL;DR
- Key topics covered with bullet points
- Notable quotes from the episode
- Key takeaways numbered list
- Timestamps (if available)
- Resources mentioned
IMPORTANT: This skill requires access to the plugins.shownotes.io API domain.
For Claude Code users: Add the domain to your network settings:
# Check your network configuration
cat ~/.claude/config.yaml
# The allowed domains should include:
# - plugins.shownotes.ioIf API calls fail with proxy/connection errors, you need to update your network settings to allow plugins.shownotes.io.
- Works with Claude Pro, Max, Team, and Enterprise plans
- Requires Claude Code CLI for developer installation
- Claude.ai web interface for personal use
When you request a transcription:
- The skill submits your request to shownotes.io
- Processing typically takes a few minutes
- You receive an email when the transcript is ready
- Access your transcript via the provided link
- Apple Podcasts: Direct search and transcription requests
- YouTube: Video search and transcript extraction
- Shownotes.io Database: Access to previously transcribed episodes
- Direct Audio URLs: Any MP3/audio file URL can be transcribed
Some podcast episodes are marked as protected and cannot be transcribed. The skill automatically detects this and informs you.
This skill uses the shownotes.io API for:
- Apple Podcast search
- YouTube video search and transcription
- Audio transcription requests
- Transcript database access
All API interactions are handled through the included shownotes_api.py helper script.
shownotes/
βββ SKILL.md # Main skill instructions
βββ scripts/
β βββ shownotes_api.py # API helper functions
βββ references/
βββ api_reference.md # API documentation
- Skill Activation: Claude automatically loads this skill when you mention podcasts, transcripts, or show notes
- Progressive Disclosure: Only loads necessary files when needed
- API Interaction: Uses Python scripts for reliable API calls
- Content Generation: Creates formatted output based on transcript data
Contributions are welcome! Here's how you can help:
- Report Issues: Found a bug? Open an issue
- Suggest Features: Have ideas? Share them in discussions
- Submit PRs: Improvements are always appreciated
# Clone the repository
git clone https://github.com/forcequit/shownotes-skill.git
# Test the skill locally
cd shownotes-skill
/plugin add .This skill is licensed under the Apache License 2.0. See LICENSE for details.
- API Provider: shownotes.io
- Built for: Claude Code & Claude.ai
- Created by: Cooper
- π Documentation
- π¬ Discussions
- π Issue Tracker
If you find this skill useful, please give it a β on GitHub!
Made with β€οΈ for the Claude community