voxflow — плагин для Claude Code: озвучка, подкасты, видео

# VoxFlow Skills

> Skill files in this repo are auto-overwritten on each release. For feedback or fixes, please [open an issue](https://github.com/VoxFlowStudio/skills/issues) instead of submitting a PR.

[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
[![npm version](https://img.shields.io/npm/v/voxflow.svg)](https://www.npmjs.com/package/voxflow)
[![6 skills](https://img.shields.io/badge/skills-6-purple.svg)](#what-you-get)
[![Works with](https://img.shields.io/badge/works%20with-Claude%20Code%20%C2%B7%20Cursor%20%C2%B7%20Codex%20%C2%B7%20Gemini-orange.svg)](#install)

![VoxFlow CLI demo](https://github.com/VoxFlowStudio/skills/raw/main/demo.gif)

Voice in your AI workflow. Six skills that let any AI coding agent (Claude Code · Cursor · Codex · Gemini CLI · Cline) speak in 200+ voices, generate podcasts, dub videos, transcribe audio, and turn text into card images or narrated card videos — through one CLI.

**Why VoxFlow over a raw TTS API?** One CLI handles auth, voice search, multi-speaker dialogue, video pipelines, and quota. The skills layer makes it native to whichever agent you're already using — no new context-switch.

## Install

The simplest path — let the VoxFlow CLI auto-detect your agent and run the right command:

```bash
npm install -g voxflow
voxflow skills install
```

It detects Claude Code / Cursor / Codex / Gemini / WorkBuddy / OpenClaw on your `$PATH`, picks the right install command, asks for confirmation, runs it, and prints next steps. Use `--all` to install for every detected agent, or `--for <agent>` to force one.

If you'd rather run the install command directly — **one command for every agent**:

```bash
npx -y skills add VoxFlowStudio/skills --all --yes --global
```

The `skills` npm package detects every AI agent on your machine (Claude Code,
Cursor, Codex CLI, Gemini CLI, Cline, Amp, Antigravity, CodeBuddy, OpenClaw…)
and writes the 6 VoxFlow skills (`hub`, `podcast`, `transcribe`, `video`,
`slice`, `card`) to each agent's standard skill location in a single shot.

## Prerequisites

```bash
npm install -g voxflow
voxflow login          # one-time browser auth
```

## What You Get

Six focused skills, each loaded on demand:

| Skill | Invoked as | What it covers |
|-------|-----------|----------------|
| **hub** | `voxflow:hub` | `say` · `narrate` · `story` · `voices` · auth · quota · feedback |
| **podcast** | `voxflow:podcast` | Multi-speaker AI podcast from topic / URL / script |
| **transcribe** | `voxflow:transcribe` | `asr` · `asr-jobs` · `translate` · `dub` · `video-translate` · `summarize` · `publish` |
| **video** | `voxflow:video` | `picstory` · `present` · `slides` · `explain` · `image` |
| **slice** | `voxflow:slice` | Article → vertical card video (1080×1920); 13 editorial / poster / magazine themes |
| **card** | `voxflow:card` | Text → shareable card images (HTML/CSS + Playwright); 1:1 / 3:4 / 9:16, editorial design system. Optional narrated MP4 video via `voxflow card render` (TTS + FFmpeg, in-project output) |

Use the hub skill as the starting point — it routes to the others automatically.

## Example Interactions

| You say | Agent runs |
|---------|-----------|
| "Read this README out loud" | `voxflow narrate README.md -o readme.mp3` |
| "Make a 5-min podcast on AI agents" | `voxflow podcast "AI agents" --length short` |
| "Dub this tutorial into Japanese" | `voxflow video-translate tutorial.mp4 --to ja` |
| "把这段话合成语音" | `voxflow say "..." -o output.mp3` |
| "生成一个 AI 播客" | `voxflow podcast "topic" --length medium` |
| "把这个视频翻译成日语" | `voxflow video-translate video.mp4 --to ja` |
| "转录这段录音" | `voxflow asr recording.mp3` |
| "做一个 AI 知识短视频" | `voxflow picstory "topic" --style sketchnote` |
| "生成一套演示幻灯片" | `voxflow slides "topic" --slides 8` |

## Skills Layout

```text
voxflow/
  hub/SKILL.md          # TTS, voice search, auth, quota, feedback
  podcast/SKILL.md      # AI dialogue podcast
  transcribe/SKILL.md   # ASR, translation, dubbing
  video/SKILL.md        # AI short video, slides, images
  slice/SKILL.md        # Article → vertical card video (13 themes)
  card/SKILL.md         # Text → shareable card images (1:1 / 3:4 / 9:16)
```

## Registry

```text
registry.json           # VoxFlow CLI add-on recipes index
voxflow/
  dub-anime-jp-zh/      # Anime fan-dub voice preset (JP→ZH)
```

Install a recipe:
```bash
voxflow add dub-anime-jp-zh
```

## Quota

Free tier: 10,000 / month. Check before large jobs:

```bash
voxflow status
```

| Operation | Cost |
|-----------|------|
| `say` (1 call) | ~100 |
| `narrate` (per segment) | ~100 |
| `podcast` (medium) | ~5,000 |
| `picstory` (5 scenes) | ~3,100 |

## Security

- No API keys or tokens in this repository.
- Use `voxflow login` for interactive auth or `VOXFLOW_TOKEN` env var for CI.
- See [SECURITY.md](SECURITY.md) for vulnerability disclosure.

## Links

- [VoxFlow Studio](https://voxflow.studio) — Web app
- [CLI on npm](https://www.npmjs.com/package/voxflow) — `npm install -g voxflow`
- [CLI docs](https://voxflow.studio/docs/cli) — Full command reference