subtitle-translator-skill

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# Subtitle Translator Skill

A Claude Code skill for translating subtitle files using AI. Uses Claude Code as orchestrator and Antigravity CLI (`agy`) as the translation engine.

## Why Claude Code + Antigravity CLI?

Antigravity is excellent at translation — natural, fluent, and context-aware. Claude is excellent at agentic workflows — orchestrating multi-step processes, managing files, and running verification checks. This skill combines the best of both: Claude manages the workflow while Antigravity does the actual translation.

## Why?

Streaming platform subtitle translations are often terrible. This skill produces natural, context-aware translations by building a glossary first, then translating with that context, and running consistency checks afterward.

Supports all subtitle formats (SRT, ASS, SSA, VTT, SUB, SBV) and all languages.

## How It Works

1. **Glossary Creation** — Antigravity reads all subtitle files and builds a translation glossary with character names, recurring terms, and tone guidelines
2. **Glossary Review** — You review and correct the glossary before translation begins
3. **Translation** — Each file is sent to Antigravity one by one with the glossary for context-aware translation
4. **Verification** — Block counts, timecodes, and formatting tags are checked
5. **Consistency Check** — All translations are reviewed together for cross-episode consistency
6. **Technical Check** (optional) — Line length, line count, and other platform-specific rules

## Prerequisites

1. Install [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and [Antigravity CLI](https://antigravity.google) (`agy` command)
2. Run each one once and complete the login/authentication process

## Installation

Give this repo's URL to Claude Code and tell it to install the skill:

```
Install this skill: https://github.com/saidsurucu/subtitle-translator-skill
```

## Usage

1. Put your subtitle files in a folder
2. Open Claude Code in that folder
3. Tell Claude Code to translate your subtitles — the skill activates automatically

Claude Code will ask you for:
- Target language
- Show/movie details (title, genre, characters, tone)
- Timecode mode (preserve or retimed)
- Song lyrics preference (translate or keep original)

## License

MIT

Subtitle Translator Skill

A Claude Code skill for translating subtitle files using AI. Uses Claude Code as orchestrator and Antigravity CLI (agy) as the translation engine.

Why Claude Code + Antigravity CLI?

Antigravity is excellent at translation — natural, fluent, and context-aware. Claude is excellent at agentic workflows — orchestrating multi-step processes, managing files, and running verification checks. This skill combines the best of both: Claude manages the workflow while Antigravity does the actual translation.

Why?

Streaming platform subtitle translations are often terrible. This skill produces natural, context-aware translations by building a glossary first, then translating with that context, and running consistency checks afterward.

Supports all subtitle formats (SRT, ASS, SSA, VTT, SUB, SBV) and all languages.

How It Works

Glossary Creation — Antigravity reads all subtitle files and builds a translation glossary with character names, recurring terms, and tone guidelines
Glossary Review — You review and correct the glossary before translation begins
Translation — Each file is sent to Antigravity one by one with the glossary for context-aware translation
Verification — Block counts, timecodes, and formatting tags are checked
Consistency Check — All translations are reviewed together for cross-episode consistency
Technical Check (optional) — Line length, line count, and other platform-specific rules

Prerequisites

Install Claude Code and Antigravity CLI (agy command)
Run each one once and complete the login/authentication process

Installation

Give this repo's URL to Claude Code and tell it to install the skill:

Install this skill: https://github.com/saidsurucu/subtitle-translator-skill

Usage

Put your subtitle files in a folder
Open Claude Code in that folder
Tell Claude Code to translate your subtitles — the skill activates automatically

Claude Code will ask you for:

Target language
Show/movie details (title, genre, characters, tone)
Timecode mode (preserve or retimed)
Song lyrics preference (translate or keep original)

License

MIT