Skip to main content
When AI coding assistants like Claude Code, Cursor, or GitHub 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.
More skills are coming. Have an idea or feedback? Let us know.

Source on GitHub


Available Skills

i18n-translate

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.

i18n-respect-copywriting-guidelines

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.

i18n-detect-hardcoded

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.

i18n-enforcing-source-language-only

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.

Installation

Prerequisites

Some skills require the 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:
npm install -g prismy-cli
prismy auth <your-api-key>
Get your API key from Prismy Settings.

Install all skills

npx skills add prismy-io/prismy-agent-skill

Install specific skills

Every skill is optional. Pick only what you need:
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
For most projects using Prismy, install the translation workflow, copywriting guidelines, and the source-only guard:
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:
ApproachHow translations are generated
With i18n-translate skillYour AI assistant runs prismy generate locally after editing source keys. Translations are ready before you push.
Without i18n-translate skillYou 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 or GitLab integration guides for details on the comment-based workflow.

FAQ

The skills are compatible with any assistant that supports the agent skills standard, including Claude Code, Cursor, GitHub Copilot, and similar tools.
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.
No. Every skill is entirely optional and independent. Install only the ones that match your workflow. You can always add or remove skills later.
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.
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 for details.
The skills are open source and available on GitHub: prismy-io/prismy-agent-skill. Licensed under MIT.