airi: Skill for Codex

Crowdin batch review for AIRI

This skill reviews the translations that wait for approval on the AIRI Crowdin project. An agent judges each translation. A person applies the result with their own token.

Requirements

• Node.js 24 or later, and pnpm install in this repository. The check script imports the placeholder rule from .github/scripts/check-locales.ts.
• A Crowdin personal access token with proofreader or manager access to the AIRI project. Create it in Crowdin: Account Settings > API > Personal Access Tokens.
• The project id defaults to 816610, the id in crowdin.yml of moeru-ai/airi. To use another project, set CROWDIN_PROJECT_ID.

Token rules

• The person sets the token in their own terminal. The agent never asks for, reads, prints, or passes the token.
• Set the token for the current terminal only. Do not write it into a shell profile.

read -rs "CROWDIN_PERSONAL_TOKEN?Crowdin token: " && export CROWDIN_PERSONAL_TOKEN

The command above is for zsh. In bash, use read -rsp "Crowdin token: " CROWDIN_PERSONAL_TOKEN && export CROWDIN_PERSONAL_TOKEN.

Workflow

The scripts read and write their files in the current directory. Run them from a work directory outside the repository, so the review files stay out of Git. <repo> is the root of this repository.

1. Check (person runs). This step is read-only.

   node <repo>/.agents/skills/enforce-rules-for-i18n/scripts/pending-review.mjs
   

   It prints a table for each language. It writes crowdin-pending-review.json with all pending translations. It writes crowdin-pending-review.md with the flagged ones only: placeholder mismatch, same as English, and bad whitespace.

   If the table shows 0 pending, there is nothing to review. Go to step 5.

2. Review (agent). Read crowdin-pending-review.json and judge every entry with the policy below. Write crowdin-review-decisions.json:

   {
     "approve": [{ "languageId": "es-ES", "file": "stage.yaml", "key": "a.b", "text": "..." }],
     "reject": [{ "languageId": "es-ES", "file": "stage.yaml", "key": "a.b", "text": "...", "reason": "..." }]
   }