Agent skill

Crowdin API Client

by crowdin in crowdin/crowdin-cli

A skill your agent uses when implementing, refactoring, or reviewing @crowdin/crowdin-api-client usage in any JavaScript or TypeScript project, especially for endpoint selection, request/response…

MITAuto-check passedDevelopment

Install Crowdin API Client

skills CLI
$ npx skills add crowdin/crowdin-cli --skill crowdin-api-client -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install crowdin/crowdin-cli crowdin-api-client --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/crowdin/crowdin-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/crowdin-api-client .claude/skills/crowdin-api-client && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
crowdin-api-client
GitHub stars
320
Token cost
~1.1k tokens
SKILL.md length
360 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when implementing, refactoring, or reviewing @crowdin/crowdin-api-client usage in any JavaScript or TypeScript project, especially for endpoint selection, request/response…

  • Works in 4 steps: Check local declarations first:… → Confirm exact API class and method name… → Confirm request model type and required… → …
  • Reviewing @crowdin/crowdin-api-client usage in any JavaScript
  • SKILL.md covers Overview, When to Use, Required Preflight (Before… and Quick Reference, plus 4 more sections
  • Needs CROWDIN_TOKEN

What it does

Crowdin API Client is an agent skill from crowdin/crowdin-cli. Use when implementing, refactoring, or reviewing @crowdin/crowdin-api-client usage in any JavaScript or TypeScript project, especially for endpoint selection, request/response typing, pagination, uploads, retries, timeouts, or CrowdinError handling.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Third-party API integration and Refactoring. It works with JavaScript and TypeScript. The repository describes itself as: A command-line client for the Crowdin API. The licence is MIT.

When your agent uses it

  • Reviewing @crowdin/crowdin-api-client usage in any JavaScript
  • TypeScript project
  • Especially for endpoint selection
  • Request/response typing

Example prompts

  • “/crowdin-api-client”

Requirements

  • A credential in CROWDIN_TOKEN

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Check local declarations first: node_modules/@crowdin/crowdin-api-client/out//index.d.ts.
  2. Confirm exact API class and method name in use.
  3. Confirm request model type and required fields.
  4. Confirm response envelope: ResponseList or ResponseObject.

What it can do on your machine

Read from SKILL.md and the folder at commit 22a296c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • crowdin.github.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • CROWDIN_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Crowdin API Client loads about 1.1k tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 360 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from crowdin/crowdin-cli at commit 22a296c, republished under its MIT licence (© crowdin). 360 words, ~1,100 tokens.

Download SKILL.mdSave it as .claude/skills/crowdin-api-client/SKILL.md (or your agent's skills folder).
name
crowdin-api-client
description
Use when implementing, refactoring, or reviewing `@crowdin/crowdin-api-client` usage in any JavaScript or TypeScript project, especially for endpoint selection, request/response typing, pagination, uploads, retries, timeouts, or `CrowdinError` handling.

Crowdin API Client

Overview

Use this skill when touching Crowdin API integration code in any project that depends on @crowdin/crowdin-api-client. Core principle: verify local client typings first, then implement with strict model types and correct response envelope handling.

When to Use

  • New or changed calls to @crowdin/crowdin-api-client.
  • Compile/type errors after API-client upgrades.
  • Confusion about method names, request fields, or ResponseList vs ResponseObject.
  • Refactors involving uploads, file translations, screenshots, tasks, comments, strings, or projects.
  • Reviews where behavior works at runtime but types/mapping look suspicious.

Do not use this skill for unrelated infra-only changes.

Required Preflight (Before Editing)

  1. Check local declarations first: node_modules/@crowdin/crowdin-api-client/out/<module>/index.d.ts.
  2. Confirm exact API class and method name in use.
  3. Confirm request model type and required fields.
  4. Confirm response envelope: ResponseList<T> or ResponseObject<T>.

Do not code from memory when typings and docs disagree.

Quick Reference

ScenarioPreferred Pattern
Multi-module flownew Client(credentials, options) and destructure needed APIs
Single narrow flowDirect module API class is acceptable
Full collection reads.withFetchAll()
Transient failuresretryConfig
Bounded request duration{ httpRequestTimeout: 60_000 }
UploadsuploadStorageApi.addStorage -> sourceFilesApi.createFile
Error branchingCrowdinValidationError before CrowdinError

Core Patterns

Bootstrap
ts
import { Client, Credentials } from '@crowdin/crowdin-api-client';

const credentials: Credentials = {
  token: process.env.CROWDIN_TOKEN!,
  organization: process.env.CROWDIN_ORG,
};

const client = new Client(credentials);
Response Envelope Handling
ts
const listResponse = await client.tasksApi.withFetchAll().listTasks(projectId, options);
const tasks = listResponse.data.map((entry) => entry.data); // ResponseList<T>

const createResponse = await client.tasksApi.addTask(projectId, request);
const task = createResponse.data; // ResponseObject<T>
Typed Request Models
ts
const request: TasksModel.CreateTaskRequest = {
  title: 'My Task',
  languageId: 'de',
  type: 0,
  fileIds: [12],
};
Error Handling
ts
import { CrowdinError, CrowdinValidationError } from '@crowdin/crowdin-api-client';

try {
  // API call
} catch (error) {
  if (error instanceof CrowdinValidationError) throw error;
  if (error instanceof CrowdinError) throw error;
  throw error;
}
Show full SKILL.md (169 more words)Show less

Common Mistakes

MistakeFix
Guessing endpoint methods from memoryValidate in local index.d.ts first
Treating list response as object responseCheck ResponseList<T> vs ResponseObject<T> and map accordingly
Weakening or bypassing model typingUse client *Model types in service signatures and fixtures
Manual pagination loops by defaultPrefer .withFetchAll() unless custom batching is required
Uploading file directly to createFileCreate storage first, then pass storageId
Catching all errors as genericBranch CrowdinValidationError and CrowdinError explicitly

Verification Gate

After changing API-client usage:

  1. Run lint/type checks in the current project.
  2. Run at least one targeted test for the modified API flow.
  3. If tests fail on strict typing, fix fixture/model typing instead of loosening production types.

Review Checklist

  • Correct API module and method for the task.
  • Request models are explicit and include required fields.
  • Response mapping matches envelope shape.
  • Type safety is preserved without bypassing model contracts.
  • Pagination strategy matches expected volume.
  • Retry/timeout/runtime options fit environment.
  • Error handling distinguishes validation from generic API errors.

Reference docs: Crowdin API Client modules

© crowdin, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/crowdin-api-client of crowdin/crowdin-cli.

Open the folder on GitHubat commit 22a296c

Compare with similar skills

Crowdin API Client next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Crowdin API Client compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Crowdin API Client this skillcrowdin/crowdin-cli320—~1.1kAutomated safety check: PassMIT
Dinero Best Practicesdinerojs/dinero.js6.8k—~756Automated safety check: PassMIT
ast-grep Codemod Referencewarp-drive-data/warp-drive3.2k—~2.6kAutomated safety check: PassMIT
DRY Refactoring With jscpdkucherenko/jscpd6.4k—~2.1kAutomated safety check: PassMIT
Coding Agentmastra-ai/mastra29k—~2.3kAutomated safety check: PassCustom licence
jscpd Duplicate Code Detectorkucherenko/jscpd6.4k—~4.5kAutomated safety check: PassMIT

Similar skills

  • Dinero Best Practices

    dinerojs/dinero.js

    Core best practices for the Dinero.js money library. An agent skill from dinerojs/dinero.js.

    6.8k GitHub stars~756 tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • ast-grep Codemod Reference

    warp-drive-data/warp-drive

    Reference for writing and debugging TypeScript and JavaScript codemods with @ast-grep/napi: parsing, node queries, meta-variables, rule objects and editing.

    3.2k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Removes copy-paste duplication found by jscpd, starting with exact clones and hotspots, then renamed and near-miss copies, using proven refactoring strategies.

    6.4k GitHub stars~2.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Coding Agent

    mastra-ai/mastra

    Authoring playbook for building agents that write, edit, review, or refactor code.

    29k GitHub stars~2.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Finds duplicated code in 220+ languages with jscpd, reports exact, renamed and near-miss clones in a compact agent-friendly format and measures duplication.

    6.4k GitHub stars~4.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Typescript Best Practices

    jwynia/agent-skills

    Guide AI agents through TypeScript coding best practices including type safety, error handling, code organization, and architecture patterns.

    166 GitHub stars~2.5k tokensUpdated 7 mo ago
    DevelopmentAuto-check passed

More from crowdin/crowdin-cli

  • Add E2E Test Suite

    crowdin/crowdin-cli

    Adds a new end-to-end (e2e) test suite for the Crowdin CLI under tests/e2e/suites/, exercising real CLI commands against a freshly-created Crowdin project.

    320 GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Live Crowdin CLI Validation

    crowdin/crowdin-cli

    Validates CLI commands against live environments with safe setup and cleanup.

    320 GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Render Command Output

    crowdin/crowdin-cli

    A skill your agent uses when adding or changing what a CLI command prints - creating or editing views (views.ts), list/item/grid/table rendering, deciding what --output plain, json, or toon emit…

    320 GitHub stars~1.6k tokensUpdated today
    Auto-check passed

Questions about Crowdin API Client

What does Crowdin API Client do?

A skill your agent uses when implementing, refactoring, or reviewing @crowdin/crowdin-api-client usage in any JavaScript or TypeScript project, especially for endpoint selection, request/response…. Crowdin API Client is an agent skill from crowdin/crowdin-cli. Use when implementing, refactoring, or reviewing @crowdin/crowdin-api-client usage in any JavaScript or TypeScript project, especially for endpoint selection, request/response typing, pagination, uploads, retries, timeouts, or CrowdinError handling.

When should I use Crowdin API Client?

Crowdin API Client fits situations like: reviewing @crowdin/crowdin-api-client usage in any JavaScript; typeScript project; especially for endpoint selection; request/response typing.

How do I install Crowdin API Client in Claude Code?

Run `npx skills add crowdin/crowdin-cli --skill crowdin-api-client -a claude-code`. Or copy the skill folder (.agents/skills/crowdin-api-client in crowdin/crowdin-cli) into .claude/skills/crowdin-api-client in your project. Claude Code loads it when a task matches its description.

How do I install Crowdin API Client in Codex?

Run `npx skills add crowdin/crowdin-cli --skill crowdin-api-client -a codex`. Or copy the skill folder (.agents/skills/crowdin-api-client in crowdin/crowdin-cli) into .agents/skills/crowdin-api-client in your project. Codex loads it when a task matches its description.

Can I use Crowdin API Client in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add crowdin/crowdin-cli --skill crowdin-api-client -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/crowdin-api-client, .gemini/skills/crowdin-api-client, .github/skills/crowdin-api-client and .opencode/skills/crowdin-api-client in your project.

What does Crowdin API Client need to run?

Going by SKILL.md and its folder, Crowdin API Client needs credentials named CROWDIN_TOKEN. Our summary lists: A credential in CROWDIN_TOKEN.

Does Crowdin API Client access the network?

SKILL.md names 1 domain. As links in the text: crowdin.github.io. This is read from the text; nothing was executed.

Is Crowdin API Client safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Crowdin API Client use?

Crowdin API Client is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Crowdin API Client use?

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Crowdin API Client?

Skills that share tags, products or a category with Crowdin API Client: Dinero Best Practices (dinerojs/dinero.js, 6.8k stars), ast-grep Codemod Reference (warp-drive-data/warp-drive, 3.2k stars), DRY Refactoring With jscpd (kucherenko/jscpd, 6.4k stars) and Coding Agent (mastra-ai/mastra, 29k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Crowdin API Client?

crowdin (a GitHub organization) maintains it in crowdin/crowdin-cli, which has 320 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 7, 2026.

Source: crowdin/crowdin-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.