contentful-cms

Manage Contentful content models, entries, assets, and APIs via GraphQL, REST, and Management API.

59|12|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/etylsarin/opencastle --skill contentful-cms
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: contentful-cms
Source: https://github.com/etylsarin/opencastle/tree/main/src/orchestrator/plugins/contentful
Command: npx skills add https://github.com/etylsarin/opencastle --skill contentful-cms

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a concise development methodology for working with Contentful content types, entries, assets, and APIs so teams avoid unsafe manual schema edits, inconsistent localization, and deployment friction across environments.

Core Features & Use Cases

  • Content modeling best practices: define structured content types, use references, and apply validation rules for reusable UI components.
  • API guidance: prefer the GraphQL Content API for typed, efficient queries and use the REST Delivery API when appropriate.
  • Safe schema changes & migrations: develop in sandbox environments, use migration scripts via the Management API, and promote changes reliably.
  • Assets, localization, and operational patterns: handle responsive images with the Image API, always specify locale in queries, use webhooks for cache invalidation, and respect rate limits.
  • Use Case: Migrate a blog content type schema, populate localized entries, and promote the changes from staging to master with migration scripts and automated publish steps.

Quick Start

Use the contentful-cms skill to list content types in my Contentful space and show the fields for the 'blogPost' content type.

Frequently Asked Questions about contentful-cms

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run safe schema migrations in Contentful across staging and master environments?

Contentful schema migrations should be developed in sandbox environments and executed via the Management API using migration scripts. You can then promote changes reliably from staging to master with automated publish steps to ensure environment isolation.

Should I use the Contentful GraphQL or REST Delivery API for fetching content?

Prefer the Contentful GraphQL Content API for typed, efficient queries to fetch content. Use the REST Delivery API when appropriate, such as when you need simpler endpoints or have specific caching requirements for your CMS-driven application.

How do I handle Contentful assets and responsive images with localization?

Handle responsive images using the Contentful Image API and always specify the locale in your content queries. This ensures localized entries return the correct asset variations while respecting rate-limit constraints.

What is the best way to define structured content types in Contentful?

Define structured Contentful content types by applying validation rules and using references for reusable UI components. This content modeling approach ensures consistency across entries and avoids unsafe manual schema edits.

How do I automate cache invalidation for Contentful content updates?

Use webhook-driven workflows to automate cache invalidation for Contentful content updates. Configuring webhooks ensures your application fetches fresh content immediately after entries or assets are published.

Does Contentful support environment isolation for content modeling and migrations?

Yes, Contentful supports environment isolation to separate content modeling and migrations. You develop and test schema changes in sandbox environments before applying migration scripts to production environments via the Management API.