carbone-skill — плагин для Claude Code: что делает и как установить
Плагин обучает Claude Code языку шаблонов Carbone для вёрстки отчётов в DOCX или PDF. Пригодится при сборке документов из JSON прямо в диалоге.
Apache-2.0 ★ 6 обновлён 2026-10-23
/plugin install carbone-skill@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-officialЧто делает carbone-skill
Плагин добавляет в ассистент справочник синтаксиса Carbone. Claude Code начинает понимать теги подстановки {d.}, условия showBegin/showEnd и циклы по массивам. Это исключает ошибки в разметке офисных файлов и HTML.
Шаблоны можно писать локально. Однако для сборки готовых файлов и конвертации между 160+ форматами требуется удалённый сервер https://mcp.carbone.io. Без авторизации на сервере через /mcp плагин проектирует шаблоны и проверяет теги, но не отрендерит готовый PDF.
Разметка поддерживает вложенные циклы, расчётные переменные через :set и скрытие пустых строк. Инструмент сразу сверяет код со встроенным чек-листом.
Какие задачи решает
- разметить файл DOCX или XLSX тегами подстановки Carbone
- настроить циклы и агрегацию данных в таблицах
- отформатировать даты и валюты цепочками фильтров
- подготовить Markdown или HTML к экспорту в PDF
Примеры запросов агенту
- Добавь в шаблон счёта
invoice.docxцикл по товарам с подсчётом общей суммы - Проверь синтаксис условий
showBeginи форматирование дат в файлеreport.html - Собери таблицу в Markdown с тегами Carbone для последующего экспорта в PDF
Как установить carbone-skill
Через маркетплейс плагинов
/plugin install carbone-skill@claude-plugins-official/plugin marketplace add anthropics/claude-plugins-officialПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о carbone-skill
Как установить carbone-skill в Claude Code?
Сначала подключите каталог командой /plugin marketplace add anthropics/claude-plugins-official. Затем установите плагин: /plugin install carbone-skill@claude-plugins-official.
Что делает плагин carbone-skill?
Он обучает Claude Code синтаксису Carbone: тегам данных, фильтрам, циклам и условиям. Модель помогает собирать шаблоны документов без ошибок в разметке.
Нужен ли аккаунт Carbone для работы плагина?
Проектировать и проверять теги можно без учётной записи. Если нужно рендерить файлы через удалённый MCP-сервер https://mcp.carbone.io, потребуется войти в аккаунт через команду /mcp.
Исходный текст
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