Skip to content
Skills Library
Marketing & content · Learning & explanation

contentful-guide

/contentful-guide

Explain core Contentful concepts and route users to the right implementation skill or documentation. Use when users ask conceptual questions, need terminology clarified, want help choosing between APIs (CDA/CMA/CPA/GraphQL), or need guidance on the Contentful MCP server. Also triggers on "Contentful 101", "which Contentful API", "how do I get started", "which skill should I use", "what does X mean in Contentful", "Contentful glossary", "CDA vs CPA", "CDA vs GraphQL", "how does Contentful work", "Contentful architecture", "explain environments", "what are aliases", "content model design", "head

Repository
skills ↗
Licence
MIT
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
5
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Explain core Contentful concepts and route users to the right implementation skill or documentation. Use when users ask conceptual questions, need terminology clarified, want help choosing between APIs (CDA/CMA/CPA/GraphQL), or need guidance on the Contentful MCP server. Also triggers on "Contentful 101", "which Contentful API", "how do I get started", "which skill should I use", "what does X mean in Contentful", "Contentful glossary", "CDA vs CPA", "CDA vs GraphQL", "how does Contentful work", "Contentful architecture", "explain environments", "what are aliases", "content model design", "head

Triggers from the description

Contentful 101which Contentful APIhow do I get startedwhich skill should I usewhat does X mean in ContentfulContentful glossaryCDA vs CPACDA vs GraphQL

Arguments

/contentful-guide [concept or API name]
Original author description

Explain core Contentful concepts and route users to the right implementation skill or documentation. Use when users ask conceptual questions, need terminology clarified, want help choosing between APIs (CDA/CMA/CPA/GraphQL), or need guidance on the Contentful MCP server. Also triggers on "Contentful 101", "which Contentful API", "how do I get started", "which skill should I use", "what does X mean in Contentful", "Contentful glossary", "CDA vs CPA", "CDA vs GraphQL", "how does Contentful work", "Contentful architecture", "explain environments", "what are aliases", "content model design", "head

How it works

  1. What this skill does
  2. Routing rules
  3. API chooser
  4. Contentful MCP note
  5. Operating pattern
  6. Guardrails
  7. References
Original SKILL.md headings · 58 lines, 394 words
SKILL.md preview
---
name: contentful-guide
description: >-
  Explain core Contentful concepts and route users to the right implementation
  skill or documentation. Use when users ask conceptual questions, need
  terminology clarified, want help choosing between APIs (CDA/CMA/CPA/GraphQL),
  or need guidance on the Contentful MCP server. Also triggers on "Contentful
  101", "which Contentful API", "how do I get started", "which skill should I
  use", "what does X mean in Contentful", "Contentful glossary", "CDA vs CPA",
  "CDA vs GraphQL", "how does Contentful work", "Contentful architecture",
  "explain environments", "what are aliases", "content model design",
  "headless CMS", "Contentful MCP", "MCP server", "set up MCP",
  "Remix Contentful", "Astro Contentful", "Gatsby Contentful",
  "SvelteKit Contentful", "Nuxt Contentful". Not for framework-specific
  implementation (contentful-nextjs), migrations (contentful-migration),
  personalization (contentful-personalization), or hands-on REST/GraphQL
  request examples (contentful-api).
argument-hint: "[concept or API name]"
allowed-tools: mcp__contentful-mcp__* mcp__plugin_contentful_contentful-mcp__*
---

# 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

- [Lexicon](references/lexicon.md)
- [Docs map](references/docs-map.md)
- [Skill routing](references/skill-routing.md)
Files in this package (5)
  • SKILL.md 4 KB
  • package.json 1 KB
  • references/docs-map.md 1 KB
  • references/lexicon.md 2 KB
  • references/skill-routing.md 2 KB

Versions

The database has no other skills named contentful-guide.

Database snapshot: 13.11.2026 · package version 9522ee3a281d (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100contentful-nextjs
    Add and configure Contentful in an existing Next.js project. Covers installing the JavaScript SDK, configuring environment variables, creating production and preview-aware clients, fetching content in App Router or Pages Router, and wiring Draft Mode preview flows. Use when…
  • 100optimization-sdk-sync
    Synchronize the Contentful Optimization SDK's public API, behavior, and implementation guidance into concise, runtime-specific references for the contentful-personalization skill. Use when the optimization repository or SDK documentation changes, when modern SDK guidance appears…
  • 100contentful
    Contentful is an API-first headless CMS: content lives in typed content models and is served through the Content Delivery API (published, CDN), the Content Preview API (drafts) and the Content Management API (writes). Use when a user wants to fetch Contentful entries in a…
  • 100first-contentful-paint
    Use when auditing slow page loads, heavy assets, or rendering delays related to Optimize first contentful paint. Verify the actual bottleneck in DevTools, Lighthouse, or field data before recommending changes.
  • 100integration-sync
    Syncs content between Crowdin and a platform connected through an installed Crowdin integration app (Webflow, HubSpot, Contentful, Zendesk Guide, Braze and the other store integrations), through the Crowdin connector or the Crowdin CLI. Use when someone wants platform content…
  • 100largest-contentful-paint
    Use when auditing slow page loads, heavy assets, or rendering delays related to Optimize largest contentful paint. Verify the actual bottleneck in DevTools, Lighthouse, or field data before recommending changes.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.