From 76a09d9ecfc0991fd44c12ded10c9633e53d9dde Mon Sep 17 00:00:00 2001 From: Mykhailo Rohalskyy Date: Wed, 19 Aug 2026 12:39:06 +0300 Subject: [PATCH 1/2] docs(developer): add a Crowdin Skills article and link it from context docs --- .../crowdin/project-management/advisors.mdx | 5 ++ .../sources/string-management.mdx | 4 ++ .../docs/developer/api/crowdin-mcp-server.mdx | 4 ++ .../developer/dev-tools/crowdin-skills.mdx | 62 +++++++++++++++++++ .../docs/developer/dev-tools/overview.mdx | 9 +++ .../project-management/advisors.mdx | 5 ++ .../sources/string-management.mdx | 4 ++ src/content/sidebars/developer.ts | 3 + 8 files changed, 96 insertions(+) create mode 100644 src/content/docs/developer/dev-tools/crowdin-skills.mdx diff --git a/src/content/docs/crowdin/project-management/advisors.mdx b/src/content/docs/crowdin/project-management/advisors.mdx index a6abfd8dd..cdbc40d8a 100644 --- a/src/content/docs/crowdin/project-management/advisors.mdx +++ b/src/content/docs/crowdin/project-management/advisors.mdx @@ -8,6 +8,7 @@ sidebar: import { Aside, CardGrid, LinkCard, Badge } from '@astrojs/starlight/components'; import { Icon } from 'astro-icon/components'; +import ReadMore from '~/components/ReadMore.astro'; Advisors monitor your project setup in the background and flag when something is missing, drifting, or under-configured, acting like a linter for your localization setup. Each finding appears as a recommendation card on the **Advisors** tab, with a clear next step to resolve it. @@ -78,6 +79,10 @@ The built-in Advisors cover the configuration dimensions that most directly affe Some checks apply only to certain content types. For example, the video preview check appears for projects with subtitle files, and the website context check for CMS projects. Checks that don't apply to your project aren't shown. + + Read more about [enriching string context with an AI coding agent](/developer/crowdin-skills/#enriching-string-context). + + ## Re-check Advisors Advisors re-check themselves automatically when relevant things change in your project, such as added files or strings, updated settings, or assigned glossaries and style guides. To avoid unnecessary recalculations, checks refresh within an hour (or within a day for the heavier string context coverage check) of relevant changes rather than on every edit, so a result may not update the instant you make a change. diff --git a/src/content/docs/crowdin/project-management/sources/string-management.mdx b/src/content/docs/crowdin/project-management/sources/string-management.mdx index d3e4c2518..fdb0e1a28 100644 --- a/src/content/docs/crowdin/project-management/sources/string-management.mdx +++ b/src/content/docs/crowdin/project-management/sources/string-management.mdx @@ -92,6 +92,10 @@ You can add context to the string, add or remove labels, set the max. length of String Editing + + Read more about [enriching string context with an AI coding agent](/developer/crowdin-skills/#enriching-string-context). + + To edit some particular word or phrase that appears in multiple source strings, you can use the **Find & Replace** feature in **Sources > Strings**. + + Read more about [enriching string context with an AI coding agent](/developer/crowdin-skills/#enriching-string-context). + + ## Re-check Advisors Advisors re-check themselves automatically when relevant things change in your project, such as added files or strings, updated settings, or assigned glossaries and style guides. To avoid unnecessary recalculations, checks refresh within an hour (or within a day for the heavier string context coverage check) of relevant changes rather than on every edit, so a result may not update the instant you make a change. diff --git a/src/content/docs/enterprise/project-management/sources/string-management.mdx b/src/content/docs/enterprise/project-management/sources/string-management.mdx index f705a9d42..2b80f6528 100644 --- a/src/content/docs/enterprise/project-management/sources/string-management.mdx +++ b/src/content/docs/enterprise/project-management/sources/string-management.mdx @@ -95,6 +95,10 @@ You can add context to the string, add or remove labels, set the max. length of Editing Strings + + Read more about [enriching string context with an AI coding agent](/developer/crowdin-skills/#enriching-string-context). + + To edit some particular word or phrase that appears in multiple source strings, you can use the **Find and replace** feature in **Sources > Strings**. - - Read more about [enriching string context with an AI coding agent](/developer/crowdin-skills/#enriching-string-context). - - ## Re-check Advisors Advisors re-check themselves automatically when relevant things change in your project, such as added files or strings, updated settings, or assigned glossaries and style guides. To avoid unnecessary recalculations, checks refresh within an hour (or within a day for the heavier string context coverage check) of relevant changes rather than on every edit, so a result may not update the instant you make a change. diff --git a/src/content/docs/crowdin/project-management/sources/string-management.mdx b/src/content/docs/crowdin/project-management/sources/string-management.mdx index fdb0e1a28..078bef90e 100644 --- a/src/content/docs/crowdin/project-management/sources/string-management.mdx +++ b/src/content/docs/crowdin/project-management/sources/string-management.mdx @@ -92,9 +92,12 @@ You can add context to the string, add or remove labels, set the max. length of String Editing - - Read more about [enriching string context with an AI coding agent](/developer/crowdin-skills/#enriching-string-context). - + To edit some particular word or phrase that appears in multiple source strings, you can use the **Find & Replace** feature in **Sources > Strings**. diff --git a/src/content/docs/developer/dev-tools/crowdin-skills.mdx b/src/content/docs/developer/dev-tools/crowdin-skills.mdx index 7bbcb58ca..e73a3b2e4 100644 --- a/src/content/docs/developer/dev-tools/crowdin-skills.mdx +++ b/src/content/docs/developer/dev-tools/crowdin-skills.mdx @@ -6,7 +6,7 @@ sidebar: badge: New --- -import { Steps, LinkButton } from '@astrojs/starlight/components'; +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. @@ -15,38 +15,33 @@ Skills do not connect the agent to your Crowdin account. They work inside your d ## Available Skills +**Syncing content** + * **`crowdin-cli`** – Syncing source files and translations between your project and Crowdin with Crowdin CLI v5. * **`github-action`** – Setting up and debugging the `crowdin/github-action` step in a GitHub workflow. -* **`create-app`** – Scaffolding, developing, and publishing a Crowdin app. + +**Adding context to source strings** + * **`context-extraction`** – Writing context for the source strings that need it. * **`crowdin-context-cli`** – Working with the `crowdin context` commands and the JSONL format they use. + +**Working with project data** + * **`crowdin-api-client`** – Using the JavaScript and TypeScript API client, including pagination, uploads, and error handling. * **`croql`** – Writing and optimizing CroQL expressions for strings, translations, TM segments, and glossary terms. * **`graphql`** – Writing and debugging Crowdin GraphQL queries against the actual schema. +**Building apps** + +* **`create-app`** – 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. Install Crowdin Skills -## Enriching String Context - -Context tells translators and AI models how a string is used: where it appears in the interface, what the placeholders hold, whether a short word is a button or a page heading. With Skills installed, the agent writes that description from the code where the string is used. - -Two skills cover this flow: `crowdin-context-cli` for the commands and the file format, and `context-extraction` for what a useful context description looks like. - - - 1. The agent runs `crowdin context download` and receives a JSONL file with your source strings. - 2. The agent traces where each string is used in your codebase and writes a short description of its purpose and placement. - 3. The agent runs `crowdin context upload`, and the context appears in your Crowdin project. - - -The download command takes filters, so the agent can work on a single branch, a set of labels, or only the strings that have no context yet. Run `crowdin context status` to see how much of your project is covered, and `crowdin context reset` to remove the context generated by the agent while keeping the context written by hand. - - - Read more about the [`crowdin context` commands](https://crowdin.github.io/crowdin-cli/commands/crowdin-context). - +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 diff --git a/src/content/docs/developer/dev-tools/overview.mdx b/src/content/docs/developer/dev-tools/overview.mdx index 359a95bb9..d594161ff 100644 --- a/src/content/docs/developer/dev-tools/overview.mdx +++ b/src/content/docs/developer/dev-tools/overview.mdx @@ -14,7 +14,7 @@ Crowdin provides a set of tools that help you to automate the localization proce ## 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. One of the skills has the agent write context for your source strings by reading the code where each string is used. +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.
Read the Guide diff --git a/src/content/docs/enterprise/project-management/advisors.mdx b/src/content/docs/enterprise/project-management/advisors.mdx index 89983e2e8..099642690 100644 --- a/src/content/docs/enterprise/project-management/advisors.mdx +++ b/src/content/docs/enterprise/project-management/advisors.mdx @@ -8,7 +8,6 @@ sidebar: import { Aside, CardGrid, LinkCard, Badge } from '@astrojs/starlight/components'; import { Icon } from 'astro-icon/components'; -import ReadMore from '~/components/ReadMore.astro'; Advisors monitor your project setup in the background and flag when something is missing, drifting, or under-configured, acting like a linter for your localization setup. Each finding appears as a recommendation card on the **Advisors** tab, with a clear next step to resolve it. @@ -79,10 +78,6 @@ The built-in Advisors cover the configuration dimensions that most directly affe Some checks apply only to certain content types. For example, the video preview check appears for projects with subtitle files, and the website context check for CMS projects. Checks that don't apply to your project aren't shown. - - Read more about [enriching string context with an AI coding agent](/developer/crowdin-skills/#enriching-string-context). - - ## Re-check Advisors Advisors re-check themselves automatically when relevant things change in your project, such as added files or strings, updated settings, or assigned glossaries and style guides. To avoid unnecessary recalculations, checks refresh within an hour (or within a day for the heavier string context coverage check) of relevant changes rather than on every edit, so a result may not update the instant you make a change. diff --git a/src/content/docs/enterprise/project-management/sources/string-management.mdx b/src/content/docs/enterprise/project-management/sources/string-management.mdx index 2b80f6528..7540505bf 100644 --- a/src/content/docs/enterprise/project-management/sources/string-management.mdx +++ b/src/content/docs/enterprise/project-management/sources/string-management.mdx @@ -95,9 +95,12 @@ You can add context to the string, add or remove labels, set the max. length of Editing Strings - - Read more about [enriching string context with an AI coding agent](/developer/crowdin-skills/#enriching-string-context). - + To edit some particular word or phrase that appears in multiple source strings, you can use the **Find and replace** feature in **Sources > Strings**.