Skills for teaching agents how to build on Contentful.
$git clone https://github.com/contentful/skillsInstalls into the current project.
Install skills by running `git clone https://github.com/contentful/skills`, then use it for the current task and follow its documentation at https://github.com/contentful/skills.
| 1 | <div align="center"> |
| 2 | |
| 3 | <picture> |
| 4 | <source media="(prefers-color-scheme: dark)" srcset="contentful-logo.svg" /> |
| 5 | <img src="contentful-logo.svg" alt="Contentful" height="40" /> |
| 6 | </picture> |
| 7 | |
| 8 | <br /><br /> |
| 9 | |
| 10 | **Your AI agent knows how to code. These skills teach it Contentful.** |
| 11 | |
| 12 | <br /> |
| 13 | |
| 14 | [](https://github.com/contentful/skills/releases) |
| 15 | [](LICENSE) |
| 16 | [](skills/) |
| 17 | [](https://agentskills.io) |
| 18 | |
| 19 | </div> |
| 20 | |
| 21 | <br /> |
| 22 | |
| 23 | AI coding agents write great code but know nothing about your content model, your SDK patterns, or which of Contentful's five APIs to reach for. **Contentful Skills** fixes that — curated instructions, reference docs, and structured workflows that produce correct Contentful integrations on the first try. |
| 24 | |
| 25 | ## Quickstart — Claude Code |
| 26 | |
| 27 | Two commands. You get seven skills plus live MCP connections to your Contentful spaces. |
| 28 | |
| 29 | ``` |
| 30 | /plugin marketplace add contentful/skills |
| 31 | /plugin install contentful@contentful |
| 32 | ``` |
| 33 | |
| 34 | Run `/reload-plugins` to activate. This registers two MCP servers: |
| 35 | - **contentful-mcp** — connection to `mcp.contentful.com` for CMS operations |
| 36 | - **contentful-personalization** — local MCP for structured personalization workflows |
| 37 | |
| 38 | --- |
| 39 | |
| 40 | ## What's inside |
| 41 | |
| 42 | | Skill | What it does | |
| 43 | |:------|:-------------| |
| 44 | | **[contentful-guide](#contentful-guide)** | Explains core concepts and routes you to the right skill, API, or doc. Start here. | |
| 45 | | **[contentful-api](#contentful-api)** | Language-agnostic REST and GraphQL API reference — curl examples for CMA, CDA, CPA, Images, and GraphQL. | |
| 46 | | **[contentful-nextjs](#contentful-nextjs)** | Integrates Contentful into a Next.js project — SDK setup, content fetching, Draft Mode previews. | |
| 47 | | **[contentful-migration](#contentful-migration)** | Writes and runs content model migration scripts — fields, validations, transforms, editor interfaces. | |
| 48 | | **[contentful-custom-app-from-scratch](#contentful-custom-app-from-scratch)** | Designs, scaffolds, builds, and validates new App Framework custom apps. | |
| 49 | | **[contentful-custom-app-enhancement](#contentful-custom-app-enhancement)** | Improves and debugs existing Contentful custom apps in customer-owned repos. | |
| 50 | | **[contentful-personalization](#contentful-personalization)** | Sets up, debugs, and develops personalization and A/B testing with the Experiences SDK. | |
| 51 | |
| 52 | The custom app skills are packaged together under `skills/contentful-apps/`. |
| 53 | |
| 54 | --- |
| 55 | |
| 56 | ## Other platforms |
| 57 | |
| 58 | Skills also work without the plugin on any platform that supports the [agentskills.io](https://agentskills.io) spec. |
| 59 | |
| 60 | ### Cursor |
| 61 | |
| 62 | Install the [Contentful Cursor plugin](https://cursor.directory/plugins/contentful-1) from Cursor Directory. |
| 63 | |
| 64 | Alternatively, add the skills manually: |
| 65 | |
| 66 | 1. Open **Settings** → **Rules** |
| 67 | 2. Click **Add Rule** → **Remote Rule (GitHub)** |
| 68 | 3. Enter `contentful/skills` |
| 69 | |
| 70 | ### Universal CLI |
| 71 | |
| 72 | ```bash |
| 73 | npx skills add contentful/skills |
| 74 | ``` |
| 75 | |
| 76 | Works with GitHub Copilot, VS Code, OpenAI Codex, Gemini CLI, and [35+ other platforms](https://agentskills.io). |
| 77 | |
| 78 | <details> |
| 79 | <summary><strong>More options</strong></summary> |
| 80 | |
| 81 | <br /> |
| 82 | |
| 83 | **Gemini CLI:** |
| 84 | |
| 85 | ```bash |
| 86 | gemini skills install contentful/skills |
| 87 | ``` |
| 88 | |
| 89 | **GitHub Copilot / VS Code:** |
| 90 | |
| 91 | Skills auto-discover from `.agents/skills/` when added to your project. Use `/skills` in Copilot Chat to confirm they're loaded. |
| 92 | |
| 93 | **Install a single skill:** |
| 94 | |
| 95 | ```bash |
| 96 | npx skills add contentful/skills --skill contentful-personalization |
| 97 | ``` |
| 98 | |
| 99 | Available: `contentful-guide`, `contentful-api`, `contentful-nextjs`, `contentful-migration`, `contentful-custom-app-from-scratch`, `contentful-custom-app-enhancement`, `contentful-personalization` |
| 100 | |
| 101 | </details> |
| 102 | |
| 103 | --- |
| 104 | |
| 105 | ## Skills |
| 106 | |
| 107 | ### contentful-guide |
| 108 | |
| 109 | Explains core Contentful concepts and routes you to the right skill or documentation. Start here if you're new to Contentful or unsure which API to use. |
| 110 | |
| 111 | <details> |
| 112 | <summary>Triggers and details</summary> |
| 113 | |
| 114 | <br /> |
| 115 | |
| 116 | **Activates on:** "Contentful 101", "which API should I use", "how do I get started", "what does X mean in Contentful" |
| 117 | |
| 118 | **Covers:** |
| 119 | - Core vocabulary — spaces, environments, content types, entries, assets, locales |
| 120 | - API selection — CDA vs CPA vs CMA vs GraphQL vs Images API |
| 121 | - Routing to the right implementation skill |
| 122 | - Contentful MCP server orientation |
| 123 | |
| 124 | </details> |
| 125 | |
| 126 | ### contentful-api |
| 127 | |
| 128 | Language-agnostic reference for Contentful's REST and GraphQL APIs. Pair this with any framework or language — examples are curl-based. |
| 129 | |
| 130 | <details> |
| 131 | <summary>Triggers and details</summary> |
| 132 | |
| 133 | <br /> |
| 134 | |
| 135 | **Activates on:** "curl Contentful", "CMA request", "CDA query parameters", "publish entry HTTP", "Images API URL", "Contentful GraphQL query" |
| 136 | |
| 137 | **Covers:** |
| 138 | - Authentication — token types, headers, US/EU base URLs |
| 139 | - HTTP conventions — version locking, rate limits, pagination, error pay |