Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,13 @@ You can add context to the string, add or remove labels, set the max. length of

<Image src={stringEdit} alt="String Editing" class="width-lg" />

<LinkCard
title="Context Enrichment with AI Agents"
description="Use Crowdin Skills and Crowdin CLI so your AI coding agent writes string context straight from your codebase."
href="https://store.crowdin.com/context-enrichment"
target="_blank"
/>

To edit some particular word or phrase that appears in multiple source strings, you can use the **Find & Replace** feature in **Sources > Strings**.

<Aside type="caution">
Expand Down
4 changes: 4 additions & 0 deletions src/content/docs/developer/api/crowdin-mcp-server.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,10 @@ The Crowdin MCP (Model Context Protocol) Server enables AI agents to interact wi

Think of the MCP Server as a universal adapter and interpreter. Your AI assistant (e.g., Crowdin Copilot, Claude, Cursor, or ChatGPT) speaks "human language", and the Crowdin API speaks a precise "technical language". The MCP server sits in the middle, translating your natural-language requests into the exact commands that Crowdin understands and then translating the responses back into a clear, readable answer.

<ReadMore>
Read more about [Crowdin Skills](/developer/crowdin-skills/), which teach an AI coding agent to work with Crowdin's developer tools locally.
</ReadMore>

## Why Use the MCP Server?

* **Speed & Efficiency:** Automate repetitive tasks like file uploads, status checks, and report generation.
Expand Down
57 changes: 57 additions & 0 deletions src/content/docs/developer/dev-tools/crowdin-skills.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
---
title: Crowdin Skills
description: Teach your AI coding agent to work with Crowdin
slug: developer/crowdin-skills
sidebar:
badge: New
---

import { LinkButton } from '@astrojs/starlight/components';
import ReadMore from '~/components/ReadMore.astro';

Crowdin Skills are instruction packages that teach an AI coding agent how to work with Crowdin. Once they are installed, the agent knows the Crowdin CLI commands, the configuration file format, the API client, and the query languages, so you can describe a localization task in plain language instead of looking up the syntax yourself.

Skills do not connect the agent to your Crowdin account. They work inside your development environment, next to your source code, unlike the [Crowdin MCP Server](/developer/crowdin-mcp-server/).

## Available Skills

**Syncing content**

* **`crowdin-cli`** &ndash; Syncing source files and translations between your project and Crowdin with Crowdin CLI v5.
* **`github-action`** &ndash; Setting up and debugging the `crowdin/github-action` step in a GitHub workflow.

**Adding context to source strings**

* **`context-extraction`** &ndash; Writing context for the source strings that need it.
* **`crowdin-context-cli`** &ndash; Working with the `crowdin context` commands and the JSONL format they use.

**Working with project data**

* **`crowdin-api-client`** &ndash; Using the JavaScript and TypeScript API client, including pagination, uploads, and error handling.
* **`croql`** &ndash; Writing and optimizing CroQL expressions for strings, translations, TM segments, and glossary terms.
* **`graphql`** &ndash; Writing and debugging Crowdin GraphQL queries against the actual schema.

**Building apps**

* **`create-app`** &ndash; Scaffolding, developing, and publishing a Crowdin app.

## Installation

Skills work with Claude Code, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot, OpenCode, Cline, Windsurf, and other AI coding agents. Each client adds them in its own way, so follow the installation instructions in the repository.

<LinkButton href="https://github.com/crowdin/skills#installation" icon="external" target="_blank">Install Crowdin Skills</LinkButton>

Once installed, the skills become available on their own when you work in a project that uses Crowdin or mention something they cover. You can also point your agent at them directly in a request.

## Skills and the MCP Server

Skills and the Crowdin MCP Server both help an AI agent work with Crowdin, in different places.

* **Crowdin Skills** teach the agent how Crowdin's developer tools work. The agent applies that knowledge locally, against your source code and your `crowdin.yml`.
* **Crowdin MCP Server** connects the agent to your Crowdin account, so it can read and change project data directly.

You can use both: Skills to run the right command in your repository, and the MCP Server to check the result in your project.

<ReadMore>
Read more about the [Crowdin MCP Server](/developer/crowdin-mcp-server/).
</ReadMore>
9 changes: 9 additions & 0 deletions src/content/docs/developer/dev-tools/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,15 @@ Keep developing new features and improvements while translators receive new text

Crowdin provides a set of tools that help you to automate the localization process and integrate it into your development workflow. You can use these tools to manage translations, automate file synchronization, and deliver translations to your users.

## Crowdin Skills

Crowdin Skills teach your AI coding agent how to work with Crowdin. Once they are installed, the agent knows the CLI commands, the configuration file format, and the API, so it can carry out a localization task in your repository from a plain-language request.

<div>
<LinkButton href="/developer/crowdin-skills/" icon="right-arrow">Read the Guide</LinkButton>
<LinkButton href="https://github.com/crowdin/skills" variant="secondary" icon="external" target="_blank">View on GitHub</LinkButton>
</div>

## CLI

Crowdin CLI (Console Client) - a powerful command-line tool that simplifies the management of your localization projects on Crowdin. With Crowdin CLI, you can easily upload source files, download translations, and keep your localized content up-to-date with just a few simple commands.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -95,6 +95,13 @@ You can add context to the string, add or remove labels, set the max. length of

<Image src={stringEdit} alt="Editing Strings" class="width-lg crowdin-modal" />

<LinkCard
title="Context Enrichment with AI Agents"
description="Use Crowdin Skills and Crowdin CLI so your AI coding agent writes string context straight from your codebase."
href="https://store.crowdin.com/context-enrichment"
target="_blank"
/>

To edit some particular word or phrase that appears in multiple source strings, you can use the <Icon name="mdi:find-replace" class="inline-icon" /> **Find and replace** feature in **Sources > Strings**.

<Aside type="caution">
Expand Down
3 changes: 3 additions & 0 deletions src/content/sidebars/developer.ts
Original file line number Diff line number Diff line change
Expand Up @@ -90,6 +90,9 @@ export default [
slug: path('dev-tools'),
...sidebarLabel('overview'),
},
{
slug: path('crowdin-skills')
},
{
slug: path('configuration-file')
},
Expand Down
Loading