translate-kit

rules

Teach your AI coding agent to run the translation pipeline automatically.

Teach your AI coding agent to automatically run the translation pipeline after modifying user-facing strings.

The fastest way to set up AI agent support:

bunx skills add https://github.com/guillermolg00/translate-kit --skill translate-kit

This installs a skill that teaches your AI coding agent to detect translate-kit projects and run the pipeline when you modify translatable strings.

Generate rule files

For project-level rules or additional formats, use the rules command:

translate-kit rules

An interactive prompt lets you pick which formats to generate:

FormatFileDescription
CLAUDE.mdCLAUDE.mdProject instructions for AI agents
Cursor.cursor/rules/translate-kit.mdcCursor rules file
GitHub Copilot.github/copilot-instructions.mdCopilot custom instructions
Skill~/.claude/skills/translate-kit/SKILL.mdInstallable agent skill

What the rules do

The generated rules instruct AI agents to:

  1. Detect that the project uses translate-kit (via translate-kit.config.ts)
  2. Run npx translate-kit run after adding or modifying translatable strings
  3. Avoid manually editing generated files (.translate-map.json, .translate-lock.json, locale JSON files)