AI

Carbone Skill

Accurate Carbone tag syntax, formatters, and best practices for AI assistants

Overview

A Carbone Skill is a knowledge file that teaches AI assistants the Carbone templating syntax, so they can design valid templates accurately, without trial and error.

What the Skill covers: the complete Carbone universal templating syntax (tags, formatters, conditions, loops, aliases, :set, translations and in-template options) for every template format, from Word, Excel and PowerPoint to HTML, Markdown and PDF forms. It also teaches the AI to add Carbone tags to the documents it generates, follow best practices, and check each template before rendering.

Want the skill and the Carbone MCP server together? The Carbone Agent Plugin installs both in one step.

Installation

Download carbone.skill  ·  View source on GitHub

Skills CLI

The skills CLI finds the assistants on your computer and installs the skill in each one you choose. It needs Node.js.

npx skills add carboneio/carbone-agent-plugin -g

To install it by hand instead, follow the steps for your assistant below.

Claude (Desktop & claude.ai)

First, open Settings → Capabilities and enable Code execution and file creation (Create and edit files in the updated settings layout), since skills will not run without it. On Team and Enterprise plans, an Owner enables it in Organization settings → Capabilities.

Then upload the skill:

  1. Click the Customize button in the left navigation bar and select Skills
  2. Click the + button, then Create skill
  3. Choose Upload a skill and select carbone.skill

The skill appears in your list, toggled on for all conversations. To render documents from Claude too, add the Carbone MCP server as a custom connector.

Claude Code

Extract the skill into your personal skills folder so it is available across all your projects:

mkdir -p ~/.claude/skills
unzip carbone.skill -d ~/.claude/skills/

To limit it to a single project instead, extract it into .claude/skills/ in the project directory.

ChatGPT

  1. Open Skills (or go to chatgpt.com/skills)
  2. Click Create → Upload from your computer
  3. Select carbone.skill

ChatGPT scans the skill, then lists it under Installed. Skills are available on ChatGPT Business, Enterprise, Edu, Teachers and Healthcare plans; on Enterprise and Edu, a workspace admin may need to turn on skills and skill uploading first.

To render documents from ChatGPT as well, install the Carbone plugin from the ChatGPT marketplace, which connects ChatGPT to the Carbone MCP server.

OpenAI Codex

Extract the skill into your personal skills folder so it is available across all your projects:

mkdir -p ~/.agents/skills
unzip carbone.skill -d ~/.agents/skills/

To limit it to a single project instead, extract it into .agents/skills/ in the project directory. Codex scans .agents/skills from your working directory up to the repository root.

Cursor

Extract the skill into your personal skills folder so it is available across all your projects:

mkdir -p ~/.cursor/skills
unzip carbone.skill -d ~/.cursor/skills/

To limit it to a single project instead, extract it into .cursor/skills/ in the project directory.

GitHub Copilot

Extract the skill into your personal skills folder so it is available across all your projects:

mkdir -p ~/.copilot/skills
unzip carbone.skill -d ~/.copilot/skills/

To limit it to a single project instead, extract it into .github/skills/ in the project directory.

Gemini CLI

Install the skill in Gemini CLI directly from GitHub:

gemini skills install https://github.com/carboneio/carbone-agent-plugin.git --path skills/carbone

To limit it to the current project only, add --scope workspace. Or extract the downloaded skill into your skills folder (.gemini/skills/ for a single project):

mkdir -p ~/.gemini/skills
unzip carbone.skill -d ~/.gemini/skills/

Antigravity

Gemini CLI on the free tier or Google One has been replaced by Antigravity: install the skill here.

Extract the skill into your personal skills folder so it is available across all your projects in the Antigravity app and IDE:

mkdir -p ~/.gemini/config/skills
unzip carbone.skill -d ~/.gemini/config/skills/

For Antigravity CLI, use ~/.gemini/antigravity-cli/skills/ instead. To limit it to a single project, extract it into .agents/skills/ in the project directory.

Devin

Extract the skill into your personal skills folder so it is available across all your projects:

mkdir -p ~/.config/devin/skills
unzip carbone.skill -d ~/.config/devin/skills/

To limit it to a single project instead, extract it into .devin/skills/ in the project directory.

Kiro

In the Kiro IDE:

  1. Open Agent Steering & Skills in the Kiro panel, click +, then Import a skill.
  2. Choose GitHub and enter https://github.com/carboneio/carbone-agent-plugin/tree/main/skills/carbone.

For Kiro CLI, extract the skill into your personal skills folder:

mkdir -p ~/.kiro/skills
unzip carbone.skill -d ~/.kiro/skills/

To limit it to a single project instead, extract it into .kiro/skills/ in the project directory.

Muse Code

Extract the skill into your personal skills folder so it is available across all your projects:

mkdir -p ~/.agents/skills
unzip carbone.skill -d ~/.agents/skills/

To limit it to a single project instead, extract it into .agents/skills/ in the project directory. Already installed the skill for Claude Code? Run muse skills import --from claude instead.

Vibe

Extract the skill into your personal skills folder so it is available across all your projects in the Vibe CLI (by Mistral):

mkdir -p ~/.vibe/skills
unzip carbone.skill -d ~/.vibe/skills/

To limit it to a single project instead, extract it into .vibe/skills/ in the project directory. Vibe loads project skills only when the working directory is trusted.

Grok

Extract the skill into your personal skills folder so it is available across all your projects:

mkdir -p ~/.grok/skills
unzip carbone.skill -d ~/.grok/skills/

To limit it to a single project instead, extract it into .grok/skills/ in the project directory.

Grok discovers skills from ./.grok/skills/ (walked up to the repo root), ~/.grok/skills/, any enabled plugin's skills/ directory, and any extra paths listed under [skills] paths in ~/.grok/config.toml.

Grok is also fully compatible with Claude Code, with zero configuration needed: it automatically reads Claude Code marketplaces, plugins, skills, MCPs, agents, hooks, and instruction files (CLAUDE.md, Claude.md, CLAUDE.local.md, and .claude/rules/) alongside .grok/. A skill already installed for Claude Code works in Grok with no extra setup.

Other Assistants and Models

Other agents that support skills: use the Skills CLI, or install carbone.skill the way your agent documents.

Models without a skills system (a direct model API in your own app): prepend carbone/SKILL.md, from the downloaded skill, to your system prompt so the model always has the Carbone syntax.

Update the Skill

Update the skill when Carbone ships major updates to stay in sync with new formatters, options, and syntax changes:

Watch the carboneio/carbone-agent-plugin repository on GitHub to be notified of new releases.

Troubleshooting

Symptom Fix
Claude doesn't use the skill Turn on Code execution and file creation in Settings → Capabilities. On Team and Enterprise plans, an Owner turns it on.
The skill isn't detected Check the folder layout: the file must be at skills/carbone/SKILL.md, not skills/carbone/carbone/SKILL.md. Extract carbone.skill into the skills folder itself.
unzip isn't available (Windows) In PowerShell, rename the file first, since Expand-Archive only accepts .zip: Rename-Item carbone.skill carbone.zip, then Expand-Archive carbone.zip -DestinationPath $HOME.claudeskills.
The assistant ignores the skill Name it in your request, for example: "Use the Carbone skill to design an invoice template."

Next Steps