> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prismy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Agent Skills

> Agent skills for Claude Code, Cursor, GitHub Copilot and other AI coding assistants to manage i18n workflows with Prismy.

When AI coding assistants like [Claude Code](https://docs.anthropic.com/en/docs/claude-code/skills), [Cursor](https://cursor.com/docs/context/skills), or [GitHub Copilot](https://github.com/features/copilot) write code for you, they often introduce hardcoded strings, edit translation files they shouldn't touch, or ignore your project's glossary and tone of voice.

Prismy's agent skills solve this. They are a set of instructions that plug into your AI assistant so it understands your i18n workflow, follows your copywriting rules, and generates translations properly. Instead of cleaning up after your AI, you get internationalization-ready code from the start.

Every skill is **optional and independent**. Install one, a few, or all of them depending on your workflow.

***

## Vision

Prismy embraces your coding flow and super-charges it.

AI agents will try to translate your app themselves. These skills make sure they do it **right**: respecting your glossary, following your guidelines, and never bypassing your translation engine.

Prismy keeps these skills aligned with the latest AI assistant standards and i18n best practices, so you don't have to.

<Note>
  More skills are coming. Have an idea or feedback? [Let us
  know](mailto:cyril@prismy.io).
</Note>

<Card title="Source on GitHub" icon="github" href="https://github.com/prismy-io/prismy-agent-skill" arrow="true" />

***

## Available Skills

<CardGroup cols={2}>
  <Card title="i18n-translate" icon="language">
    Generates translations locally via the Prismy CLI after your assistant modifies source keys. Skip this skill if you prefer triggering translations from your PR/MR instead.

    Requires Prismy CLI and an API key.
  </Card>

  <Card title="i18n-respect-copywriting-guidelines" icon="book">
    Fetches your glossary and wording instructions from Prismy before the AI writes any user-facing copy. Keeps every string on-brand and consistent.

    Requires Prismy CLI and an API key.
  </Card>

  <Card title="i18n-detect-hardcoded" icon="magnifying-glass">
    Scans code changes for hardcoded strings (labels, headings, error messages, etc.) and flags them for extraction into locale files.

    Generic skill. No Prismy account needed.
  </Card>

  <Card title="i18n-enforcing-source-language-only" icon="shield-check">
    Prevents the AI from editing target-language locale files. Translations come from your translation engine, not from the AI guessing.

    Generic skill. No Prismy account needed.
  </Card>
</CardGroup>

***

## Installation

### Prerequisites

Some skills require the [Prismy CLI](https://www.npmjs.com/package/prismy-cli) (see each skill's description above). If you only install generic skills like **i18n-detect-hardcoded** or **i18n-enforcing-source-language-only**, no CLI setup is needed.

For skills that use the CLI:

```bash theme={null}
npm install -g prismy-cli
prismy auth <your-api-key>
```

Get your API key from [Prismy Settings](https://app.prismy.io/settings).

### Install all skills

```bash theme={null}
npx skills add prismy-io/prismy-agent-skill
```

### Install specific skills

Every skill is optional. Pick only what you need:

```bash theme={null}
npx skills add prismy-io/prismy-agent-skill --skill i18n-translate
npx skills add prismy-io/prismy-agent-skill --skill i18n-respect-copywriting-guidelines
npx skills add prismy-io/prismy-agent-skill --skill i18n-detect-hardcoded
npx skills add prismy-io/prismy-agent-skill --skill i18n-enforcing-source-language-only
```

### Recommended combination

For most projects using Prismy, install the translation workflow, copywriting guidelines, and the source-only guard:

```bash theme={null}
npx skills add prismy-io/prismy-agent-skill \
  --skill i18n-translate \
  --skill i18n-respect-copywriting-guidelines \
  --skill i18n-enforcing-source-language-only
```

***

## How to Use

Once installed, the skills work **automatically**. There is nothing to configure in your code. Your AI assistant picks them up and follows their instructions as it writes code.

Here is what changes in practice:

1. **You prompt your AI assistant as usual** ("add a signup button", "refactor this component", etc.).
2. The assistant detects which skills are installed and applies them in the background.
3. Depending on the skills you have:
   * Hardcoded strings are flagged and extracted to your locale files.
   * Target-language files are left untouched.
   * New copy follows your glossary and brand guidelines.
   * Translations are generated locally via `prismy generate`.

You do not need to mention the skills in your prompts. They act as guardrails and best practices that your AI assistant follows on every task.

You can also trigger a skill manually at any time by asking your assistant directly, for example: "run i18n-detect-hardcoded on the files I changed" or "check my copywriting guidelines before I commit".

***

## GitHub & GitLab Integration

AI agent skills are fully compatible with Prismy's GitHub and GitLab integrations. They cover different moments of your workflow:

* **Skills** act during local development, while your AI assistant is writing code.
* **GitHub / GitLab integration** acts when you push or open a PR/MR, letting you trigger translations via a comment.

You can use both together, or choose one approach:

| Approach                         | How translations are generated                                                                                      |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **With i18n-translate skill**    | Your AI assistant runs `prismy generate` locally after editing source keys. Translations are ready before you push. |
| **Without i18n-translate skill** | You push your changes and trigger translations directly from the PR/MR with a comment.                              |

Both approaches produce the same result. The choice depends on whether you prefer translations generated locally or from the PR/MR.

The other skills (detect hardcoded, copywriting guidelines, source-only guard) work independently of how you generate translations.

See the [GitHub](/tech/github) or [GitLab](/tech/gitlab) integration guides for details on the comment-based workflow.

***

## FAQ

<AccordionGroup>
  <Accordion title="Which AI coding assistants are supported?">
    The skills are compatible with any assistant that supports the agent skills
    standard, including **Claude Code**, **Cursor**, **GitHub Copilot**, and
    similar tools.
  </Accordion>

  <Accordion title="Do I need a Prismy account?">
    Not necessarily. **i18n-detect-hardcoded** and **i18n-enforcing-source-language-only** are generic i18n best-practice skills that work on any project without a Prismy account.

    **i18n-translate** and **i18n-respect-copywriting-guidelines** require the Prismy CLI and an API key, since they call Prismy's services.
  </Accordion>

  <Accordion title="Are the skills mandatory?">
    No. Every skill is entirely optional and independent. Install only the ones
    that match your workflow. You can always add or remove skills later.
  </Accordion>

  <Accordion title="Do skills modify my translation files directly?">
    The **i18n-translate** skill calls the Prismy CLI to generate translations.
    The **i18n-enforcing-source-language-only** skill actively prevents the AI
    from editing target-language files directly. Your translations always go
    through your translation engine, not the AI.
  </Accordion>

  <Accordion title="Will skills conflict with the GitHub/GitLab integration?">
    No. They complement each other. Skills handle the local development phase,
    while the GitHub/GitLab integration handles the CI/PR phase. See the [section
    above](#github--gitlab-integration) for details.
  </Accordion>

  <Accordion title="Where is the source code?">
    The skills are open source and available on GitHub:
    [prismy-io/prismy-agent-skill](https://github.com/prismy-io/prismy-agent-skill).
    Licensed under MIT.
  </Accordion>
</AccordionGroup>