Bluente API Skill — Development skill for Claude Code

Bluente Translate API — Agent Skill

An [Agent Skill](https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview) that teaches coding agents (Claude Code, Codex, Cursor and others) how to integrate with **Bluente's document-translation API** correctly: upload, wait for processing, start the translation, poll or use a webhook, and download the result — plus error codes, translation options, glossaries and InDesign (IDML) translation.

Full API documentation: https://www.bluente.com/docs

What's inside

bluente-translate-api/
├── SKILL.md                      # Core flow and the gotchas (loaded when the skill triggers)
├── references/
│   ├── endpoints.md              # Every endpoint, parameters, response shapes
│   ├── errors.md                 # Error codes, task statuses, retry rules
│   ├── options.md                # Bilingual, scanned/OCR, table layout enhancement, download conversion
│   ├── file-types-and-idml.md    # Supported files and IDML rules
│   ├── webhooks.md               # Webhook payload and safe handling
│   └── glossary.md               # Custom glossary upload/list/update/delete
└── examples/
    ├── translate.sh              # bash + curl + jq
    ├── translate.py              # Python + requests
    └── translate.ts              # TypeScript, Node.js 18+ (no dependencies)

Install

Claude Code

Copy the skill folder into your personal skills directory (all projects):

git clone https://github.com/Bluente/bluente-api-skill.git
mkdir -p ~/.claude/skills
cp -r bluente-api-skill/bluente-translate-api ~/.claude/skills/

or into one project (shared with everyone who works on that repo):

mkdir -p .claude/skills
cp -r bluente-api-skill/bluente-translate-api .claude/skills/

Claude Code picks it up automatically and uses it when you work with the Bluente API.

Other agents

The skill is plain Markdown plus example scripts, so any agent can use it:

• **Agents that support the Agent Skills fo