michalparkola/tapestry-skills-for-claude-code

Claude Code skills to download sources (articles, PDFs, YouTube video transcripts)

License:MITLanguage:Shell15333

Deep Analysis

Tapestry提供YouTube、文章、PDF内容提取与Ship-Learn-Next行动计划生成的一站式工作流技能集合

Recommended

Core Features

内容提取

支持YouTube、文章、PDF多种格式内容智能识别与提取

转录下载

自动下载YouTube视频转录,支持多语言字幕与Whisper备选

文章清理

使用Readability/trafilatura去除广告导航,提供纯净文本

行动计划

Ship-Learn-Next框架将被动学习转化为5步可执行迭代

Technical Implementation

Architecture:主技能Tapestry编排四个独立子技能模块,分别处理不同内容类型与转换流程
Execution Flow:
内容类型检测

自动识别URL属于YouTube/文章/PDF中的哪一种

提取内容

调用对应技能下载转录或提取文章文本

生成行动计划

使用Ship-Learn-Next框架从内容中提取5个可执行的reps

保存输出

分别保存原始内容与行动计划为markdown文件

交互反馈

询问用户何时完成第一步Rep以建立承诺

Key Components:
yt-dlpYouTube视频转录下载与处理
Mozilla Readability网页内容提取与清理
OpenAI Whisper无字幕视频的语音转文字备选方案
Ship-Learn-Next将学习内容转化为实行导向的迭代计划
Highlights
  • 统一工作流一条命令完成提取+规划,无需多步骤交互
  • 智能内容识别自动选择合适提取工具,用户零配置
  • Ship-Learn-Next框架强调100次行动胜过100小时学习
  • 支持自动降级多个提取方案确保内容提取成功率
Use Cases
  • 将YouTube教程转化为可执行的技能学习与项目实施计划
  • 提取长篇文章或博客内容后生成周期性行动目标与里程碑
  • 从学习材料直接生成5周内可交付的产品开发迭代
  • 建立个人知识管理系统,将被动学习转化为主动建设
Limitations
  • YouTube转录仅支持有字幕的视频或需额外安装Whisper依赖
  • 文章提取依赖第三方工具需单独安装
Tech Stack
Shell脚本yt-dlpMozilla ReadabilitytrafilaturaOpenAI WhisperMarkdown

Tapestry Skills for Claude Code

A collection of productivity skills for Claude Code that help you work faster and learn better.

Tapestry weaves learning content into action. Extract any content (YouTube, articles, PDFs) and automatically create implementation plans.

Skills Included

0. Tapestry (Master Skill) ⭐

The unified workflow that orchestrates everything. Just say tapestry <URL> and it:

  1. Detects content type (YouTube, article, PDF)
  2. Extracts clean content
  3. Automatically creates a Ship-Learn-Next action plan

One command. Complete workflow. From learning to shipping.

1. YouTube Transcript Downloader

Download and clean YouTube video transcripts with automatic deduplication and readable formatting.

Features:

  • Downloads transcripts using yt-dlp
  • Removes duplicate lines (YouTube VTT format issue)
  • Uses video title for filename
  • Fallback to Whisper transcription if no subtitles available
  • Automatic cleanup of temporary files

Use cases:

  • Get transcripts from educational videos
  • Extract content from tutorials
  • Archive important talks/interviews

2. Article Extractor

Extract clean, readable content from web articles and blog posts, removing ads, navigation, and clutter.

Features:

  • Uses Mozilla Readability or trafilatura for extraction
  • Removes ads, navigation, and newsletter signups
  • Saves as clean plain text
  • Uses article title for filename
  • Multiple extraction methods with automatic fallback

Use cases:

  • Save articles for offline reading
  • Extract tutorial content
  • Archive important blog posts
  • Get clean text without distractions

3. Ship-Learn-Next Action Planner

Transform passive learning content (transcripts, articles, tutorials) into actionable implementation plans using the Ship-Learn-Next framework.

Features:

  • Converts advice into concrete, shippable iterations (reps)
  • Creates 5-rep action plans with timelines
  • Focuses on DOING over studying
  • Includes reflection questions after each rep
  • Saves plan to markdown file

Use cases:

  • Turn YouTube tutorials into action plans
  • Extract implementation steps from articles
  • Create learning quests from course content
  • Build by shipping, not just consuming

Installation

Quick Install (Recommended)

# Clone the repository
git clone https://github.com/yourusername/tapestry-skills-for-claude-code.git

# Run the installation script
cd tapestry-skills-for-claude-code
chmod +x install.sh
./install.sh

Manual Installation

Option 1: Personal Skills (Available in all projects)

# Create personal skills directory if it doesn't exist
mkdir -p ~/.claude/skills

# Copy skills
cp -r tapestry ~/.claude/skills/
cp -r youtube-transcript ~/.claude/skills/
cp -r article-extractor ~/.claude/skills/
cp -r ship-learn-next ~/.claude/skills/

Option 2: Project Skills (Only in specific project)

# In your project directory
mkdir -p .claude/skills

# Copy skills
cp -r /path/to/tapestry-skills-for-claude-code/tapestry .claude/skills/
cp -r /path/to/tapestry-skills-for-claude-code/youtube-transcript .claude/skills/
cp -r /path/to/tapestry-skills-for-claude-code/article-extractor .claude/skills/
cp -r /path/to/tapestry-skills-for-claude-code/ship-learn-next .claude/skills/

Usage

Tapestry (Recommended - Use This!)

The simplest way to use Tapestry skills. One command extracts content and creates your action plan:

"tapestry https://www.youtube.com/watch?v=VIDEO_ID"
"weave https://example.com/article"
"help me plan https://example.com/paper.pdf"
"make this actionable https://blog.com/post"

All these phrases work: tapestry, weave, help me plan, extract and plan, make this actionable

The skill will:

  1. Detect content type (YouTube/article/PDF)
  2. Extract clean content
  3. Create a Ship-Learn-Next action plan automatically
  4. Save both files
  5. Ask: "When will you ship Rep 1?"

YouTube Transcript Downloader

Once installed, Claude will automatically use this skill when you ask to download YouTube transcripts:

"Download the transcript for https://www.youtube.com/watch?v=VIDEO_ID"

The skill will:

  1. Check if yt-dlp is installed (install if needed)
  2. List available subtitles
  3. Try manual subtitles first, then auto-generated
  4. Convert to readable plain text with video title as filename
  5. Remove duplicate lines
  6. Clean up temporary files

Article Extractor

Claude will use this skill when you ask to extract content from a URL:

"Extract the article from https://example.com/blog-post"
"Download this article without the ads"

The skill will:

  1. Check for extraction tools (reader or trafilatura)
  2. Download and extract clean article content
  3. Remove ads, navigation, and clutter
  4. Save as plain text with article title as filename
  5. Show preview of extracted content

Ship-Learn-Next Action Planner

Claude will use this skill when you want to turn content into an action plan:

"Turn this transcript into an implementation plan"
"Make this actionable using the Ship-Learn-Next framework"

The skill will:

  1. Read the content file
  2. Extract actionable lessons
  3. Help you define a specific quest
  4. Design 5 progressive reps (iterations)
  5. Save the complete plan as a markdown file

Requirements

YouTube Transcript Downloader

  • yt-dlp: Automatically installed by the skill (uses Homebrew on macOS, apt on Linux, or pip)
  • Whisper (optional): For transcribing videos without subtitles
    pip3 install openai-whisper
    

Article Extractor

  • reader (recommended): Mozilla's Readability
    npm install -g reader-cli
    
  • trafilatura (alternative): Python-based extractor
    pip3 install trafilatura
    
  • If neither is installed, uses fallback method (less accurate)

Ship-Learn-Next Action Planner

  • No additional requirements (uses built-in tools)

Examples

Example 0: Tapestry Unified Workflow (Recommended)

User: "tapestry https://www.youtube.com/watch?v=dQw4w9WgXcQ"

Claude:
🧵 Tapestry Workflow Starting...
📍 Detected: youtube
📺 Extracting YouTube transcript...
✓ Saved transcript: Never Gonna Give You Up.txt

🚀 Creating action plan...
✓ Quest: Master Video Production Techniques
✓ Saved plan: Ship-Learn-Next Plan - Master Video Production.md

✅ Tapestry Complete!
📥 Content: Never Gonna Give You Up.txt
📋 Plan: Ship-Learn-Next Plan - Master Video Production.md

🎯 Rep 1 (This Week): Film and edit a 60-second video
When will you ship Rep 1?

Example 1: Download and Process a YouTube Video

User: "Download transcript for https://www.youtube.com/watch?v=dQw4w9WgXcQ"

Claude:
✓ Checked available subtitles
✓ Downloaded auto-generated transcript
✓ Converted to readable format
✓ Removed duplicate lines
✓ Saved to: Never Gonna Give You Up.txt
✓ Cleaned up temporary files

Example 2: Extract an Article

User: "Extract https://example.com/how-to-build-saas"

Claude:
✓ Using reader (Mozilla Readability)
✓ Extracted article: How to Build a SaaS in 30 Days
✓ Saved to: How to Build a SaaS in 30 Days.txt

Preview (first 10 lines):
[Clean article text without ads or navigation...]

Example 3: Create an Action Plan

User: "Turn this transcript into an implementation plan"

Claude:
✓ Read transcript: Build a SaaS in 30 Days.txt
✓ Extracted core lessons
✓ Created 5-rep action plan
✓ Saved to: Ship-Learn-Next Plan - Build a SaaS.md

Your quest: Launch a SaaS MVP and get first 10 customers in 4 weeks

Rep 1 (this week): Find 3 proven market opportunities
When will you ship Rep 1?

Philosophy

These skills are built on the principle that learning = doing better, not knowing more.

Ship-Learn-Next Framework

  • Ship: Create something real (code, content, product)
  • Learn: Honest reflection on what happened
  • Next: Plan the next iteration based on learnings

100 reps beats 100 hours of study.

Contributing

Found a bug or want to add a feature? Contributions are welcome!

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-skill)
  3. Commit your changes (git commit -m 'Add amazing skill')
  4. Push to the branch (git push origin feature/amazing-skill)
  5. Open a Pull Request

License

MIT License - see LICENSE file for details

Acknowledgments

  • Ship-Learn-Next framework: Inspired by the ShipLearnNext GPT methodology
  • yt-dlp: Excellent tool for downloading YouTube content
  • OpenAI Whisper: State-of-the-art speech recognition
  • Mozilla Readability: Clean article extraction algorithm
  • trafilatura: Python web scraping and content extraction

Support

Having issues? Please open an issue on GitHub.


Made with Claude Code

Learn more about Claude Code at claude.com/claude-code