Crowdin Skills

This repository contains Agent Skills for Crowdin, an AI-powered localization platform for teams and businesses.

What are Agent Skills?

Skills are reusable capabilities for AI coding agents. They provide procedural knowledge and best practices that help AI agents implement features correctly and efficiently.

Installation

Install all Crowdin skills with a single command:

npx skills add crowdin/skills

This gives your AI coding agent access to comprehensive Crowdin knowledge including best practices, common pitfalls, and configuration patterns.

Claude Code Plugin

Alternatively, install the skills as a Claude Code plugin. In Claude Code, run:

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

All skills load automatically and stay up to date via /plugin marketplace update.

The plugin also includes the Crowdin MCP Server, giving your agent direct access to Crowdin projects. Authenticate via the browser OAuth flow on first use (/mcp in Claude Code). Crowdin Enterprise users should connect their organization endpoint (https://{organization}.mcp.crowdin.com/v2/mcp) manually instead.

Other Agent Tools (Plugin Install)

The repo is also installable as a plugin via the plugins CLI, which auto-detects your installed agent tools (Claude Code, Cursor, Codex, Grok Build, Kimi Code, GitHub Copilot CLI, VS Code) and installs through each tool's native plugin system:

npx plugins add crowdin/skills

Gemini CLI

The repo is a Gemini CLI extension — install it with:

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

GitHub CLI

The GitHub CLI (v2.90+) can install the skills for GitHub Copilot or any other supported agent:

gh skill install crowdin/skills --all

Use --agent <name> (e.g. --agent cursor) to target a specific tool, and gh skill update to pull newer versions.

Available Skills

crowdin-cli

Guides correct usage of Crowdin CLI v5 — the crowdin command that syncs localization files between a local project and Crowdin. Covers installation and authentication, crowdin.yml configuration (placeholders, file groups, language mapping), the core upload/download workflow, auto-translate, machine-readable output for scripts and agents (-o json|toon|plain), exit codes, CI/CD patterns, and migration from CLI v4.

create-app

Builds a Crowdin app end to end and leaves the user looking at it: scaffolds with @crowdin/serverless-apps-cli, writes the UI with @crowdin/serverless-apps-sdk, publishes into the organization and opens it. Written for translators and localization managers rather than developers, so it derives what it can (edition, placement, scopes, editor modes) and asks only questions a non-programmer can answer. Covers the placements that have no preview link, the requests that need a backend and what to offer instead, and the checks that catch a published app which does not actually render.

context-extraction

Fills ai_context in Crowdin JSONL files so translators get clear context. Covers which strings need context (ambiguous short words, plurals, inline tags, etc.), how to write 1–3 sentence descriptions (UI element type, placement), and safe editing rules (only edit ai_context, validity checklist).

crowdin-context-cli

Documents the crowdin context commands (download, upload, status, reset) for AI enrichment. Covers CLI options (filters, output path, overwrite/dryrun), coverage statistics, JSONL format, and the workflow: download → fill ai_context (e.g. with context-extraction) → upload.

crowdin-api-client

Guides practical usage of @crowdin/crowdin-api-client for production workflows. Covers client/module selection, pagination with .withFetchAll(), uploads via storage + file creation, translation build/download flow, runtime options (fetch, retries, timeout), and error handling patterns (CrowdinValidationError vs CrowdinError).

croql

Helps build, validate, and optimize Crowdin CroQL expressions for strings, translations, TM segments, and glossary terms. Includes operator guidance, context-specific fields, editor-filter equivalents, and API endpoint templates with URL-encoding reminders.

graphql

Helps write and debug valid Crowdin GraphQL queries with schema-aware arguments, pagination, filtering/sorting, and node/rate-limit safety checks. Includes a troubleshooting pattern for common Playground errors like unsupported field arguments.

Quick Start

1. Install all Crowdin skills:

   npx skills add crowdin/skills

2. Use with your AI coding agent: The skills will automatically be available when working on projects that use Crowdin, or when you mention terms that fall under the scope of the skills.

3. Manual trigger: You can explicitly reference the skills in your prompts:

   "Using the Crowdin skills, help me enrich the context of strings before translation starts"
   

Installing Individual Skills

If you prefer, you can install specific skills:

npx skills add crowdin/skills --skill crowdin-cli
npx skills add crowdin/skills --skill context-extraction
npx skills add crowdin/skills --skill crowdin-context-cli
npx skills add crowdin/skills --skill crowdin-api-client
npx skills add crowdin/skills --skill croql
npx skills add crowdin/skills --skill graphql
npx skills add crowdin/skills --skill create-app

Compatibility

These skills are compatible with:

• Claude Code
• Cursor
• OpenAI Codex
• Gemini CLI
• GitHub Copilot
• OpenCode
• Cline
• Windsurf
• And other agents supporting the Agent Skills format

Resources

• Crowdin Documentation
• Crowdin GitHub
• Skills.sh