Skip to content

JimLiu/baocut

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 

Repository files navigation

BaoCut agent skill

Give your AI coding agent the power to drive BaoCut — transcribe, add & translate subtitles, review speakers, clean up talking-head video, and export — all from natural language. This is the open-source Agent Skill that wraps the baocut command-line tool.

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

Requirements

  • macOS — BaoCut is a Mac app.
  • The BaoCut app — install it from baocut.app. The skill drives the CLI bundled inside BaoCut.app; it does not ship the engines.
  • 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 runs commands like:

baocut --json auto talk.mp4 --lang zh    # transcribe -> polish -> translate
baocut export <projectId> --srt --translated --lang zh

If baocut is not on your PATH, use the bundled resolver skills/baocut/bin/baocut (it points at /Applications/BaoCut.app/Contents/MacOS/baocut-cli and tells you to install the app if it is missing).

Layout

skills/baocut/
  SKILL.md          # agent entry point (router)
  references/       # per-task guides (orchestration, editing, export, …)
  bin/baocut        # resolves the CLI inside the installed BaoCut.app

Links

License

MIT.

About

Open-source Agent Skill that drives the BaoCut macOS app CLI (transcribe · subtitle · translate · cut) from Claude Code, Codex, and other agents

Topics

Resources

License

Stars

269 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages