contentful

Reads content types, entries, and assets from Contentful CMS via CLI and CMA API.

3|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/OktayCopurlu/ai-shared --skill contentful-oktaycopurlu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: contentful
Source: https://github.com/OktayCopurlu/ai-shared/tree/main/.github/workflows/skills/contentful
Command: npx skills add https://github.com/OktayCopurlu/ai-shared --skill contentful-oktaycopurlu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Querying Contentful CMS content requires knowing which tool handles which resource, since the contentful CLI cannot read entries or assets. This Skill routes each request to the correct interface and enforces strict read-only access so CMS data is never accidentally modified. ## Core Features & Use Cases - Smart Routing: Uses the contentful CLI for spaces, environments, and content types, and the CMA REST API via curl for entries and assets. - Automatic Configuration: Reads the active space and environment from ~/.contentfulrc.json so you do not have to specify them manually. - Read-Only Safety: Restricts all operations to GET requests and read-only CLI subcommands, even though the management token has write scope. - Use Case: Ask which entries exist for a product content type, and the Skill queries the CMA API with filters and returns the fields formatted through jq. ## Quick Start Ask the assistant to list the five most recent entries of a given content type from your Contentful space.

Frequently Asked Questions about contentful

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

FAQPage Schema
How do I read Contentful entries from the command line?▼

The contentful CLI has no read command for entries, so use the CMA REST API with curl. Send a GET request to /spaces/{space}/environments/{env}/entries with your management token as a Bearer header, and pipe the output through jq.

How do I filter Contentful entries by a field value?▼

Add a query parameter like &fields.key=someValue to the CMA entries endpoint URL. You can also combine it with content_type and limit parameters to narrow results to a specific content model.

Can this Skill create or update Contentful content?▼

No. The Skill is strictly read-only and only issues GET requests and read-only CLI subcommands. It never creates, updates, publishes, archives, or deletes Contentful data, even though the management token technically has write scope.

Where does the Contentful CLI store the active space and environment?▼

The CLI stores defaults in ~/.contentfulrc.json under activeSpaceId and activeEnvironmentId. The Skill reads these values with jq before asking the user, and the management token is stored as managementToken in the same file.

Why does contentful entries list not work as a CLI command?▼

The contentful CLI v3 only supports listing spaces, environments, and content types; it has no read subcommands for entries or assets. Those resources must be fetched through the CMA REST API using curl with an Authorization Bearer header.