Methodologydesign

bibi

Methodology skill.md.

jimmylv/bibigpt-skill

Install

npx skills add https://github.com/jimmylv/bibigpt-skill --skill bibi

Use with your agent

Install the bibi skill, then use it as build context. Run: npx skills add https://github.com/jimmylv/bibigpt-skill --skill bibi. Then read the installed skill.md and follow its guidance to build or refactor my project.

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.

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`
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`

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 call 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