skills.rest
xuanji86
xuanji86COMMUNITY
Explore all skills by this author →
GitHub

ainiee-translate

Translate novels and long-form texts in epub, txt, docx, and srt files within coding agents.

21|4|Updated May 21, 2026
Search Tags:#agent-native#resumable workflow#novel translation#epub translation#glossary lock#multi-agent parallel#ainiee compatible
One-click install
npx skills add https://github.com/xuanji86/ainiee-translate-skill --skill ainiee-translate
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ainiee-translate
Source: https://github.com/xuanji86/ainiee-translate-skill/tree/main/skill
Command: npx skills add https://github.com/xuanji86/ainiee-translate-skill --skill ainiee-translate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires msgspec, beautifulsoup4, lxml, rich, openpyxl, polib, python-pptx, chardet, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Traditional novel translation tools like AiNiee require a separate desktop application with GUI/HTTP/MCP interfaces, forcing users to switch contexts and manage standalone software. This Skill eliminates that overhead by running the entire translation pipeline directly within your coding agent (Claude Code / OpenAI Codex), using the agent itself as the translation engine with no external app dependencies or per-token API fees.

Core Features & Use Cases

  • End-to-End Translation Pipeline: Automatically parses input files (epub, txt, docx, srt, etc.), builds a locked glossary for consistent terminology and character name rendering, translates chapter by chapter following custom rules, writes progress to a resumable cache, and exports finished translated files.
  • No External App Required: Runs directly on your coding agent's subscription quota, no need to install or run the AiNiee desktop app, no per-token API costs for translation.
  • Flexible Workflow Control: Supports three intervention modes (sampling auto-translation, per-chapter review, full auto mode), plus import of existing AiNiee project caches to continue unfinished translation, polishing, or verification work.
  • Use Case Example: Translate a full English fantasy novel to Chinese with consistent character name preservation, custom style rules for dialogue and honorifics, and resumable progress if the translation is interrupted mid-way.

Quick Start

Use the ainiee-translate skill to translate the attached novel file 'my_fantasy_book.epub' to Chinese, applying the default translation rules and preserving character names per the locked glossary.

Frequently Asked Questions about ainiee-translate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I translate an epub novel directly within Claude Code or OpenAI Codex?▼

You can translate an epub novel directly within coding agents like Claude Code by running the translation pipeline natively, eliminating the need for a separate desktop translation application. It parses epub files and translates chapter by chapter using your agent subscription quota.

Can I resume a long-form text translation if the process is interrupted mid-way?▼

Yes, you can resume a long-form text translation by importing existing project caches. The workflow is state-driven, writing progress to a resumable cache so you can continue unfinished translation, polishing, or verification work directly within the agent.

How do I keep character names and terminology consistent during novel translation?▼

To maintain consistent terminology during novel translation, the skill builds a locked glossary for consistent character name rendering. You can also configure custom translation rules to handle specific style requirements like dialogue and honorifics.

What file formats are supported for agent-native text translation besides epub?▼

Besides epub, agent-native text translation supports common file formats including txt, docx, and srt. It can translate from any source language to a user-specified target language while applying custom rules and locked glossaries.

Do I need to pay per-token API costs to translate a full book using a coding agent?▼

No, you do not pay per-token API costs to translate a full book. The translation runs directly on your coding agent's subscription quota, bypassing external app dependencies and per-token API fees typically required by standalone translation software.

What is the best way to handle large volume text translation for multi-agent parallel processing?▼

The best way to handle large text volumes is using optional multi-agent parallel translation. This approach accelerates the end-to-end pipeline by distributing chapter-by-chapter translation tasks across multiple agents for faster processing.

Related Skills

Explore More Content & Communication Skills→
Team-CommonlyTeam-Commonly
1.3k

markdown-converter

Convert binary documents into clean Markdown using the markitdown Python tool.

Official
Intermediate
ezjonlineezjonline
1

internationalize-metadata

Localize YouTube video titles and descriptions for dubbed uploads.

Community
Intermediate
pixelasticpixelastic
38

glossary

Drills domain vocabulary and updates GLOSSARY.md with resolved terms.

Community
Intermediate
anymouschinaanymouschina
523

agents-team-book-metadata

Extract and validate chapter-level novel metadata with a dual-agent workflow.

Community
Advanced