mcpField
C
contentful-guide

contentful-guide

github.com/contentfulDevelopment39368 installsUpdated 1d ago
Repository

About contentful-guide

contentful-guide is a routing and terminology skill for Contentful tasks. It helps users choose the relevant API, documentation path, or specialized skill, while keeping conceptual questions in scope.

Key features

  1. 01Explains core Contentful terms
  2. 02Maps goals to Contentful APIs
  3. 03Routes requests to specialized skills
  4. 04Identifies out-of-scope requests

Use cases

  1. 01Choosing an API for a content task
  2. 02Finding the right Contentful documentation
  3. 03Routing migration or framework work

MCP support

The skill notes that the Contentful MCP server can let an agent interact conversationally with spaces, entries, and content model context.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/contentful/skills --skill contentful-guide

After installing, type/contentful-guidein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

package.json
references/
docs-map.md
lexicon.md
skill-routing.md

Details

From the project README

Contentful Guide

Use this skill as the routing and vocabulary layer for Contentful tasks.

Contentful is a headless, API-first CMS (composable content platform) where teams model content once and deliver it to many channels.

What this skill does

  1. Clarifies core terms (space, environment, environment alias, content model, content type, entry, asset, locale).
  2. Maps user intent to the right API (CDA, CPA, CMA, GraphQL, Images API).
  3. Routes implementation requests to the right skill and docs.
  4. Prevents incorrect setup by identifying when a request is not in this skill's scope.

Routing rules

  • If the user asks to add Contentful to a Next.js project, use the contentful-nextjs skill.
  • If the user asks about optimization/personalization/analytics setup or debugging, route to the contentful-personalization skill.
  • If the user asks to write content type migrations or schema changes, route to the contentful-migration skill.
  • If the user asks for concrete REST/GraphQL requests (curl examples, headers, query parameters, payload shapes for CMA/CDA/CPA/Images/GraphQL), route to the contentful-api skill.
  • If the user asks for conceptual guidance, architecture tradeoffs, or where to read docs, stay in this skill.
  • If the user asks about environment aliases and deployment workflows, stay in this skill unless they also ask for framework implementation.

API chooser

  • Use CDA for published delivery content in websites/apps.
  • Use CPA for unpublished preview content.
  • Use CMA for write operations (create/update/manage content and models).
  • Use GraphQL Content API when query shape control is preferred over REST payloads.
  • Use Images API for image transformations.

Contentful MCP note

  • The Contentful MCP server is often the easiest way to let an agent interact with Contentful.
  • Use it when the user wants conversational access to spaces, entries, and content model context without wiring SDK code first.
  • Canonical docs: https://www.contentful.com/developers/docs/tools/mcp-server/

Operating pattern

When answering with this skill:

  1. Define terms using shared vocabulary from references/lexicon.md.
  2. Pick the right docs path from references/docs-map.md.
  3. If implementation is requested, hand off using references/skill-routing.md.
  4. Keep answers concise and cite canonical docs paths.

Guardrails

  • Do not invent product capabilities, API behavior, or limits.
  • Do not provide framework code unless routing to the specialized implementation skill.
  • Prefer official docs over memory when details may be version-sensitive.

References

Comments

Markdown supported