Coding

Translate CLI

Build and configure correct `translate` CLI commands for text, files, providers, prompts, and output.

What it does

Build correctly ordered `translate` CLI commands for inline text, stdin, files, globs, and `.xcstrings` catalogs. Configure providers, credentials, endpoints, defaults, network settings, and TOML presets. It also covers prompt templates, output modes, streaming, parallel jobs, dry runs, validation errors, warnings, and exit codes.

When to use it

  • Translating text or piped stdin
  • Batch-translating files and globs
  • Setting provider and endpoint defaults
  • Creating reusable prompt presets

The skill document

translate-cli

Use this skill to help end users run and configure the translate CLI.

translate is a command-line translator for text, stdin, files, globs, and .xcstrings catalogs. It supports multiple providers (OpenAI, Anthropic, Ollama, OpenAI-compatible endpoints, Apple providers, DeepL), prompt presets and template overrides, and persistent TOML configuration.

Capabilities

  • Build correct translate commands for inline text, stdin, single-file, and multi-file workflows.
  • Keep options before positional input(s) when constructing commands (for example, translate --to de README.md).
  • Explain provider selection, credentials, model/base URL requirements, and provider-specific constraints.
  • Configure defaults, provider endpoints, network settings, and presets with translate config and config.toml.
  • Customize prompts with presets, inline templates, @file templates, and placeholders.
  • Explain output behavior (stdout, --output, --in-place, suffix naming), parallel jobs, dry-run, and validation errors.
  • Streaming output: --stream forces on, --no-stream forces off, otherwise defaults.stream applies.

Starter commands

translate --text --to fr "Hello world"
translate --to de README.md
translate --provider ollama --text --to en --dry-run "Merhaba dunya"
translate config set defaults.provider anthropic

Note: prefer option-before-input ordering in all examples and generated commands.

References

  • Quick examples: references/quickstart.md
  • Full flag and subcommand reference: references/flags-and-subcommands.md
  • TOML schema and precedence: references/config-toml.md
  • Provider rules and environment variables: references/providers-and-env.md
  • Presets, prompt templates, placeholders: references/presets-and-prompts.md
  • Runtime behavior, warnings, and exit codes: references/behavior-and-errors.md

Questions people ask

Which input workflows does it cover?
It covers inline text, stdin, single files, multiple files and globs, plus `.xcstrings` catalogs. Generated examples keep options before positional inputs.
Can it help configure different translation providers?
Yes. It explains selection, credentials, model and base URL requirements, environment variables, and provider-specific constraints for OpenAI, Anthropic, Ollama, OpenAI-compatible endpoints, Apple providers, and DeepL.
How can I customize prompts and output behavior?
Use presets, inline templates, `@file` templates, and placeholders for prompts. Output guidance covers stdout, `--output`, `--in-place`, suffix naming, streaming controls, parallel jobs, and dry runs.

Related skills

Check calendars, find open times, and manage Google Calendar events with confirmation before every change.

by Jay81 installs33 stars

Save, search, organize, and manage Get Notes content and knowledge bases through explicit commands.

755 installs66 stars

Build and operate a testable learning plan with practice, spaced review, transfer checks, and durable local records.

by Iván93 installs3 stars

Learn a topic through level checks, adaptive explanations, retrieval practice, and review across sessions.

270 installs8 stars

Discover and trade Polymarket crypto fast markets using CEX momentum or a custom signal.

262 installs50 stars

Extract email dates, links, and deadlines for review, then create or update tracked Google Calendar events.

236 installs5 stars