bibi - SKILL.md Agent Skill

name: bibi description: > AI video & audio summarizer + repackager. Summarize YouTube, Bilibili, podcasts, TikTok, Twitter/X, Xiaohongshu, and any online video or audio, then optionally turn the takeaway into a TikTok-style vertical music video. Use when the user wants to summarize a video, extract transcripts/subtitles, get chapter-by-chapter summaries, understand video content quickly, or remix a long-form video into a short vertical MV. Triggers: "summarize this video", "what's this video about", "extract subtitles", "总结这个视频", "帮我看看这个视频讲了什么", "video summary", "podcast notes", "YouTube summary", "B站总结", "get transcript", "video to notes", "video to TikTok MV", "把视频变成 TikTok", "video to song", "做一个 TikTok 视频". Works via bibi CLI (macOS/Windows) or OpenAPI (Linux / any platform without CLI).

BibiGPT — AI Video & Audio Summarizer

Environment Check

Run scripts/bibi-check.sh first. It detects which mode is available:

Mode	When to use	Auth
CLI (`bibi` command)	macOS / Windows / Linux with desktop app	Desktop login or `BIBI_API_TOKEN`
OpenAPI (HTTP calls)	Containers, CI, or any env without CLI	`BIBI_API_TOKEN` only

If neither mode is available, see references/installation.md for setup instructions.

Payment fallback (China): if neither auth is set but the user has an Alipay account, BibiGPT may emit HTTP 402 Payment Required with a Payment-Needed header (AI 收 protocol). The agent can resolve this automatically by installing @alipay/agent-payment, or manually by directing the user to a one-off QR purchase. See references/billing-aipay.md.

Detect 402 deterministically: the bibi CLI prints a stable marker line [HTTP/402 Payment Required] to stderr before any human-readable prompt; direct HTTP callers get status 402 + Payment-Needed header. When either signal appears, route to references/billing-aipay.md instead of treating the call as failed.

Intent Routing

Route the user's request to the appropriate workflow:

User Intent	Workflow
Summarize a video/audio URL	→ `workflows/quick-summary.md`
Chapter-by-chapter breakdown, detailed analysis	→ `workflows/deep-dive.md`
Get subtitles, extract transcript, raw text	→ `workflows/transcript-extract.md`
Turn into article, blog post, 公众号图文, 小红书	→ `workflows/article-rewrite.md`
Turn into TikTok / Reels / Shorts-style music video	→ `workflows/video-to-tiktok-mv.md`
Process multiple URLs, batch summarize	→ `workflows/batch-process.md`
Research a topic across multiple videos	→ `workflows/research-compile.md`
Save to Notion, Obsidian, export notes	→ `workflows/export-notes.md`
Analyze visual content, slides, on-screen text	→ `workflows/visual-analysis.md`
Check current account, plan, or remaining minutes	→ `workflows/account-check.md`
Browse / search saved videos, "what have I summarized"	→ `workflows/library-browse.md`
Manage channel subscriptions, list/sub/unsub, RSS preview	→ `workflows/channels-manage.md`
What's new across my subscriptions, latest feed, daily digest	→ `workflows/feed-latest.md`
Manage collections, list/create/share saved videos as a set	→ `workflows/collections-manage.md`
Manage personal notes on saved videos, edit summaries	→ `workflows/notes-manage.md`
Generate mindmap, visual analysis, custom-prompt summary, Notion export, collection chat	→ `workflows/advanced-tools.md`
HTTP 402 / "需要付款" / Alipay AI 钱包 / no token + China user	→ `references/billing-aipay.md`

Disambiguation

If the user's intent matches more than one workflow, ask one clarifying question before routing.
If it matches none, ask what they are trying to accomplish. Do not guess.
If the user just pastes a URL with no context, default to workflows/quick-summary.md.

Local File Support

The bibi CLI directly accepts local file paths (no upload needed):

bibi summarize "/path/to/video.mp4"
bibi summarize "/path/to/podcast.mp3"

For API mode (no CLI), guide the user to upload the file to a publicly accessible URL (OSS, S3, etc.) first, then pass that URL to the API. See references/supported-platforms.md for details.

Direct CLI Operations

Use progressive help to discover options: bibi --help → bibi summarize --help → run.

For simple, single-command requests that don't need a full workflow:

bibi summarize "<URL>"              # Quick summary (URL or local file path)
bibi summarize "<URL>" --chapter    # Chapter summary
bibi summarize "<URL>" --subtitle   # Transcript only
bibi summarize "<URL>" --json       # Full JSON response
bibi auth check                     # Check auth status
bibi me                             # Get account, plan, remaining minutes
bibi commands                       # List all manifest-driven commands

See references/cli.md for all commands and flags.

References

Document	Contents
`references/cli.md`	All CLI commands, flags, output formats
`references/api.md`	OpenAPI endpoints, curl examples, response schemas
`references/installation.md`	Desktop app install, skill install, auth setup, MCP config
`references/supported-platforms.md`	Supported URL types, platform notes, duration limits
`references/billing-aipay.md`	Alipay AI收 (HTTP 402) per-call payment fallback for China users