Sandbox
Sign in
@JimLiu/baocut
Skills#Claude Code#Codex#Any agent#Coding#Writing#Docs

BaoCut skill for Claude Code and Codex

BaoCut agent skill for driving BaoCut's local `bcut` CLI and Subtitle Studio from an agent. It routes requests through `skills/baocut/SKILL.md`, then uses the resolver in `bin/baocut` to find the right CLI on macOS or Windows. It supports transcription, subtitle creation and translation, speaker review, timeline and overlay edits, and export. The repo includes guides, templates, and a pinned CLI release so the agent can work with the installed app, PATH, or downloaded build.

491 stars•28 forks•JavaScript•Updated 17d ago
Who it's for

Builders who want Claude Code, Codex, or another skills.sh agent to control BaoCut from natural language.

What it delivers

You can turn media tasks like transcription, subtitle translation, and export into agent-driven commands instead of manual app work.

What it does

Natural-language BaoCut control

Lets your agent drive BaoCut tasks such as transcribe, subtitle, translate, review speakers, edit timelines and overlays, and export.

CLI resolution across installs

Finds the right `bcut` binary from an explicit path, development builds, BaoCut.app, `PATH`, or verified release downloads.

Cross-agent install path

Supports global install with `skills.sh` and manual linking into Claude Code or other compatible agent skill folders.

Task guides and templates

Includes per-task references and browser-based Subtitle Studio templates under `references/` and `templates/`.

Windows CLI variant selection

Uses a Windows resolver and GPU/CPU probe to pick a compatible CLI build when needed.

How to get it

  1. 1Run
    npx skills add JimLiu/baocut -g -a claude-code codex -y
  2. 2Run
    git clone https://github.com/JimLiu/baocut.git ~/.agents/skills/baocut-src
ln -sfn ~/.agents/skills/baocut-src/skills/baocut ~/.agents/skills/baocut
# link it for each agent you use, e.g. Claude Code:
mkdir -p ~/.claude/skills
ln -sfn ~/.agents/skills/baocut ~/.claude/skills/baocut

README

BaoCut agent skill

Give your AI coding agent the power to drive BaoCut — transcribe, add and translate subtitles, review speakers, edit timelines and overlays, and export — all from natural language. This is the open-source Agent Skill for BaoCut's local bcut CLI and browser-based Subtitle Studio.

Works with Claude Code, Codex, and any skills.sh-compatible agent.

Requirements

  • macOS — install BaoCut from baocut.app. The skill uses the CLI bundled in BaoCut.app; on Apple silicon it can also download the signed standalone CLI pinned to the skill release.
  • Windows x64 — the resolver installs a verified unsigned-preview CLI when no compatible override, PATH entry, or cache exists. It uses nvidia-smi to select the bundled CUDA 13 build for an NVIDIA GPU with compute capability 8.0+ and driver 580+, otherwise it selects the CPU build. No CUDA Toolkit is required.
  • Node.js — only for the one-command install below (download). The manual steps need no Node.

Install

Recommended — skills.sh

npx skills add JimLiu/baocut -g -a claude-code codex -y

This installs the skill globally to ~/.agents/skills/baocut and links it for Claude Code and Codex.

Manual (no Node.js)

git clone https://github.com/JimLiu/baocut.git ~/.agents/skills/baocut-src
ln -sfn ~/.agents/skills/baocut-src/skills/baocut ~/.agents/skills/baocut
# link it for each agent you use, e.g. Claude Code:
mkdir -p ~/.claude/skills
ln -sfn ~/.agents/skills/baocut ~/.claude/skills/baocut

Use it

Once installed, just ask your agent — for example:

  • Claude Code — "Transcribe and translate the subtitles of talk.mp4 to Chinese," or the Chinese equivalent 转写并翻译字幕. You can also type /baocut.
  • Codex — reference the baocut skill in your prompt; it drives the baocut CLI.

Under the hood the agent uses the bundled resolver to run commands like:

skills/baocut/bin/baocut --json auto talk.mp4 --lang zh
skills/baocut/bin/baocut export <projectId> --srt --translated --lang zh

The resolver honors an explicit CLI path, development builds, the CLI inside BaoCut.app, bcut on PATH, and verified release caches/downloads in that order.

Layout

skills/baocut/
  SKILL.md          # agent entry point (router)
  references/       # per-task guides (orchestration, editing, export, …)
  templates/        # browser-based Subtitle Studio
  cli-release.json  # immutable standalone CLI pin
  bin/baocut        # resolves, verifies, and runs the matching CLI
  bin/baocut.ps1    # native Windows resolver
  bin/detect-windows-cli-variant.ps1 # CPU/CUDA environment probe

Links

License

MIT.

Files in the repo

Repository payload•4 top-level entries
  • skills
  • .gitignore
  • LICENSE
  • README.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

obra/
superpowers
obra/superpowersSkills

An agentic skills framework & software development methodology that works.

285k
1 add
Graphify-Labs/graphifySkills

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

117k
1 add
Vincentwei1021/
anything2explainer
Vincentwei1021/anything2explainerSkills

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666
career-ops-hq/career-opsSkills

Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

71k