Agent Skill

Install the Agent Skill

Give your AI agent one URL and it installs itself: a pure-Python CLI with an offline self-check, talking to the same translation engine as this site.

Skill version 1.0.0

One-shot install prompt

Paste this into your agent (ZCode, Claude Code, Codex…); it fetches the guide and completes installation unattended.

Please install the LiteTranslate Agent Skill for me. Read the install guide at /docs/skill.md and follow it end to end: download the skill files into this platform's skills directory, run the offline self-check, then report the installed version. Do not print or store my API key.

Manual install

Pick your platform's skills directory, then run the two downloads and the offline check.

Skills directory: ~/.agents/skills

The default skills directory for ZCode and DSH agents.

Install

mkdir -p ~/.agents/skills/litetranslate && cd ~/.agents/skills/litetranslate \
  && curl -fsSL /skill/SKILL.md -o SKILL.md \
  && curl -fsSL /skill/litetranslate.py -o litetranslate.py \
  && chmod +x litetranslate.py \
  && python3 ~/.agents/skills/litetranslate/litetranslate.py doctor --offline

Python 3.9+ standard library only — nothing to pip install.

Verify

python3 ~/.agents/skills/litetranslate/litetranslate.py --version
# Expected: litetranslate-skill 1.0.0
python3 ~/.agents/skills/litetranslate/litetranslate.py doctor --offline

First commands

After installing, point the CLI at your key and translate from the terminal.

Translate Markdown

python3 ~/.agents/skills/litetranslate/litetranslate.py translate --text "你好，世界" --source auto --target en --format markdown --json

List languages

python3 ~/.agents/skills/litetranslate/litetranslate.py languages --json

Check quota

python3 ~/.agents/skills/litetranslate/litetranslate.py usage --json

Offline self-check

python3 ~/.agents/skills/litetranslate/litetranslate.py doctor --offline

Configure

The CLI reads its key from the LiteTranslate config file so it never lands in shell history.

Config file (~/.lite-lake/lite-translate/config.json)

mkdir -p ~/.lite-lake/lite-translate && chmod 700 ~/.lite-lake/lite-translate
cat > ~/.lite-lake/lite-translate/config.json <<'EOF'
{
  "base_url": "",
  "api_key": "ltr_prod_xxx"
}
EOF

Or pass the key per call

# Recommended: pipe the key in, nothing saved to history
echo ltr_prod_xxx | {script} translate --text "你好" --target en --api-key-stdin

Security notes

The CLI never prints your key and never sends it anywhere except the LiteTranslate API. Avoid the plain --api-key flag in shared shells; prefer --api-key-stdin or the config file.