Not in the top 1,000 by GitHub stars

MaKTaiL/gemini-srt-translator

Python tool for translating subtitles using Google Gemini AI

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

`gemini_srt_translator/SKILL.md`

Week of Nov 2, 2026 · +0 / −0 lines

Before Network or broad shell → After Network or broad shell

1b9135705b9f → 1b9135705b9f

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → 1b9135705b9f

No earlier version was observed for comparison.

Compare on GitHub

`skills/subtitle-translator/SKILL.md`

Week of Nov 2, 2026 · +0 / −0 lines

Before Instructions only → After Instructions only

1b9135705b9f → 1b9135705b9f

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Instructions only

First observation → 1b9135705b9f

No earlier version was observed for comparison.

Compare on GitHub

View on GitHub Add to my skills

Verified commit 1b9135705b9ffbd5491942392b2fd5e579f0b5bb

364GitHub stars

1star in 7 days

2skills in this repository

2commits in 30 days

Heat

2.7

Star growth, last 7 daysNot available
Star growth, last 24 hoursNot available
Rank movement, last 7 daysNot available
Commits, last 30 daysNot available
Accounts asking about it through MCP, last 7 daysNot available
Hot votes this weekNot available

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

30-day change not yet available: not enough history.

Individual skills in this repository

subtitle-translator gemini_srt_translator
subtitle-translator skills/subtitle-translator

How it works

Choose a skill

subtitle-translator

When your agent uses it

Translate subtitle files (SRT, ASS) and video/media with embedded subtitles into any target language with high linguistic quality, sliding context window, timestamp alignment, and formatting preservation. Use when the user asks to translate a subtitle file (.srt, .ass) or video subtitles.

What it loads into context

Frontmatter

64 tokens

Always available to the agent

SKILL.md

1,317 tokens

When the skill is activated

Reference documents

0 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

🎯 Role & Agent Protocol (CRITICAL)
When to Use
Subtitle Translation Protocol
Translation Rules

Scripts executed separately

__init__.py
agent_cli.py
cli.py
ffmpeg_utils.py
helpers.py
logger.py
main.py
session.py
skill.py
utils.py

Files

SKILL.mdcore5,497 bytes
SKILL.mdcore5,497 bytes
SKILL.mdcore5,497 bytes
SKILL.mdcore5,497 bytes
SKILL.mdcore5,497 bytes
__init__.pyruns14,037 bytes
agent_cli.pyruns12,101 bytes
cli.pyruns27,752 bytes
ffmpeg_utils.pyruns9,041 bytes
helpers.pyruns12,747 bytes
logger.pyruns19,481 bytes
main.pyruns84,264 bytes
pricing.jsonasset5,957 bytes
session.pyruns41,469 bytes
skill.pyruns10,501 bytes
utils.pyruns6,735 bytes

Read SKILL.md


# Subtitle Translator Skill

## 🎯 Role & Agent Protocol (CRITICAL)

When this skill is invoked:

1. **YOU ARE THE TRANSLATOR:** You (the AI assistant) perform the translation directly in your context window using your own linguistic intelligence.
2. **NO API KEY REQUIRED:** Do **NOT** ask the user for an API key or external credentials. The `gst agent` protocol runs completely locally and does not require an API key.
3. **DO NOT RUN EXTERNAL TRANSLATION SCRIPTS:** Do **NOT** look for or execute external Python scripts. Use **ONLY** the `gst agent` CLI commands below.
4. **VIRTUAL ENVIRONMENT EXECUTION:** `gst` may be installed in a project virtual environment (`.venv` or `venv`) rather than globally. If `gst` is not recognized:
   - Use the virtual environment binary: `.venv/bin/gst` (Linux/macOS) or `.venv\Scripts\gst.exe` (Windows)
   - Or use environment package runners: `uv run gst ...` / `poetry run gst ...`

---

View the complete source on GitHub

subtitle-translator

When your agent uses it

Translate subtitle files (SRT, ASS) and video/media with embedded subtitles into any target language with high linguistic quality, sliding context window, timestamp alignment, and formatting preservation. Use when the user asks to translate a subtitle file (.srt, .ass) or video subtitles.

What it loads into context

Frontmatter

64 tokens

Always available to the agent

SKILL.md

1,317 tokens

When the skill is activated

Reference documents

0 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

🎯 Role & Agent Protocol (CRITICAL)
When to Use
Subtitle Translation Protocol
Translation Rules

Files

SKILL.mdcore5,498 bytes
SKILL.mdcore5,498 bytes
SKILL.mdcore5,498 bytes
SKILL.mdcore5,498 bytes
SKILL.mdcore5,498 bytes

Read SKILL.md


# Subtitle Translator Skill

## 🎯 Role & Agent Protocol (CRITICAL)

When this skill is invoked:

1. **YOU ARE THE TRANSLATOR:** You (the AI assistant) perform the translation directly in your context window using your own linguistic intelligence.
2. **NO API KEY REQUIRED:** Do **NOT** ask the user for an API key or external credentials. The `gst agent` protocol runs completely locally and does not require an API key.
3. **DO NOT RUN EXTERNAL TRANSLATION SCRIPTS:** Do **NOT** look for or execute external Python scripts. Use **ONLY** the `gst agent` CLI commands below.
4. **VIRTUAL ENVIRONMENT EXECUTION:** `gst` may be installed in a project virtual environment (`.venv` or `venv`) rather than globally. If `gst` is not recognized:
   - Use the virtual environment binary: `.venv/bin/gst` (Linux/macOS) or `.venv\Scripts\gst.exe` (Windows)
   - Or use environment package runners: `uv run gst ...` / `poetry run gst ...`

---

View the complete source on GitHub

Skills included

subtitle-translator
subtitle-translator

Repository facts

License: MIT
Created: Sep 27, 2024
Last pushed: Oct 13, 2026
Forks: 47
Open issues: 4
Project activity: Active

Before you install

Network or broad shell

Automated signals, not a guarantee

Checked Nov 4, 2026

Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.

Show 8 notes

gemini_srt_translator/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
gemini_srt_translator/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
gemini_srt_translator/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
gemini_srt_translator/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
skills/subtitle-translator/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
skills/subtitle-translator/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
skills/subtitle-translator/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
skills/subtitle-translator/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed

No broad tool permissions
No dangerous shell commands
6 network referencesin 2 files: gemini_srt_translator/pricing.json:2 gemini_srt_translator/utils.py:27
No hidden or obfuscated text
No instruction overrides
10 executable scriptsin 10 files: gemini_srt_translator/__init__.py:1 gemini_srt_translator/agent_cli.py:1 gemini_srt_translator/cli.py:1 and 7 more
64 references to secretsin 4 files: gemini_srt_translator/cli.py:25 gemini_srt_translator/__init__.py:12 gemini_srt_translator/main.py:63 and 1 more
No requests to vote in Hot

Show all 80 signals by file

`gemini_srt_translator/init.py`

Executable scriptline 1
```
Executable file
```
Access to secretsline 12
```
[Credential-related source omitted]
```
Access to secretsline 25
```
[Credential-related source omitted]
```
Access to secretsline 40
```
[Credential-related source omitted]
```
Access to secretsline 42
```
[Credential-related source omitted]
```
Access to secretsline 92
```
[Credential-related source omitted]
```
Access to secretsline 110
```
[Credential-related source omitted]
```
Access to secretsline 125
```
[Credential-related source omitted]
```
Access to secretsline 143
```
[Credential-related source omitted]
```
Access to secretsline 145
```
[Credential-related source omitted]
```
Access to secretsline 170
```
[Credential-related source omitted]
```
Access to secretsline 182
```
[Credential-related source omitted]
```
Access to secretsline 293
```
[Credential-related source omitted]
```
Access to secretsline 296
```
[Credential-related source omitted]
```
Access to secretsline 407
```
[Credential-related source omitted]
```
Access to secretsline 435
```
[Credential-related source omitted]
```
Access to secretsline 438
```
[Credential-related source omitted]
```

`gemini_srt_translator/agent_cli.py`

Executable scriptline 1
```
Executable file
```

`gemini_srt_translator/cli.py`

Executable scriptline 1
```
#!/usr/bin/env python3
```
Access to secretsline 25
```
[Credential-related source omitted]
```
Access to secretsline 26
```
[Credential-related source omitted]
```
Access to secretsline 85
```
[Credential-related source omitted]
```
Access to secretsline 88
```
[Credential-related source omitted]
```
Access to secretsline 100
```
[Credential-related source omitted]
```
Access to secretsline 101
```
[Credential-related source omitted]
```
Access to secretsline 106
```
[Credential-related source omitted]
```
Access to secretsline 107
```
[Credential-related source omitted]
```
Access to secretsline 108
```
[Credential-related source omitted]
```
Access to secretsline 109
```
[Credential-related source omitted]
```
Access to secretsline 212
```
[Credential-related source omitted]
```
Access to secretsline 215
```
[Credential-related source omitted]
```
Access to secretsline 227
```
[Credential-related source omitted]
```
Access to secretsline 228
```
[Credential-related source omitted]
```
Access to secretsline 233
```
[Credential-related source omitted]
```
Access to secretsline 234
```
[Credential-related source omitted]
```
Access to secretsline 235
```
[Credential-related source omitted]
```
Access to secretsline 236
```
[Credential-related source omitted]
```
Access to secretsline 274
```
[Credential-related source omitted]
```
Access to secretsline 277
```
[Credential-related source omitted]
```
Access to secretsline 289
```
[Credential-related source omitted]
```
Access to secretsline 290
```
[Credential-related source omitted]
```
Access to secretsline 295
```
[Credential-related source omitted]
```
Access to secretsline 296
```
[Credential-related source omitted]
```
Access to secretsline 297
```
[Credential-related source omitted]
```
Access to secretsline 298
```
[Credential-related source omitted]
```
Access to secretsline 397
```
[Credential-related source omitted]
```
Access to secretsline 401
```
[Credential-related source omitted]
```
Access to secretsline 422
```
[Credential-related source omitted]
```
Access to secretsline 428
```
[Credential-related source omitted]
```

`gemini_srt_translator/ffmpeg_utils.py`

Executable scriptline 1
```
Executable file
```

`gemini_srt_translator/helpers.py`

Executable scriptline 1
```
Executable file
```

`gemini_srt_translator/logger.py`

Executable scriptline 1
```
Executable file
```
Access to secretsline 44
```
[Credential-related source omitted]
```
Access to secretsline 48
```
[Credential-related source omitted]
```
Access to secretsline 56
```
[Credential-related source omitted]
```
Access to secretsline 57
```
[Credential-related source omitted]
```
Access to secretsline 58
```
[Credential-related source omitted]
```

`gemini_srt_translator/main.py`

Executable scriptline 1
```
Executable file
```
Access to secretsline 63
```
[Credential-related source omitted]
```
Access to secretsline 66
```
[Credential-related source omitted]
```
Access to secretsline 145
```
[Credential-related source omitted]
```
Access to secretsline 147
```
[Credential-related source omitted]
```
Access to secretsline 149
```
[Credential-related source omitted]
```
Access to secretsline 550
```
[Credential-related source omitted]
```
Access to secretsline 890
```
[Credential-related source omitted]
```
Access to secretsline 894
```
[Credential-related source omitted]
```
Access to secretsline 895
```
[Credential-related source omitted]
```
Access to secretsline 909
```
[Credential-related source omitted]
```
Access to secretsline 911
```
[Credential-related source omitted]
```
Access to secretsline 939
```
[Credential-related source omitted]
```
Access to secretsline 940
```
[Credential-related source omitted]
```

`gemini_srt_translator/pricing.json`

Network accessline 2

"currency": "USD",   "updated": "2026-08-27",   "source": "https://ai.google.dev/gemini-api/docs/pricing",

Network accessline 3

"updated": "2026-08-27",   "source": "https://ai.google.dev/gemini-api/docs/pricing",   "unit": "per 1 million tokens",

Network accessline 4

"source": "https://ai.google.dev/gemini-api/docs/pricing",

`gemini_srt_translator/session.py`

Executable scriptline 1
```
Executable file
```

`gemini_srt_translator/skill.py`

Executable scriptline 1
```
Executable file
```

`gemini_srt_translator/utils.py`

Executable scriptline 1
```
Executable file
```

Network accessline 27

url = f"https://pypi.org/pypi/{package_name}/json"     try:         with urllib.request.urlopen(url) as response:

Network accessline 28

try:         with urllib.request.urlopen(url) as response:             if response.status == 200:

Network accessline 29

with urllib.request.urlopen(url) as response:

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Some files could not be read; the facts below still hold.

Signal confidence: 77 facts

Executable script in prose of a file that runsgemini_srt_translator/__init__.py:1Low confidence
Access to secrets in prose of a file that runsgemini_srt_translator/__init__.py:12Low confidence
Access to secrets in prose of a file that runsgemini_srt_translator/__init__.py:25Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/__init__.py:40Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/__init__.py:42Low confidence
Access to secrets in prose of a file that runsgemini_srt_translator/__init__.py:92Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/__init__.py:110Low confidence
Access to secrets in prose of a file that runsgemini_srt_translator/__init__.py:125Low confidence
Access to secrets in code of a file that runsgemini_srt_translator/__init__.py:143High confidence
Access to secrets in code of a file that runsgemini_srt_translator/__init__.py:145High confidence
Access to secrets in prose of a file that runsgemini_srt_translator/__init__.py:170Low confidence
Access to secrets in prose of a file that runsgemini_srt_translator/__init__.py:182Low confidence
Access to secrets in code of a file that runsgemini_srt_translator/__init__.py:293High confidence
Access to secrets in code of a file that runsgemini_srt_translator/__init__.py:296High confidence
Access to secrets in prose of a file that runsgemini_srt_translator/__init__.py:407Low confidence
Access to secrets in code of a file that runsgemini_srt_translator/__init__.py:435High confidence
Access to secrets in code of a file that runsgemini_srt_translator/__init__.py:438High confidence
Executable script in prose of a file that runsgemini_srt_translator/agent_cli.py:1Low confidence
Executable script in code of a file that runsgemini_srt_translator/cli.py:1High confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:25Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:26Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:85Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:88Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:100Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:101Low confidence
Access to secrets in code of a file that runsgemini_srt_translator/cli.py:106High confidence
Access to secrets in code of a file that runsgemini_srt_translator/cli.py:107High confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:108Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:109Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:212Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:215Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:227Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:228Low confidence
Access to secrets in code of a file that runsgemini_srt_translator/cli.py:233High confidence
Access to secrets in code of a file that runsgemini_srt_translator/cli.py:234High confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:235Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:236Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:274Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:277Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:289Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:290Low confidence
Access to secrets in code of a file that runsgemini_srt_translator/cli.py:295High confidence
Access to secrets in code of a file that runsgemini_srt_translator/cli.py:296High confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:297Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:298Low confidence
Access to secrets in code of a file that runsgemini_srt_translator/cli.py:397High confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:401Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:422Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuegemini_srt_translator/cli.py:428Low confidence
Executable script in code of a file that runsgemini_srt_translator/ffmpeg_utils.py:1High confidence

and 27 more

Works with

Agent compatibility, from the files in this repository
Agent	Status	Evidence	Install to
Claude Code	Compatible	Standard SKILL.md gemini_srt_translator/SKILL.md	`.claude/skills/<skill-name>/`
Codex	Compatible	Standard SKILL.md gemini_srt_translator/SKILL.md	`.agents/skills/<skill-name>/`
Cursor	Compatible	Standard SKILL.md gemini_srt_translator/SKILL.md	`.cursor/skills/<skill-name>/`
Gemini CLI	Compatible	Standard SKILL.md gemini_srt_translator/SKILL.md	`.gemini/skills/<skill-name>/`
GitHub Copilot	Compatible	Standard SKILL.md gemini_srt_translator/SKILL.md	`.github/skills/<skill-name>/`
OpenCode	Compatible	Standard SKILL.md gemini_srt_translator/SKILL.md	`.opencode/skills/<skill-name>/`

Native The repository ships a manifest, folder or frontmatter field for this agent.
Compatible A standard SKILL.md that this agent can read.
Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.

MaKTaiL/gemini-srt-translator

History

gemini_srt_translator/SKILL.md

skills/subtitle-translator/SKILL.md

Share this page

Heat

Stars over time

Individual skills in this repository

How it works

subtitle-translator

Frontmatter

SKILL.md

Reference documents

The playbook

Scripts executed separately

Files

subtitle-translator

Frontmatter

SKILL.md

Reference documents

The playbook

Files

Skills included

Repository facts

Before you install

gemini_srt_translator/__init__.py

gemini_srt_translator/agent_cli.py

gemini_srt_translator/cli.py

gemini_srt_translator/ffmpeg_utils.py

gemini_srt_translator/helpers.py

gemini_srt_translator/logger.py

gemini_srt_translator/main.py

gemini_srt_translator/pricing.json

gemini_srt_translator/session.py

gemini_srt_translator/skill.py

gemini_srt_translator/utils.py

How the signals fit together

Works with

You might also use

mattpocock/skills

obra/superpowers

NousResearch/hermes-agent

multica-ai/andrej-karpathy-skills

anthropics/skills

DietrichGebert/ponytail

`gemini_srt_translator/SKILL.md`

`skills/subtitle-translator/SKILL.md`

`gemini_srt_translator/init.py`

`gemini_srt_translator/agent_cli.py`

`gemini_srt_translator/cli.py`

`gemini_srt_translator/ffmpeg_utils.py`

`gemini_srt_translator/helpers.py`

`gemini_srt_translator/logger.py`

`gemini_srt_translator/main.py`

`gemini_srt_translator/pricing.json`

`gemini_srt_translator/session.py`

`gemini_srt_translator/skill.py`

`gemini_srt_translator/utils.py`