book-translation

Translate MDX book content and JSON UI strings into multiple languages.

Updated Jul 1, 2026
One-click install
npx skills add https://github.com/Islehecha/book-lens-codex --skill book-translation-islehecha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: book-translation
Source: https://github.com/Islehecha/book-lens-codex/tree/main/.codex/skills/book-translation
Command: npx skills add https://github.com/Islehecha/book-lens-codex --skill book-translation-islehecha

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill solves the complexity of localizing technical book content by providing a structured, repeatable workflow that ensures consistency across MDX files and JSON translation keys.

Core Features & Use Cases

  • Standardized Workflow: Leverages a proven base translation (Turkish) to maintain structural integrity and React component compatibility.
  • Comprehensive Localization: Handles both prose content in MDX and UI/metadata strings in JSON, ensuring a complete user experience.
  • Use Case: A team wants to translate The Interactive Book of Prompting into a new language; this skill provides the exact steps to copy, translate, and register the new locale without breaking the interactive demo components.

Quick Start

Initiate the translation process by creating the target locale directory and copying the base translation files as instructed in the skill documentation.

Frequently Asked Questions about book-translation

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

FAQPage Schema
How do I translate MDX book content into multiple languages without breaking React components?

Translating MDX book content requires a structured workflow that copies a base translation to maintain structural integrity and React component compatibility. This skill provides systematic steps to translate prose while preserving interactive demo functionality.

What is the best way to localize JSON UI strings for a translated technical book?

Localizing JSON UI strings involves handling metadata and interface text separately from prose content. This skill ensures comprehensive localization by processing both MDX content and JSON keys, delivering a complete translated user experience.

How do I register a new locale for an interactive MDX book demo?

Registering a new locale requires creating a target locale directory and copying base translation files. This skill outlines the specific file structure conventions and registration steps needed to ensure interactive demo functionality works correctly.

Can I use this MDX localization workflow for languages outside the provided Turkish base translation?

Yes, the MDX localization workflow leverages a proven Turkish base translation as a structural template. You can systematically copy and translate this base into new target languages while maintaining consistent React component integration.

What happens if I don't follow the file structure conventions during MDX book translation?

Failing to follow file structure conventions during MDX book translation breaks interactive demo components and React integration. This skill enforces specific directory structures and registration steps to prevent structural integrity loss across translated locales.