Skip to main content
plugin

carbone-skill — Claude Code plugin: what it does, how to install

Teaches Claude Code the Carbone templating syntax to design DOCX and PDF documents. Useful when generating reports or invoices from structured JSON data.

Apache-2.0 ★ 6 updated 2026-10-23

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin install carbone-skill@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-official
Open on GitHub

What carbone-skill does

The plugin equips the assistant with Carbone syntax documentation. Claude Code learns how to handle {d.} tags, conditional blocks like showBegin/showEnd, and array loops. This prevents syntax errors when editing markup inside office documents or HTML templates.

Template writing works locally. Generating actual binary files and converting between 160+ formats requires the hosted service at https://mcp.carbone.io. Without logging into the Carbone MCP server via /mcp, the assistant validates tags and structures templates, but it cannot render a finished PDF.

The skill covers nested loops, computed values using :set, and drop-row patterns. It also applies an integrated validation checklist to catch formatting mistakes.

What it helps with

  • embed Carbone placeholder tags into DOCX or XLSX templates
  • configure loops and data aggregation inside tables
  • format dates and currencies using formatter chains
  • prepare Markdown or HTML templates for PDF conversion

Example prompts for the agent

  • Add a product loop with total calculations to invoice.docx
  • Validate showBegin conditional tags and date formatters in report.html
  • Build a Markdown table using Carbone tags ready for PDF export

How to install carbone-skill

Plugin marketplace

/plugin install carbone-skill@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-official

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about carbone-skill

How to install carbone-skill in Claude Code?

First, add the marketplace with /plugin marketplace add anthropics/claude-plugins-official. Then install the plugin by running /plugin install carbone-skill@claude-plugins-official.

What does carbone-skill do?

It teaches Claude Code the Carbone templating language. The assistant can write, review, and fix tags, conditions, and loops inside document templates.

Does carbone-skill require a Carbone account?

Designing and inspecting template syntax works offline without an account. Rendering final documents through the remote MCP server at https://mcp.carbone.io requires authenticating via /mcp.

Source text

SKILL.md · Apache-2.0
# Carbone agent plugin

[Add to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Carbone&connectorUrl=https%3A%2F%2Fmcp.carbone.io) [Add to Cursor](https://cursor.com/en/install-mcp?name=carbone&config=eyJ1cmwiOiJodHRwczovL21jcC5jYXJib25lLmlvIn0=) [Install in VS Code](https://vscode.dev/redirect/mcp/install?name=carbone&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.carbone.io%22%7D)

The Carbone agent plugin: the Carbone skill and MCP server for any AI agent that supports skills or remote MCP servers, including Claude, ChatGPT, Codex, Cursor, GitHub Copilot, Gemini CLI and Antigravity. Install it once in your AI assistant to design document templates and generate PDF, Word, Excel and PowerPoint documents from your data in the same conversation.

## What it does

- **The Carbone MCP server** (`https://mcp.carbone.io`) generates documents from your templates and data, converts files between formats, and manages your Carbone template library. It is hosted by Carbone, so there is nothing to run locally. Documentation: [carbone.io/documentation/developer/ai/mcp.html](https://carbone.io/documentation/developer/ai/mcp.html).
- **The Carbone skill** (`skills/carbone/`) teaches the assistant the Carbone templating syntax, so it can write, check and fix templates, or add Carbone tags to the DOCX, XLSX and PPTX files it generates. It follows the open [Agent Skills](https://agentskills.io) standard and works without the server.

### What the skill covers

- Tag syntax: `{d.}`, `{c.}`, aliases, i18n, in-template options
- Formatters: date, number, string, currency, and chaining
- Conditions: `showBegin/showEnd`, `hideBegin/hideEnd`, ternary expressions
- Loops: arrays, nested loops, aggregation, drop-row patterns
- `:set` patterns for computed and conditional values
- HTML templates: CSS injection, charts, headers/footers, PDF options
- Markdown templates: loops in tables, converting to DOCX/PDF
- Embedding Carbone tags into AI-generated DOCX, XLSX, and PPTX files
- Best practices and a validation checklist
- Template formats: `XML` `HTML` `ODT` `ODS` `ODP` `DOCX` `XLSX` `PPTX` `ODG` `SVG` `MD` `IDML`, and `PDF` form templates
- Export formats: `PDF` `DOCX` `XLSX` `PPTX` `ODT` `ODS` `ODP` `HTML` `CSV` `TXT` `JPG` `PNG` `GIF` `SVG` `WEBP` `EPUB` `MD` `RTF` (160+ conversions)

## Install

| Assistant | Install |
|---|---|
| ChatGPT | Plugins directory: coming soon |
| Claude (claude.ai, Desktop, Cowork) | Custom connector `https://mcp.carbone.io`, and upload `carbone.skill`. Directory: coming soon |
| Claude Code | `/plugin marketplace add carboneio/carbone-agent-plugin`, then `/plugin install carbone@carbone` |
| Codex | `codex plugin marketplace add carboneio/carbone-agent-plugin` |
| Cursor | Copy this repository to `~/.cursor/plugins/local/carbone`. Marketplace: coming soon |
| VS Code, GitHub Copilot | `copilot plugin install carboneio/carbone-agent-plugin`, or **Chat: Install Plugin From Source** |
| Antigravity | `agy plugin install https://github.com/carboneio/carbone-agent-plugin` |
| Gemini CLI | `gemini extensions install https://github.com/carboneio/carbone-agent-plugin` |
| Mistral Le Chat, others | Add the MCP server `https://mcp.carbone.io` as a custom connector |
| Skill only | `npx skills add carboneio/carbone-agent-plugin`, or upload `carbone.skill` |

The skill file is attached to every release: **[carbone.skill](https://github.com/carboneio/carbone-agent-plugin/releases/latest/download/carbone.skill)**.

### Let your assistant set it up

In an assistant that can run commands or edit its own settings, paste this prompt:

```text
Add the Carbone MCP server to this assistant.
Server URL: https://mcp.carbone.io (remote MCP server, Streamable HTTP)
Setup instructions: https://carbone.io/documentation/developer/ai/mcp.md
Then start the sign-in so I can connect my Carbone account.
```

### ChatGPT

Coming soon: Carbone in the ChatGPT Plugins directory. The same listing will cover Codex, which you can already install from this repository (see [Codex](#codex)).

### Claude (claude.ai, Desktop, Cowork)

- **Server**: go to **Customize**, **Connectors**, click **Add custom connector**, and enter the URL `https://mcp.carbone.io`. Or use the link [Add to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Carbone&connectorUrl=https%3A%2F%2Fmcp.carbone.io). On Team and Enterprise plans, an Owner adds it first in **Organization settings**, **Connectors**; then each member clicks **Connect** and signs in.
- **Skill**: go to **Customize**, **Skills** (claude.ai/customize/skills), click **+**, then **Create skill**, **Upload a skill**, and upload `carbone.skill`.

Coming soon: Carbone in the Directory, with the connector and the plugin in one listing.

### Claude Code

```
/plugin marketplace add carboneio/carbone-agent-plugin
/plugin install carbone@carbone
```

Then run `/mcp`, choose **Authenticate** for Carbone, and sign in.

<details>
<summary>Manual setup</summary>

Server only:

```bash
claude mcp add --transport http --scope user carbone https://mcp.carbone.io
```

Then run `/mcp`, select `carbone` and choose **Authenticate**. `--scope user` makes Carbone available in all your projects. To share it with one project instead, add this to a `.mcp.json` file at its root:

```json
{ "mcpServers": { "carbone": { "type": "http", "url": "https://mcp.carbone.io" } } }
```

Skill only: extract `carbone.skill` into your skills folder.

```bash
unzip carbone.skill -d ~/.claude/skills/
```

</details>

### Codex

```bash
codex plugin marketplace add carboneio/carbone-agent-plugin
```

Then install Carbone from the Plugins Directory. Coming soon: Carbone in the ChatGPT plugin catalog, which Codex uses.

<details>
<summary>Manual setup</summary>

Server only:

```bash
codex mcp add carbone --url https://mcp.carbone.io
codex mcp login carbone
```

The second command opens your browser to sign in.

Skill only: extract `carbone.skill` into your skills folder.

```bash
unzip carbone.skill -d ~/.agents/skills/
```

</details>

### Cursor

Copy this repository to `~/.cursor/plugins/local/carbone`, then restart Cursor or run **Developer: Reload Window**. The skill and the Carbone server appear in Cursor.

Server only: use the link [Add to Cursor](https://cursor.com/en/install-mcp?name=carbone&config=eyJ1cmwiOiJodHRwczovL21jcC5jYXJib25lLmlvIn0=), then sign in from Cursor's MCP settings.

Coming soon: Carbone in the Cursor Marketplace.

### VS Code, GitHub Copilot

Copilot CLI:

```bash
copilot plugin install carboneio/carbone-agent-plugin
```

VS Code: enable the `chat.plugins.enabled` setting, then run **Chat: Install Plugin From Source** with the repository URL `https://github.com/carboneio/carbone-agent-plugin`.

<details>
<summary>Manual setup</summary>

Server only: use the link [Install in VS Code](https://vscode.dev/redirect/mcp/install?name=carbone&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.carbone.io%22%7D), or run:

```bash
code --add-mcp '{"name":"carbone","type":"http","url":"https://mcp.carbone.io"}'
```

VS Code asks you to sign in when it starts the server.

Skill only: extract `carbone.skill` into your skills folder.

```bash
unzip carbone.skill -d ~/.copilot/skills/
```

</details>

### Antigravity

```bash
agy plugin install https://github.com/carboneio/carbone-agent-plugin
```

Then open **Agent settings**, **Customizations**, and choose **Authenticate** for Carbone. Sign-in asks you to copy and paste an authorization code.

### Gemini CLI

```bash
gemini extensions install https://github.com/carboneio/carbone-agent-plugin
```

Restart Gemini CLI. Sign-in starts in your browser the first time Carbone is called; if it doesn't, run `/mcp auth carbone`. Sign-in needs a browser, so it doesn't work over SSH.

Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI on June 18, 2026 (see [Antigravity](#antigravity)).

<details>
<summary>Manual setup</summary>

Server only:

```bash
gemini mcp add --transport http --scope user carbone https://mcp.carbone.io
```

Then run `/mcp auth carbone` in Gemini CLI to sign in.

Skill only:

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

</details>

### Mistral Le Chat and other assistants

Add the MCP server `https://mcp.carbone.io` as a custom connector. In Le Chat, an admin adds the URL. Any assistant that supports remote MCP servers with OAuth can connect the same way.

For the skill alone on other platforms, see [agentskills.io](https://agentskills.io/home).

## Sign in

You sign in with your Carbone account when the assistant first calls Carbone. No account yet? Create one at [carbone.io](https://carbone.io).

## What data it sends

- Templates and data go to the Carbone API only when a tool is called.
- Generated documents are returned to the assistant.
- The skill is a set of instructions read by the assistant. It sends nothing on its own.

Read the [privacy policy](https://carbone.io/company/privacy-policy.html).

## Files in and out

- Templates and data are passed as public links, as text, or from your template library.
- The hosted server can't read local files.

## Support

- Help center: [help.carbone.io](https://help.carbone.io)
- Email: [[email protected]](mailto:[email protected])
- Carbone changelog: [carbone.io/changelog.html](https://carbone.io/changelog.html)
- Spotted an error or missing formatter in the skill? See [CONTRIBUTING.md](CONTRIBUTING.md).

## License

Apache-2.0. See [LICENSE](LICENSE).

© Carbone · Apache-2.0 · carboneio/carbone-agent-plugin

Similar plugins

All plugins for Office documents →

Project sponsors

Companies that keep this analytics open