---
slug: "subtitle-translator-skill"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/saidsurucu/subtitle-translator-skill@master/README.md"
repo: "https://github.com/saidsurucu/subtitle-translator-skill"
source_file: "README.md"
branch: "master"
---
# 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