{
  "markdown": "# Carbone Skill — Official Carbone Templating Syntax for AI Assistants\n\nTeaches AI assistants the Carbone Universal Templating Language — so they can design templates from scratch or embed Carbone tags into generated DOCX, XLSX, and PPTX files.\n\n## Compatibility\n\nWorks with any platform that supports the open [Agent Skills](https://agentskills.io) standard:\n\n| Platform | Instructions |\n|---|---|\n| Claude (claude.ai) | [docs.claude.com](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) |\n| Claude Code | [code.claude.com](https://code.claude.com/docs/en/skills) |\n| ChatGPT | [developers.openai.com](https://developers.openai.com/codex/skills/) |\n| Cursor | [cursor.com/docs](https://cursor.com/docs/context/skills) |\n| VS Code (GitHub Copilot) | [code.visualstudio.com](https://code.visualstudio.com/docs/copilot/customization/agent-skills) |\n| Gemini CLI | [geminicli.com/docs](https://geminicli.com/docs/cli/skills/) |\n| OpenAI Codex | [developers.openai.com](https://developers.openai.com/codex/skills/) |\n| All other platforms | [agentskills.io](https://agentskills.io/home) |\n\n## Download\n\n**[carbone.skill](https://github.com/carboneio/carbone-skill/releases/latest/download/carbone.skill)** — latest release\n\n## Installation\n\n### Claude.ai\n\n1. Go to **Customize → Skills** (at claude.ai/customize/skills)\n2. Click **+** → **Upload a skill** and upload `carbone.skill`\n\n### Claude Code\n\nRegister the repository as a plugin marketplace:\n\n```\n/plugin marketplace add carboneio/carbone-skill\n```\n\nThen install the skill:\n\n```\n/plugin install carbone@carbone-skill\n```\n\nOr install manually by extracting `carbone.skill`:\n\n```bash\nunzip carbone.skill -d ~/.claude/skills/carbone\n```\n\n### Cursor\n\nSee [cursor.com/docs/context/skills](https://cursor.com/docs/context/skills) for the exact install path.\n\n### VS Code (GitHub Copilot)\n\n```bash\nunzip carbone.skill -d ~/.copilot/skills/carbone\n```\n\n### Gemini CLI\n\n```bash\ngemini skills install carbone.skill\n```\n\n### OpenAI Codex\n\n```bash\nunzip carbone.skill -d ~/.agents/skills/carbone\n```\n\n### Other platforms\n\nSee [agentskills.io](https://agentskills.io/home) for platform-specific instructions.\n\n## Used with Carbone MCP\n\nThe Carbone Skill pairs with the [Carbone MCP server](https://carbone.io/documentation/developer/ai/mcp.html). The skill gives the AI assistant deep knowledge of Carbone's templating syntax, while the MCP server provides direct API access to render documents. Together, they let you design templates and generate documents in a single conversation: the skill handles syntax correctness, the MCP handles API actions.\n\n## What the skill covers\n\n- Tag syntax: `{d.}`, `{c.}`, aliases, i18n, in-template options\n- Formatters: date, number, string, currency, and chaining\n- Conditions: `showBegin/showEnd`, `hideBegin/hideEnd`, ternary expressions\n- Loops: arrays, nested loops, aggregation, drop-row patterns\n- `:set` patterns for computed and conditional values\n- HTML templates: CSS injection, charts, headers/footers, PDF options\n- Markdown templates: loops in tables, converting to DOCX/PDF\n- Embedding Carbone tags into AI-generated DOCX, XLSX, and PPTX files\n- Best practices and a validation checklist\n- Template formats: `XML` `HTML` `ODT` `ODS` `ODP` `DOCX` `XLSX` `PPTX` `ODG` `SVG` `MD` `IDML` — and `PDF` form templates\n- Export formats: `PDF` `DOCX` `XLSX` `PPTX` `ODT` `ODS` `ODP` `HTML` `CSV` `TXT` `JPG` `PNG` `GIF` `SVG` `WEBP` `EPUB` `MD` `RTF` (160+ conversions)\n\n## How to update\n\nRe-download the latest release when Carbone ships major updates:\n\n**[Latest release](https://github.com/carboneio/carbone-skill/releases/latest)**\n\nChangelog: [carbone.io/changelog.html](https://carbone.io/changelog.html)\n\n## Contributing\n\nSpotted an error or missing formatter? See [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\nApache-2.0\n",
  "bytes": 3844,
  "sha": "b4711f5e04e76b9d573c82c8454922878c44f18f96109d98c1cfe645c80f703d",
  "repo_slug": "carboneio/carbone-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_carboneio_carbone_skill_carbone_skill_846ea454/readme"
}