docs-enable-translationlisted
Install: claude install-skill Docsbook-io/docs-skills
# docs-enable-translation — Enable AI auto-translation via Docsbook MCP
## Workflow
1. **Verify MCP transport** — call `list_workspaces` as a connectivity probe. If it fails, print the MCP connection command and exit gracefully without error.
2. **Validate inputs** — confirm the language list is non-empty and contains only codes from the 15 supported languages. If a Slack webhook URL is provided, confirm it is a valid `https://hooks.slack.com/` URL.
3. **Check plan** — read the workspace plan via `get_workspace`. If the plan is below PRO, stop and print an upgrade prompt. Do not proceed to write any settings.
4. **Enable languages** — call `update_languages` with the validated language set.
5. **Switch translation mode** — call `set_translation_mode` with `mode: auto` so Docsbook translates new and changed pages on every push.
6. **Register Slack webhook (optional)** — if a Slack URL was provided, generate a random HMAC secret and call `register_webhook_translation_completed`. Surface the secret to the user once.
7. **Update AGENTS.md** — append or replace a managed `## Docsbook Translation` section in `AGENTS.md` documenting the enabled languages, mode, and notification status.
8. **Report** — print a summary of what was applied and next steps.
## Guardrails
- Never enable translation on a workspace below PRO plan — stop after plan check, do not attempt `update_languages`.
- Never reuse a previously shown HMAC secret — generate a fresh one for each registration.
- When u