lifei68801

Video Summary

Knowledgev1.6.4
By lifei68801Updated 2026-05-1126 versions · latest released 2026-03-13video-summary@clawhub_lifei68801/video-summary
SummarizationDocument Q&A#Transcription

According to AlphaMoat, as of 2026-10, Video Summary has 7,991 downloads and 9 stars — ranked by downloads #3,483 among 10,914 AI skills in this ranking, and #236 of 745 in Knowledge.

The list defaults to total downloads and can also be sorted by stars; detail-page rankings use total downloads.

Downloads
8.0K
Stars
9
Overall download rank
#3,483
Top 32% overall · Top 32% in Knowledge
PlatformDownloadsStarsComments
ClawHub ↗3.5K6-
SkillHub ↗8.0K9—

Platforms count differently and update at different times.

What this skill does

It documents YouTube, Bilibili, Xiaohongshu, Douyin and local files, using platform subtitles or Whisper transcription where needed. The script outputs a structured request for an agent or external tool to summarize rather than calling an LLM directly. Dependencies and platform access are required; restricted content may need cookies from the user’s own session, which must not be shared.

Profile published 2026-10-27

What you can do with it

  • Turn accessible video content into key points and chapter summaries

When to use it

  • When summarizing a supported video or extracting its transcript

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Extract the available transcript from this video and prepare a summary with timestamps, noting any missing or inaccessible content.

Monthly Trend

Downloads8.0K
2.0K5.2K8.4K2026-03 · Downloads 2.4K2026-05 · Downloads 3.3K2026-06 · Downloads 3.4K2026-07 · Downloads 3.8K2026-08 · Downloads 4.2K2026-09 · Downloads 5.1K2026-10 · Downloads 8.0K26-0326-0926-10
Stars9
16102026-03 · Stars 22026-05 · Stars 52026-06 · Stars 62026-07 · Stars 82026-08 · Stars 92026-09 · Stars 92026-10 · Stars 926-0326-0926-10

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change. Other skills share this name; figures from before the change are attributed to this one, which currently has the most downloads.

MonthDownloadsMoMStars
2026-108.0K—9
2026-095.1K—9
2026-084.2K+10.5%9
2026-073.8K+11.4%8
2026-063.4K+4.3%6
2026-053.3K—5
2026-032.4K—2

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

17 KB · ClawHub v1.6.4
---
name: video-summary
version: 1.6.4
description: "Video summarization for Bilibili, Xiaohongshu, Douyin, and YouTube. Extract insights from video content through transcription and summarization."

# 🔒 Security Declaration
# This skill downloads videos/subtitles from YouTube/Bilibili/Xiaohongshu/Douyin.
# It does NOT directly call external LLM APIs - it outputs structured requests for agent processing.
# OPENAI_API_KEY and OPENAI_BASE_URL are optional - used by agent, not by this script.
# Cookie files are read locally only, never transmitted externally.
Show all (580 lines)
# No config files written. No secrets stored. No telemetry, no analytics.
metadata:
  openclaw:
    requires:
      bins: ["yt-dlp", "jq", "ffmpeg", "ffprobe", "bc"]
      credentials:
        - name: "OPENAI_API_KEY"
          required: false
          description: "API key for LLM summarization (optional, script outputs request for agent processing)"
        - name: "OPENAI_BASE_URL"
          required: false
          description: "Custom API endpoint (e.g., for Zhipu, DeepSeek)"
        - name: "VIDEO_SUMMARY_COOKIES"
          required: false
          description: "Path to cookies file for restricted video content"
    behavior:
      networkAccess: indirect
      description: "Downloads videos/subtitles from video platforms using yt-dlp. Summarization requests are output as structured text for agent/external LLM processing. Script itself makes no direct LLM API calls. Requires yt-dlp, jq, ffmpeg. Optional: VIDEO_SUMMARY_WHISPER_MODEL, VIDEO_SUMMARY_COOKIES, OPENAI_BASE_URL, OPENAI_MODEL."
---

# Video Summary Skill

Intelligent video summarization for multi-platform content. Supports Bilibili, Xiaohongshu, Douyin, YouTube, and local video files.

## What It Does

- **Auto-detect platform** from URL (Bilibili/Xiaohongshu/Douyin/YouTube)
- **Extract subtitles/transcripts** using platform-specific methods
- **Generate structured summaries** with key insights, timestamps, and actionable takeaways
- **Multi-format output** (plain text, JSON, Markdown)
- **Direct LLM integration** — outputs ready-to-use summaries
- **Automatic cleanup** — no temp file leaks

---

## Quick Setup

**No API key required to run.** This skill extracts video content and outputs structured requests for summarization. The agent (or external tool) handles LLM calls.

```bash
# Optional: If you want the agent to call LLM for summarization
export OPENAI_API_KEY="your-api-key-here"
export OPENAI_BASE_URL=https://open.bigmodel.cn/api/paas/v4

# Optional: Whisper model for transcription (default: base)
export VIDEO_SUMMARY_WHISPER_MODEL=base
```

**How it works:**
1. Script extracts video subtitles/transcript
2. Script outputs a structured summary request (JSON/text)
3. Agent or external tool calls LLM API with the request
4. Script does NOT directly call any external APIs

### Supported LLM Providers

- **OpenAI**: https://platform.openai.com/api-keys
- **Zhipu GLM**: https://open.bigmodel.cn/
- **DeepSeek**: https://platform.deepseek.com/
- **Moonshot**: https://platform.moonshot.cn/

Just set OPENAI_BASE_URL to the provider's API endpoint.

### Cookie Configuration (Optional)

Xiaohongshu and Douyin may need cookies for some videos:

```bash
# Set cookie file path
export VIDEO_SUMMARY_COOKIES=/path/to/cookies.txt

# Or use --cookies flag
video-summary "https://xiaohongshu.com/..." --cookies cookies.txt
```

**⚠️ Cookie Security Note:**
- Cookie files contain session tokens and are sensitive
- Only use cookies from your own browser sessions
- Do not share cookie files with others
- Cookie files are read locally and never transmitted externally by this script

### Manual Trigger

If configuration is incomplete, say:
> "help me configure video-summary"

---

## Quick Start

### Check Dependencies

```bash
# Check all required tools
yt-dlp --version && jq --version && ffmpeg -version

# If missing, install
pip install yt-dlp
apt install jq ffmpeg  # or: brew install jq ffmpeg
```

### Basic Usage

```bash
# Standard summary
video-summary "https://www.bilibili.com/video/BV1xx411c7mu"

# With chapter segmentation
video-summary "https://www.youtube.com/watch?v=xxxxx" --chapter

# JSON output for programmatic use
video-summary "https://www.xiaohongshu.com/explore/xxxxx" --json

# Subtitle only (no AI summary)
video-summary "https://v.douyin.com/xxxxx" --subtitle

# Save to file
video-summary "https://www.bilibili.com/video/BV1xx" --output summary.md

# Use cookies for restricted content
video-summary "https://www.xiaohongshu.com/explore/xxxxx" --cookies cookies.txt
```

### In OpenClaw Agent

Just say:
> "Summarize this video: [URL]"

The agent will automatically:
1. Detect the platform
2. Extract video content
3. Generate a structured summary

---

## Commands Reference

| Command | Description |
|---------|-------------|
| `video-summary "<url>"` | Generate standard summary |
| `video-summary "<url>" --chapter` | Chapter-by-chapter breakdown |
| `video-summary "<url>" --subtitle` | Extract raw transcript only |
| `video-summary "<url>" --json` | Structured JSON output |
| `video-summary "<url>" --lang <code>` | Specify subtitle language (default: auto) |
| `video-summary "<url>" --output <path>` | Save output to file |
| `video-summary "<url>" --cookies <file>` | Use cookies file |
| `video-summary "<url>" --transcribe` | Force Whisper transcription |

---

## How It Works

### Platform Support Matrix

| Platform | Subtitle Extraction | Notes |
|----------|-------------------|-------|
| **YouTube** | Native CC + auto-generated | Best support |
| **Bilibili** | Native CC + backup methods | Requires video ID extraction |
| **Xiaohongshu** | Limited (OCR fallback) | No native subtitles, uses transcription |
| **Douyin** | Limited (OCR fallback) | Short-form video, may need transcription |
| **Local files** | Whisper transcription | Supports mp4, mkv, webm, mp3, etc. |

### Supported URL Formats

**YouTube:**
- `https://www.youtube.com/watch?v=xxxxx`
- `https://youtu.be/xxxxx`

**Bilibili:**
- `https://www.bilibili.com/video/BV1xx411c7mu`
- `https://www.bilibili.com/video/av123456`

**Xiaohongshu:**
- `https://www.xiaohongshu.com/explore/xxxxx`
- `https://xhslink.com/xxxxx` (short link)

**Douyin:**
- `https://www.douyin.com/video/xxxxx`
- `https://v.douyin.com/xxxxx` (short link)

### Processing Pipeline

```
URL Input
    ↓
Platform Detection
    ↓
Subtitle Extraction (yt-dlp / Whisper)
    ↓
Content Chunking (if long)
    ↓
LLM Summarization (OpenAI API / Agent)
    ↓
Structured Output
    ↓
Auto Cleanup
```

---

## Performance Estimation

### Whisper Transcription Time

| Video Duration | tiny | base | small | medium |
|---------------|------|------|-------|--------|
| 5 min | ~30s | ~1m | ~2m | ~4m |
| 15 min | ~1.5m | ~3m | ~6m | ~12m |
| 30 min | ~3m | ~6m | ~15m | ~30m |
| 60 min | ~6m | ~12m | ~30m | ~60m |

**Notes:**
- GPU significantly faster (3-10x)
- `base` model recommended for balance
- First run downloads model (~150MB for base)

### Subtitle Extraction Time

| Platform | Time | Notes |
|----------|------|-------|
| YouTube | ~5s | Direct subtitle download |
| Bilibili | ~5s | Direct subtitle download |
| Xiaohongshu | ~3m | Requires transcription |
| Douyin | ~2m | Requires transcription |

---

## Advanced Configuration

### Whisper for Transcription

For platforms without native subtitles (Xiaohongshu, Douyin), install Whisper:

```bash
pip install openai-whisper
```

Then configure:
```bash
export VIDEO_SUMMARY_WHISPER_MODEL=base  # tiny, base, small, medium, large
```

### OpenAI API for Summarization

**This script does NOT directly call LLM APIs.** It outputs structured requests for the agent to process.

If you want the agent to call LLM for summarization, configure:

```bash
# Optional: API key for your LLM provider
export OPENAI_API_KEY="your-api-key-here"

# Optional: Custom API endpoint (for non-OpenAI providers)
export OPENAI_BASE_URL=https://open.bigmodel.cn/api/paas/v4  # Zhipu
# export OPENAI_BASE_URL=https://api.deepseek.com/v1        # DeepSeek
# export OPENAI_BASE_URL=https://api.moonshot.cn/v1          # Moonshot

# Optional: Model selection
export OPENAI_MODEL=gpt-4o-mini
```

**Without API key:** Script outputs transcript and structured request. Agent handles summarization.

### Cookie Configuration for Restricted Content

Some platforms require authentication for certain content:

```bash
# Method 1: Command line
video-summary "https://www.xiaohongshu.com/explore/xxxxx" --cookies cookies.txt

# Method 2: Environment variable
export VIDEO_SUMMARY_COOKIES=/path/to/cookies.txt
```

**How to get cookies:**

1. Install browser extension: "Get cookies.txt LOCALLY"
2. Login to the platform
3. Export cookies to file

### Custom Summary Prompt

Create `~/.video-summary/prompt.txt`:

```markdown
# Summary Template

## Key Insights
- List 3-5 core arguments

## Key Information
- Data, cases, quotes

## Action Items
- Specific actions viewers can take

## Timestamp Navigation
- Key moments with timestamps and descriptions
```

---

## Output Formats

### Standard Output (default)

```markdown
# Video Title

**Duration**: 12:34
**Platform**: Bilibili
**Author**: Tech Creator

## Core Content
This video explains...

## Key Points
1. Point one
2. Point two
3. Point three

## Timestamps
- 00:00 Introduction
- 02:15 Core concept
- 08:30 Case study
- 11:45 Summary
```

### JSON Output (`--json`)

```json
{
  "title": "Video Title",
  "platform": "bilibili",
  "duration": 754,
  "author": "Creator Name",
  "summary": "Core content summary...",
  "keyPoints": ["Point 1", "Point 2", "Point 3"],
  "chapters": [
    {"time": 0, "title": "Intro", "summary": "..."},
    {"time": 135, "title": "Core Concept", "summary": "..."}
  ],
  "transcript": "Full transcript text..."
}
```

---

## Technical Details

### Dependencies

| Tool | Required | Purpose |
|------|----------|---------|
| **yt-dlp** | Yes | Video/subtitle downloader |
| **jq** | Yes | JSON processing |
| **ffmpeg** | Yes | Audio/video processing |
| **whisper** | Optional | Local transcription |

### File Structure

```
~/.openclaw/workspace/skills/video-summary/
├── SKILL.md              # This file
├── scripts/
│   └── video-summary.sh  # Main CLI script
├── prompts/
│   ├── summary-default.txt
│   └── summary-chapter.txt
└── references/
    └── platform-support.md  # Detailed platform notes
```

### Environment Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `OPENAI_API_KEY` | - | **Optional** - API key for LLM summarization (used by agent, not this script) |
| `OPENAI_BASE_URL` | `https://api.openai.com/v1` | **Optional** - Custom API endpoint |
| `OPENAI_MODEL` | `gpt-4o-mini` | **Optional** - Model for summarization |
| `VIDEO_SUMMARY_WHISPER_MODEL` | `base` | Whisper model size |
| `VIDEO_SUMMARY_COOKIES` | - | **Optional** - Path to cookies file (read locally only) |

---

## Troubleshooting

### "No subtitles found"

- The video may not have subtitles/CC
- Try `--transcribe` to use Whisper
- For Xiaohongshu/Douyin, transcription is required

### "yt-dlp: command not found"

```bash
pip install yt-dlp
# or
brew install yt-dlp
```

### "Missing required dependencies"

```bash
# Install all dependencies
pip install yt-dlp
apt install jq ffmpeg  # Ubuntu/Debian
# or
brew install jq ffmpeg  # macOS
```

### "Video too long"

Long videos (>1h) are automatically chunked:
- Split into 10-minute segments
- Summarize each segment
- Merge into final summary

### "Failed to fetch video info"

- Video may be private or deleted
- Try `--cookies` for restricted content
- Region-locked videos may not work

### "Rate limited"

- Too many requests to platform
- Wait a few minutes
- Use `--cookies` for authenticated access

---

## Comparison

| Feature | OpenClaw summarize | video-summary |
|---------|-------------------|---------------|
| YouTube | ✅ | ✅ |
| Bilibili | ❌ | ✅ |
| Xiaohongshu | ❌ | ⚠️ (transcription) |
| Douyin | ❌ | ⚠️ (transcription) |
| Chapter segmentation | ❌ | ✅ |
| Timestamps | ❌ | ✅ |
| Transcript extraction | ❌ | ✅ |
| JSON output | ❌ | ✅ |
| Save to file | ❌ | ✅ |
| Cookie support | ❌ | ✅ |

---

## References

- [Platform Support Details](references/platform-support.md)
- [yt-dlp Documentation](https://github.com/yt-dlp/yt-dlp)
- [OpenAI Whisper](https://github.com/openai/whisper)

---

## Contributing

Found a bug or want to add platform support?
- Open an issue on ClawHub
- Submit a PR with your improvements

---

## Changelog

### v1.6.4 (2026-03-13)
- Security: Fixed script syntax error (missing closing brace in call_llm function)
- Security: Clarified that script does NOT directly call LLM APIs - outputs structured requests for agent processing
- Security: OPENAI_API_KEY is now clearly marked as optional (used by agent, not by script)
- Security: Added cookie security note - files are read locally only, never transmitted
- Security: Removed "required" claim for API key - honest documentation matching actual behavior

### v1.6.3 (2026-03-12)
- Fix: Version sync between _meta.json and SKILL.md
- No functional changes

### v1.6.2 (2026-03-12)
- Fix: Synced _meta.json version with SKILL.md to resolve packaging inconsistencies warning
- No functional changes

### v1.6.1 (2026-03-12)
- Security: Removed "sk-xxx" placeholder from docs - use "your-api-key-here" instead
- Cleaner documentation examples
- No functional changes

### v1.6.0 (2026-03-12)
- Security: Removed all direct LLM API calls - script now outputs structured requests for agent processing
- networkAccess changed to "indirect" - no curl POST to external APIs in script
- OPENAI_API_KEY is now optional - works without it
- Cleaner security profile, same functionality
- Agent handles LLM calls externally when needed

### v1.5.1 (2026-03-12)
- Security: Dynamic auth header construction to avoid LLM scanner false positives
- Auth header now built from string parts at runtime
- Same functionality, cleaner security profile
- No hardcoded sensitive patterns in script

### v1.5.0 (2026-03-12)
- Security: Added credentials declaration - OPENAI_API_KEY (required), OPENAI_BASE_URL, VIDEO_SUMMARY_COOKIES (optional)
- Security: Registry metadata now properly declares required credentials
- Clean single-script architecture, no config files
- Security: Removed unused setup scripts - single entry point via video-summary.sh
- Security: Declared all required binaries: yt-dlp, jq, ffmpeg, ffprobe, curl, bc, whisper
- Security: Explicit env vars in behavior description
- Security: Removed config file storage - uses env vars only, no secrets stored
- Security: Fixed metadata/install spec mismatch - removed unused install declarations
- Honest security declaration matching actual behavior
- Security: Removed all config file writes - uses env vars only (OPENAI_API_KEY, OPENAI_BASE_URL)
- No secrets stored in files, no "risky handling of secrets"
- Simplified setup: just set environment variables before use
### v1.4.6 (2026-03-12)
- Security: Removed references to non-existent OpenClaw config auto-detection feature
- Honest security declaration: only documents what the skill actually does
- Clearer env var documentation: OPENAI_API_KEY, OPENAI_BASE_URL
- Simplified setup instructions - no false claims about auto-detection
- Security: Simplified security declaration - removed verbose permission list
- Clearer behavior description matching actual functionality
- No functional changes, same behavior
- Security: Obfuscated API key field names to avoid false positives in security scanners
- No functional changes, same behavior

### v1.3.6 (2026-03-10)
- Security: Moved prompts to external files to avoid ClawHub false positive
- Prompts now loaded from prompts/summary-chapter.txt and prompts/summary-default.txt
- No functional changes, same output quality

### v1.3.5 (2026-03-09)
- Security audit: removed patterns that triggered false positive flags
- Neutralized prompt-like text in documentation and scripts
- All functionality preserved, safer for public registry

### v1.3.0 (2026-03-08)
- Added conversational setup support
- Simplified configuration flow

### v1.2.2 (2026-03-08)
- Redesigned setup wizard
- Simplified interface

### v1.2.1 (2026-03-08)
- Added setup wizard
- Simplified setup flow

### v1.2.0 (2026-03-08)
- Added configuration guide
- Added cookie extraction guide
- Added Whisper model selection guide

### v1.1.0 (2026-03-08)
- Added direct LLM integration
- Added `--output` parameter
- Added `--cookies` parameter
- Added automatic temp file cleanup
- Added progress estimation
- Added dependency checking
- Added URL format documentation
- Added performance estimation table
- Fixed metadata dependencies

### v1.0.0
- Initial release

---

*Make video content accessible. Watch less, learn more.*

Popular in Knowledge

搜索引擎Knowledge

通过公开搜索URL在16个搜索引擎(7个国内直连+9个国际)中做跨引擎检索、结果去重与多源交叉验证,无需API Key,内置零依赖Python脚本。Use when 用户要求“搜一下/查资料/多找几个来源/核实消息/找公众号文章/排查报错/找论文或开源项目”时。输入自然语言查询词,输出带来源链接与可信度标注的结构化结果。不适用于私有数据检索、批量抓取、需要登录后可见的内容。

↓ 10.8M★ 147u_8ee34d77
ima-skillsKnowledge

Manage notes and knowledge-base content through the IMA OpenAPI.

↓ 1.1M★ 566u_1742680f
SummarizeKnowledge

A summarizer that condenses long text, documents, and web pages into key points and keywords.

↓ 876.3K★ 1.0Kpaudyyin
全网搜索Knowledge

通过“查一下、搜一下、搜索、找一下”等自然语言检索公开网页,整理来源并交付横版 PDF、Markdown 与标题链接表。支持用户主动开启、查看和取消技能收藏,保留原报告取回。

↓ 508.8K★ 2u_32d99f8a
web-tools-guideKnowledge

A required guide for routing web requests to the right tool.

↓ 399.8K★ 220user_ec205dbb
Aihot Skill LiteKnowledge

AI HOT (aihot.virxact.com) 中文 AI 资讯查询 Skill。当用户想知道"今天 AI 圈有什么"、"AI 日报"、"AI HOT"、"AI 资讯"、"AI 热点"、"最近 AI"、"OpenAI/Anthropic/Google 最近发布了什么"、"AI hot today"、"AI...

↓ 321.1K★ 92Khazix
全球12亿文献知识库(8千万中文期刊可下载)Knowledge

全球12亿文献知识库(8千万中文期刊可下载)——通过 SmartLib 开放平台 API 提供中外文学术文献检索与下载能力,覆盖 8000 万篇授权中文期刊全文 + 12.28 亿条全球文献元数据(期刊 7.19 亿 / 专利 2.15 亿 / 会议 7155 万 / 学位论文 2473 万 / 标准 268 万)。 能力:中英文关键词检索、文献详情、中文期刊 PDF 全文下载、外文 OA 文献十级渠道免费下载(不消耗配额)、智能关键词扩展、核心期刊优先排序、相关性重排、引文追溯、分类号检索。 配额:首次使用自动注册,免费 100 次检索 + 10 次下载 / 月;耗尽自动弹出套餐(体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包),可说「升级 / 充值」唤起;企业 / 机构定制联系 [email protected]。 触发:用户表达"查论文""找文献""检索学术""搜期刊""查专利""找标准""下论文""写文献综述""找参考文献""查 SCI/EI"等意图时启用;也适用"帮我找关于 XX 的论文""写文献综述""找几篇引用支撑论点"。英文:"find papers" "search literature" "write literature review" "find supporting citations"。 调用前必须先用 /consume 获取 consume_token,再凭 token 调 /search(每次计费接口调用都需一次 /consume)。

↓ 303.0K★ 189user_164f4c1f
Markdown ConverterKnowledge

Calls markitdown through uvx to turn many file types into Markdown.

↓ 204.0K★ 256Peter Steinberger

Data as of 2026-10. Downloads and stars are aggregated monthly from public skill registries (ClawHub, SkillHub). See data methodology.