Regenerate Translations POT File

SkillFiles & storage

Regenerate the translations POT file after modifying English user-facing documentation. Use when docs/src/**/*.md files outside contributing/ are changed. Skip when only docs/src/contributing/** changes.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Regenerate Translations POT File skill

What this skill tells your AI

The instructions your AI receives, as published by ogkevin/cadmus in .agents/skills/translations-sync/SKILL.md and read by ahel’s review.

Run after modifying English user-facing documentation (docs/src/**/*.md outside docs/src/contributing/).

Contributor docs under docs/src/contributing/** are wrapped in <!-- i18n:skip-start --> / <!-- i18n:skip-end --> and are not extracted, so they do not require a POT update.

Command

cadmus-translate

Or equivalently:

MDBOOK_OUTPUT='{"xgettext": {}}' mdbook build -d docs/po docs

Verify

Check that docs/po/messages.pot reflects the changes and commit it alongside the documentation edits.

Signals

GitHub stars
44
Forks
10
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
translations-sync
Source
github.com/ogkevin/cadmus