translate-spec

Translate narration and UI text in .demo.yaml files to a target language.

6|1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/45ck/demo-machine --skill translate-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: translate-spec
Source: https://github.com/45ck/demo-machine/tree/main/.claude/skills/translate-spec
Command: npx skills add https://github.com/45ck/demo-machine --skill translate-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translate narration and user-facing text in a demo spec to a target language to create localized versions for international audiences.

Core Features & Use Cases

  • Selective translation of meta.title, chapters[].title, chapters[].narration, and chapters[].steps[].narration while preserving technical configuration fields such as runner and URLs.
  • Output localized specs to examples/my-demo.{language}.demo.yaml for easy integration into the workflow.
  • Use Case: Localize a demo for a French audience to broaden accessibility.

Quick Start

Translate a demo spec by running the translate-spec command with the spec path and target language to generate a localized file.

Frequently Asked Questions about translate-spec

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

FAQPage Schema
How do I translate narration and UI text in a demo spec YAML file?

To translate narration and UI text in a demo spec YAML, use the translate-spec function to selectively convert meta.title, chapter titles, and narration fields into a target language. It outputs a localized multilingual YAML file while preserving technical runner configurations.

Does demo spec localization preserve runner command and URL configurations?

Demo spec localization preserves runner command and URL configurations by selectively translating only user-facing narration and UI text fields. Technical configurations like runner.command, runner.url, and other non-translatable fields remain untouched during the translation process.

What languages can I localize my demo YAML specs into?

You can localize your demo YAML specs into multiple languages, including French, Japanese, and pt-BR. The function supports targeted multilingual localization to broaden accessibility for international audiences.

What is the best way to automate multilingual deployment for demo specs?

Automating multilingual deployment for demo specs is best handled by translating the YAML files into target languages and outputting them to specific localized examples paths. This generates distinct language files for easy integration into the workflow.

How do I generate a French version of my demo YAML file?

To generate a French version of your demo YAML file, run the translate-spec command with the spec path and French as the target language. It outputs a localized file named examples/my-demo.french.demo.yaml for your workflow.