Skip to main content

i18n with AI

AI coding agents and chat tools have become an essential part of the development workflow, and internationalization is no exception. However, most AI models have limited or outdated knowledge of Lingui's APIs and best practices. This page covers the resources available to give your AI tools accurate, up-to-date Lingui knowledge so they can help you ship localized products faster.

Agent Skills​

Agent Skills are reusable, procedural knowledge packages for AI coding agents. They provide best practices, common patterns, and troubleshooting guides that agents can follow when working with Lingui - reducing hallucinations and incorrect API usage.

Installation​

The skills follow the Agent Skills format and work with Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot, and other compatible agents. Use whichever installer matches your tool - each one installs the whole set.

Skills CLI:

npx skills add lingui/skills

Claude Code plugin - all skills load automatically and stay up to date via /plugin marketplace update:

/plugin marketplace add lingui/skills
/plugin install lingui@lingui-skills

Plugins CLI - auto-detects your installed agent tools and installs through each one's native plugin system:

npx plugins add lingui/skills

Gemini CLI extension:

gemini extensions install https://github.com/lingui/skills

GitHub CLI (v2.90+) - installs for GitHub Copilot or any other supported agent. Use --agent <name> to target a specific tool, and gh skill update to pull newer versions:

gh skill install lingui/skills --all

To install a single skill instead of the full set, pass --skill:

npx skills add lingui/skills --skill lingui-best-practices

See the Lingui Skills repository for more details about the available skills and their usage.

Context Files​

Lingui provides llms.txt and llms-full.txt files that contain the full docs content in a format optimized for AI consumption. These are static files of the Lingui documentation in a streamlined Markdown format. Some AI tools can auto-discover these files if you provide https://lingui.dev as a docs source.

While these files provide a minimal, easy-to-parse version of the documentation, they are large files that will use a lot of tokens if used directly in context and will need to be updated regularly to stay current. They are best used as a fallback when the AI tool does not have access to the latest documentation in other ways. The Context7 MCP server provides more efficient access to the full documentation with real-time search capabilities, making it the preferred option when available.

Read more about the specification at llmstxt.org.

Context7 MCP​

Context7 is an MCP (Model Context Protocol) server that provides AI tools with real-time access to up-to-date library documentation - including Lingui. Unlike static context files, Context7 indexes the latest docs and lets agents search them on demand, keeping token usage low.

Usage​

Add use context7 to any prompt and Context7-enabled agents will automatically pull relevant Lingui documentation:

Add i18n to my React app using Lingui. use context7

MCP Server Configuration​

If your AI tool supports MCP server configuration, you can add Context7 directly:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

For tool-specific setup instructions (including remote server and other clients), visit the Context7 page for Lingui.