Setting the issue. One moment.
Contents
Issue No. 47Contentful · Official
contentful /skills
Skills for teaching agents how to build on Contentful.
9 chapters · 33 minutes · 6,981 words
Skills for teaching agents how to build on Contentful.
9 chapters · 33 minutes · 6,981 words
npx skills add contentful/skills/plugin marketplace add contentful/skillsYour AI agent knows how to code. These skills teach it Contentful.
main, last pushed 9 August 2026.SKILL.md, not by matching a directory convention. 3 distinct layouts observed: local-skills/skills/*/SKILL.md, skills/*/SKILL.md, skills/contentful-apps/*/SKILL.md..claude-plugin/marketplace.json by Contentful, declaring 1 plugin. It is read for editorial metadata only — never as the skill index, which is always the repository tree./contentful/skills.md, and each chapter at its own .md URL.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.
Two commands. You get seven skills plus live MCP connections to your Contentful spaces.
/plugin marketplace add contentful/skills
/plugin install contentful@contentfulRun /reload-plugins to activate. This registers two MCP servers:
mcp.contentful.com for CMS operations| Skill | What it does |
|---|---|
| contentful-guide | Explains core concepts and routes you to the right skill, API, or doc. Start here. |
| contentful-api | Language-agnostic REST and GraphQL API reference — curl examples for CMA, CDA, CPA, Images, and GraphQL. |
| contentful-nextjs | Integrates Contentful into a Next.js project — SDK setup, content fetching, Draft Mode previews. |
| contentful-migration | Writes and runs content model migration scripts — fields, validations, transforms, editor interfaces. |
| contentful-custom-app-from-scratch | Designs, scaffolds, builds, and validates new App Framework custom apps. |
| contentful-custom-app-enhancement | Improves and debugs existing Contentful custom apps in customer-owned repos. |
| contentful-personalization | Sets up, debugs, and develops personalization and A/B testing with the Experiences SDK. |
The custom app skills are packaged together under skills/contentful-apps/.
Skills also work without the plugin on any platform that supports the agentskills.io (opens in a new tab) spec.
Install the Contentful Cursor plugin (opens in a new tab) from Cursor Directory.
Alternatively, add the skills manually:
contentful/skillsnpx skills add contentful/skillsWorks with GitHub Copilot, VS Code, OpenAI Codex, Gemini CLI, and 35+ other platforms (opens in a new tab).
Gemini CLI:
gemini skills install contentful/skillsGitHub Copilot / VS Code:
Skills auto-discover from .agents/skills/ when added to your project. Use /skills in Copilot Chat to confirm they’re loaded.
Install a single skill:
npx skills add contentful/skills --skill contentful-personalizationAvailable: contentful-guide, contentful-api, contentful-nextjs, contentful-migration, contentful-custom-app-from-scratch, contentful-custom-app-enhancement, contentful-personalization
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.
Activates on: “Contentful 101”, “which API should I use”, “how do I get started”, “what does X mean in Contentful”
Covers:
Language-agnostic reference for Contentful’s REST and GraphQL APIs. Pair this with any framework or language — examples are curl-based.
Activates on: “curl Contentful”, “CMA request”, “CDA query parameters”, “publish entry HTTP”, “Images API URL”, “Contentful GraphQL query”
Covers:
Add and configure Contentful in a Next.js project. Covers SDK setup, environment variables, content fetching, and Draft Mode preview flows for both App Router and Pages Router.
Activates on: “add Contentful to Next.js”, “Contentful SDK setup”, “Draft Mode”, “preview mode”, “Server Components Contentful”
Covers:
Write and run content model migration scripts using the Contentful migration library. Covers field operations, validations, entry transforms, and editor interface configuration.
Activates on: “write a migration”, “create content type”, “schema migration”, “field validation”, “editor interface”, “changeFieldId”
Covers:
Design, scaffold, build, and validate a new Contentful App Framework custom app for your own repository or workspace.
Activates on: “build a Contentful app”, “custom app from scratch”, “App Framework app”, “sidebar app”, “field editor app”, “page app”, “app action”, “app function”
Covers:
create-contentful-appImprove, debug, and extend an existing Contentful App Framework custom app in a customer-owned repository.
Activates on: “fix my Contentful app”, “improve a custom app”, “enhance App Framework app”, “debug custom app”, “update sidebar app”, “custom app feature request”
Covers:
Set up, debug, and develop with Contentful personalization and A/B testing. A structured, multi-step skill with three workflows and a reference library of 19+ documents.
Activates on: “set up personalization”, “A/B test”, “personalization not working”, “Experiences SDK”, “run an experiment”, “audience targeting”
Workflows:
Reference library: SDK guides, component patterns, SSR/middleware patterns, provider patterns, analytics setup, environment variables, error resolution, and more.
Built with @contentful/skill-kit (opens in a new tab) — a structured state machine with MCP server integration.
Plugin installs configure MCP connections automatically. If you installed via npx skills add or another non-plugin path, set up the MCP servers manually to get the full experience.
Connects your agent to your Contentful spaces for reading and writing content, content types, and assets.
Claude Code:
/mcp add-http contentful-mcp https://mcp.contentful.com/mcpOther platforms — add to your MCP config:
{
"mcpServers": {
"contentful-mcp": {
"type": "http",
"url": "https://mcp.contentful.com/mcp"
}
}
}The contentful-personalization skill includes a local MCP server that powers its interactive workflows. Point your agent at the skill’s run script:
Claude Code:
/mcp add -- /path/to/skills/contentful-personalization/scripts/run mcp --host claude-codeOther platforms — add to your MCP config:
{
"mcpServers": {
"contentful-personalization": {
"command": "/path/to/skills/contentful-personalization/scripts/run",
"args": ["mcp", "--host", "claude-code"]
}
}
}[!NOTE] Replace
/path/to/skills/with the actual path where skills were installed (typically.agents/skills/in your project).
To test the full plugin locally — including skills, MCP servers, and hooks — without publishing:
claude --plugin-dir /path/to/contentful/skillsThis loads everything defined in .claude-plugin/plugin.json for that session: skills, the Contentful MCP server, and the personalization MCP server. Use /reload-plugins inside the session to pick up changes without restarting.
You can also combine multiple plugin directories:
claude --plugin-dir ./skills --plugin-dir ./other-pluginSee CONTRIBUTING.md (opens in a new tab) for development setup and guidelines. We welcome bug reports, feature requests, and pull requests.
This project follows the all-contributors (opens in a new tab) specification. Contributions of any kind welcome!
MIT — see LICENSE (opens in a new tab) for details.