Agent skill

Docs I18n Review

by Comfy-Org in Comfy-Org/docs

Review ComfyUI docs translation quality with LLM-as-a-judge (review-i18n.ts).

GPL-3.0Auto-check: notesFrontend & Design

Install Docs I18n Review

skills CLI
$ npx skills add Comfy-Org/docs --skill docs-i18n-review -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Comfy-Org/docs docs-i18n-review --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Comfy-Org/docs.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cursor/skills/docs-i18n-review .claude/skills/docs-i18n-review && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
docs-i18n-review
GitHub stars
300
Token cost
~926 tokens
SKILL.md length
319 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
GPL-3.0

At a glance

Review ComfyUI docs translation quality with LLM-as-a-judge (review-i18n.ts).

  • Works in 4 steps: Accuracy — meaning matches English → Completeness — nothing missing or added → Terminology — glossary / preserve_terms… → …
  • Reviewing zh/ja/ko translations
  • SKILL.md covers When to use, Environment (.env.local), Commands and Output, plus 6 more sections
  • Calls pnpm; needs REVIEW_API_KEY and TRANSLATE_API_KEY

What it does

Docs I18n Review is an agent skill from Comfy-Org/docs. Review ComfyUI docs translation quality with LLM-as-a-judge (review-i18n.ts). Scores accuracy, completeness, terminology, fluency. Use when reviewing zh/ja/ko translations, running translate:review, quality-report, reviewSourceHash, or checking translation quality after pnpm translate.

Its SKILL.md is about 930 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design, covering Internationalization, Translation and Diffusion and image models. It works with ComfyUI and pnpm. The repository describes itself as: Documentation for ComfyUI. The licence is GPL-3.0.

When your agent uses it

  • Reviewing zh/ja/ko translations
  • Running translate:review
  • ReviewSourceHash
  • Checking translation quality after pnpm translate

Example prompts

  • “/docs-i18n-review”

Requirements

  • A credential in REVIEW_API_KEY
  • A credential in TRANSLATE_API_KEY

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Accuracy — meaning matches English
  2. Completeness — nothing missing or added
  3. Terminology — glossary / preserve_terms consistency
  4. Fluency — natural target language

What it can do on your machine

Read from SKILL.md and the folder at commit 7eb41e0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pnpm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • REVIEW_API_KEY
    • TRANSLATE_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Docs I18n Review loads about 926 tokens when it runs. Until then it costs about 76 tokens; SKILL.md has 319 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~76
When it runs · the whole SKILL.md, loaded when a task matches
~926

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:23
    ## Environment (`.env.local`)

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Comfy-Org/docs at commit 7eb41e0, republished under its GPL-3.0 licence (© Comfy-Org). 319 words, ~926 tokens.

Download SKILL.mdSave it as .claude/skills/docs-i18n-review/SKILL.md (or your agent's skills folder).
name
docs-i18n-review
description
Review ComfyUI docs translation quality with LLM-as-a-judge (review-i18n.ts). Scores accuracy, completeness, terminology, fluency. Use when reviewing zh/ja/ko translations, running translate:review, quality-report, reviewSourceHash, or checking translation quality after pnpm translate.

Docs i18n Quality Review

Advisory LLM-as-a-judge for existing ja/zh/ko translations. Separate from translation (pnpm translate) and from the model's self-reported === MISMATCHES === during translate.

Not for CMS staging — reviews committed docs under {lang}/.

When to use

  • After pnpm translate on important pages
  • Before merging large i18n PRs
  • When user asks to review translation quality
  • Spot-check with --sample N

Environment (.env.local)

Prefer a cheap/fast judge model (lighter than translation):

VariablePurpose
REVIEW_API_KEYJudge API key (falls back to TRANSLATE_API_KEY)
REVIEW_API_BASE_URLEndpoint (falls back to TRANSLATE_*)
REVIEW_API_MODELe.g. deepseek-v4-flash
REVIEW_CONCURRENCYDefault 5; lower if socket errors

Requires Bun.

Commands

CommandAction
pnpm translate:reviewPending reviews, all languages
pnpm translate:review -- --lang koOne language
pnpm translate:review -- installation/x.mdxSpecific file(s)
pnpm translate:review -- --allRe-review everything
pnpm translate:review -- --sample 20N random pending per language
pnpm translate:review -- --min-score 4Report files scoring below 4/5
pnpm translate:review -- --snippetsReview snippets instead of pages

Output

Reports (gitignored): .github/i18n-logs/review/

  • quality-report.json / .txt — scores + issues
  • Advisory only — never written into MDX

Per-file state in git: reviewSourceHash in translated frontmatter (mirrors translationSourceHash). Commit hash updates; detailed scores stay in logs.

Scoring axes

  1. Accuracy — meaning matches English
  2. Completeness — nothing missing or added
  3. Terminology — glossary / preserve_terms consistency
  4. Fluency — natural target language

Standard workflow

bash
pnpm translate -- changelog/index.mdx --lang ko   # translate first
pnpm translate:review -- changelog/index.mdx --lang ko
# Read .github/i18n-logs/review/quality-report.txt
# Fix issues → re-translate affected sections → re-review

Incremental: skips files already reviewed at current English hash unless --all.

Agent checklist

  • Ensure translation is up to date (translationSourceHash matches EN) before review
  • Run review after translate, not instead of translate
  • Read report from .github/i18n-logs/review/ — do not commit logs
  • Fix via re-translate or glossary overrides, not manual score edits
  • For systematic term issues → glossary/overrides/{lang}.json (see docs-i18n-translate skill)

Key files

PathRole
.github/scripts/i18n/review-i18n.tsReview entry point
.github/scripts/i18n/glossary.mjsTerminology check hints
.github/scripts/i18n/README.mdFull review section

Troubleshooting

IssueFix
Nothing to reviewTranslation stale or already reviewed — run translate or --all
Socket / timeout errorsLower REVIEW_CONCURRENCY; use faster model
Low terminology scoreUpdate glossary overrides, re-translate, re-review
  • docs-i18n-translate — generate/update translations
  • cms-changelog-sync — CMS popup staging (different pipeline)

© Comfy-Org, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .cursor/skills/docs-i18n-review of Comfy-Org/docs.

Open the folder on GitHubat commit 7eb41e0

Compare with similar skills

Docs I18n Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Docs I18n Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docs I18n Review this skillComfy-Org/docs300—~926Automated safety check: NotesGPL-3.0
Managing MCP IndexComfy-Org/workflow_templates1.3k—~1.9kAutomated safety check: NotesMIT
Managing TemplatesComfy-Org/workflow_templates1.3k—~2.8kAutomated safety check: PassMIT
Plane UI Translationmakeplane/plane61k—~16kAutomated safety check: PassAGPL-3.0
Managing TranslationsComfy-Org/workflow_templates1.3k—~992Automated safety check: PassMIT
Docs Websitekurotu/VRCQuestTools373—~1.3kAutomated safety check: PassMIT

Similar skills

  • Managing MCP Index

    Comfy-Org/workflow_templates

    Builds and maintains templates/index.mcp.json for Comfy Cloud MCP tools.

    1.3k GitHub stars~1.9k tokensUpdated today
    Frontend & DesignAuto-check: notes
  • Managing Templates

    Comfy-Org/workflow_templates

    Manages ComfyUI workflow templates end-to-end: add new templates and rename existing ones (files, index metadata, bundles, i18n, package sync).

    1.3k GitHub stars~2.8k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Plane UI Translation

    makeplane/plane

    Sets the rules for translating and updating Plane's UI strings across locales: do-not-translate terms, plural forms, placeholders and AI translation review.

    61k GitHub stars~16k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Managing Translations

    Comfy-Org/workflow_templates

    Manages internationalization and translations for ComfyUI workflow templates.

    1.3k GitHub stars~992 tokensUpdated today
    Writing & ContentAuto-check passed
  • Docs Website

    kurotu/VRCQuestTools

    Use this skill FIRST for any task whose output lives in the Website/ directory — the VRCQuestTools user manual / docs site (Docusaurus, bilingual en/ja).

    373 GitHub stars~1.3k tokensUpdated today
    Writing & ContentAuto-check passed
  • Chatbox i18n Translator

    chatboxai/chatbox

    Translates new or changed i18n keys from a Chatbox Pro diff, staged changes or a commit range, writing the locale JSON files directly with a built-in glossary.

    42k GitHub stars~508 tokensUpdated 16 days ago
    Frontend & DesignAuto-check passed

More from Comfy-Org/docs

  • Docs I18n Translate

    Comfy-Org/docs

    Translate ComfyUI Mintlify docs from English MDX to ja/zh/ko using translate-i18n.ts.

    300 GitHub stars~3.2k tokensUpdated today
    Auto-check: notes
  • Cms Changelog Sync

    Comfy-Org/docs

    Sync ComfyUI release notes to Strapi CMS: LLM-simplify English changelog for in-app popup, translate to zh/ja/ko/fr/ru/es in staging, push drafts to CMS.

    300 GitHub stars~5.2k tokensUpdated today
    Auto-check: warnings

Works with

Questions about Docs I18n Review

What does Docs I18n Review do?

Review ComfyUI docs translation quality with LLM-as-a-judge (review-i18n.ts). Docs I18n Review is an agent skill from Comfy-Org/docs.ts).

When should I use Docs I18n Review?

Docs I18n Review fits situations like: reviewing zh/ja/ko translations; running translate:review; reviewSourceHash; checking translation quality after pnpm translate.

How do I install Docs I18n Review in Claude Code?

Run `npx skills add Comfy-Org/docs --skill docs-i18n-review -a claude-code`. Or copy the skill folder (.cursor/skills/docs-i18n-review in Comfy-Org/docs) into .claude/skills/docs-i18n-review in your project. Claude Code loads it when a task matches its description.

How do I install Docs I18n Review in Codex?

Run `npx skills add Comfy-Org/docs --skill docs-i18n-review -a codex`. Or copy the skill folder (.cursor/skills/docs-i18n-review in Comfy-Org/docs) into .agents/skills/docs-i18n-review in your project. Codex loads it when a task matches its description.

Can I use Docs I18n Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Comfy-Org/docs --skill docs-i18n-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/docs-i18n-review, .gemini/skills/docs-i18n-review, .github/skills/docs-i18n-review and .opencode/skills/docs-i18n-review in your project.

What does Docs I18n Review need to run?

Going by SKILL.md and its folder, Docs I18n Review needs the command-line tools its instructions call (pnpm) and credentials named REVIEW_API_KEY and TRANSLATE_API_KEY. Our summary lists: A credential in REVIEW_API_KEY; A credential in TRANSLATE_API_KEY.

Does Docs I18n Review access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Docs I18n Review safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Docs I18n Review use?

Docs I18n Review is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Docs I18n Review use?

About 926 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Docs I18n Review?

Skills that share tags, products or a category with Docs I18n Review: Managing MCP Index (Comfy-Org/workflow_templates, 1.3k stars), Managing Templates (Comfy-Org/workflow_templates, 1.3k stars), Plane UI Translation (makeplane/plane, 61k stars) and Managing Translations (Comfy-Org/workflow_templates, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docs I18n Review?

Comfy-Org (a GitHub organization) maintains it in Comfy-Org/docs, which has 300 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 9, 2026.

Source: Comfy-Org/docs on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.