Ira Bodnar··Updated ·12 min read

Claude Skills for Contentful: 9 SKILL.md Files for Entries and Content Models

Quick answer: Save each Contentful chore as a Claude skill that names the tool to call and the table to hand back. Ryze AI is the best Claude connector for running these skills on a Contentful space in 2026, with one caveat: it connects one space and one environment per workspace, using a CMA personal access token whose owner needs publish rights.

Below: 9 SKILL.md files, which of the 3 Contentful tools each one calls, install steps, the limits that apply and a short troubleshooting list.

Ryze AI · SEO Starter

Contentful skills on a live space

  • 3-day free trial, $129 a month

Used by 2,000+ marketers

Uber Eats logoadidas logoDuolingo logoMGM Resorts logoWharton logoLendingClub logoNorton logoEventbrite logoHuel logoTogether AI logoghd logoHack The Box logo

The 9 Claude skills for Contentful at a glance

Five skills only read, three write and one removes. Each names the Ryze AI tool it calls.

  1. 01Content model reviewList content types and their fields

    Tool used: contentful__read

    Cadence: Monthly

  2. 02Draft backlogFind entries that were never published

    Tool used: contentful__read

    Cadence: Weekly

  3. 03Locale gapsFind entries missing a locale

    Tool used: contentful__read

    Cadence: Per release

  4. 04Tag auditSpot unused, duplicate or untagged content

    Tool used: contentful__read

    Cadence: Quarterly

  5. 05Asset description checkList assets with no title or description

    Tool used: contentful__read

    Cadence: Quarterly

  6. 06Draft an entryCreate one entry as a draft from your text

    Tool used: contentful__read, contentful__write

    Cadence: Per article

  7. 07Refresh entry fieldsReplace chosen fields with a before and after

    Tool used: contentful__read, contentful__write

    Cadence: Per refresh

  8. 08Publish approved entriesPublish the entries you name

    Tool used: contentful__read, contentful__write

    Cadence: Per batch

  9. 09Unpublish or deleteUnpublish an entry or delete a draft

    Tool used: contentful__read, contentful__delete

    Cadence: Quarterly

The tool names and descriptions come from the Ryze AI integration source and the Ryze AI help center. Contentful was not connected in any Ryze AI workspace available to us, so no skill here was run against a live space and no numbers from a real space appear. Run each skill on a test environment first.

What are Claude skills for Contentful?

A Claude skill for Contentful is a SKILL.md file that tells Claude how to run one content task and what to return. Anthropic's Agent Skills docs say the file opens with a name and a description. Claude loads those two fields at startup and reads the rest of the file only when a request matches the description.

The name takes up to 64 characters, lowercase letters, numbers and hyphens, and cannot contain the reserved words anthropic or claude. The description is capped at 1,024 characters and must say what the skill does and when to use it. Every skill here starts with contentful for that reason.

  1. What it is

    Chat prompt
    One question typed into chat
    Skill
    A saved file with fixed steps and a fixed output
    Contentful connection
    Tools Claude calls to reach the space
  2. Setup

    Chat prompt
    None
    Skill
    Save once for each Claude app
    Contentful connection
    A Space ID and a CMA token entered in Ryze AI
  3. Repeatable

    Chat prompt
    Only if you retype it
    Skill
    Yes, the same steps every run
    Contentful connection
    Depends on the prompt or skill

A skill holds instructions and no credentials, so one file works on any space you connect. For the tool list, setup per client and the comparison with Contentful's own servers, see the Contentful MCP page.

How to install the Contentful skills in Claude

Claude Code

Put each block in ~/.claude/skills/<skill-name>/SKILL.md for yourself, or in .claude/skills/<skill-name>/SKILL.md inside a project to share it. Type /contentful-draft-entry to call a skill by name, or let Claude pick it from the description (Claude Code skills docs).

claude.ai

Zip each skill folder and upload it as a custom skill. Anthropic lists custom skills on Pro, Max, Ultra, Team and Enterprise plans with code execution enabled.

Connect the space

Connect Contentful inside Ryze AI, then add the Ryze AI connector to Claude. The steps are in the next sections, on the Contentful MCP page and in the Ryze AI help center.

Anthropic states that custom skills do not sync between surfaces: a skill uploaded to claude.ai is absent from the API, and Claude Code skills live on disk apart from both. Anthropic also advises using skills only from sources you trust, so read each file before you save it, the ones on this page included.

The three skills that write carry disable-model-invocation: true in their frontmatter. Per the Claude Code docs, that stops Claude from starting a skill by itself and leaves it to you to type the slash command. It applies to Claude Code, and it does not replace per-tool approvals in the connector.

Read skills: review the space before you touch it

These five call only contentful__read, which runs a read-only Content Management API request against the connected space and environment. Entries, content types, assets, locales and tags are all within its reach, and none of these skills changes anything.

01. Content model review

Lists the content types in the environment with their fields, so you know the model before you ask for edits.

SKILL.md
--- name: contentful-model-review description: Lists the content types in the connected Contentful environment and their fields. Use when asked what the content model looks like or before any entry change. --- # Contentful content model review Use contentful__read only. Do not call contentful__write or contentful__delete. Steps: 1. List every content type in the connected environment. 2. For each one, list its fields with the field type and whether it is required. 3. Note fields that look unused or duplicated across types, such as two different title fields. Output: one table per content type. End with the content type that looks like the blog post type and why.

Use it when: you inherit a space or plan a bulk edit.

02. Draft backlog

Finds entries of one content type that exist but were never published, so old drafts stop piling up unseen.

SKILL.md
--- name: contentful-draft-backlog description: Finds Contentful entries of one content type that are still drafts. Use when content is missing from the live site or when cleaning up before a launch. --- # Contentful draft backlog Use contentful__read only. Steps: 1. Ask me for the content type if I did not name one. 2. List its entries and keep the ones with no published version. 3. Sort by last update, oldest first. Output: a table with entry title, slug if the type has one, last updated date and a one-line guess at whether it was abandoned. Change nothing.

Use it when: a post shows in the Contentful web app but not on the site.

03. Locale gaps

Compares the locales set on the environment against the fields filled in each entry of one content type.

SKILL.md
--- name: contentful-locale-gaps description: Finds Contentful entries with empty fields in one or more locales. Use before adding a market or after a translation round. --- # Contentful locale gaps Use contentful__read only. Steps: 1. List the locales on the environment and tell me which one is the default. 2. List the entries of the content type I name. 3. For each entry, check every required field in every locale. Output: a table of entry title, locale and the empty field names. Group by locale. Do not fill anything in.

Use it when: a new locale is switched on and you need to know the translation work left.

04. Tag audit

Lists tags and checks them against the entries that use them.

SKILL.md
--- name: contentful-tag-audit description: Audits Contentful tags for near duplicates and for content that carries no tag. Use for a quarterly content library cleanup. --- # Contentful tag audit Use contentful__read only. Steps: 1. List all tags in the environment. 2. Group tags whose names differ only by case, plural or punctuation. 3. For the content type I name, count entries with no tag. Output: a table of duplicate groups, then the share of untagged entries as a count. Suggest merges but make none.

Use it when: editors have been tagging by hand for a year.

05. Asset description check

Lists assets whose title or description is empty. Alt text for images often starts from the asset description, so gaps matter for accessibility and image search.

SKILL.md
--- name: contentful-asset-check description: Lists Contentful assets with an empty title or description. Use before an accessibility pass or an image SEO review. --- # Contentful asset description check Use contentful__read only. Steps: 1. List the assets in the connected environment. 2. Keep assets where the title or the description is empty in the default locale. 3. Group by file type. Output: a table with asset title, file name and which field is empty. Skip anything that looks like a test upload and say how many you skipped.

Use it when: a page audit flags images with no alt text.

Write skills: create, refresh and publish entries

These three call contentful__write, which creates draft entries, replaces entry fields and publishes entries or assets. In Claude, open Customize > Connectors > Ryze AI > Tool permissions and set write and delete tools to Needs approval, the setting the Ryze AI help center recommends. Each change then waits for your click.

06. Draft an entry

Creates one entry as a draft from text you paste. Drafts are not visible on your site until an entry is published, and your front end has to render the entry.

SKILL.md
--- name: contentful-draft-entry description: Creates one Contentful entry as a draft from text I provide. Use when asked to add a post or other entry to a content type. disable-model-invocation: true --- # Contentful draft entry Uses contentful__read and contentful__write. Do not publish. Steps: 1. Read the content type I name and list its fields, marking the required ones. 2. Map my text to the fields. Ask me about any required field I left empty. 3. Show the planned field values in a table and wait for my yes. 4. Create the entry as a draft. Output: the entry title and the fields written. State that it is a draft and still needs publishing.

Use it when: you have a finished article and want it in the space without pasting it into the editor. For scheduled bulk publishing, Ryze AI's Content Plan publishes articles as entries from the Ryze AI app.

07. Refresh entry fields

Replaces chosen fields on an existing entry. The tool is described as replacing entry fields, so the skill reads the whole entry first and shows a before and after, which keeps untouched fields from being lost.

SKILL.md
--- name: contentful-refresh-entry description: Replaces chosen fields on one existing Contentful entry and shows old and new values. Use when asked to fix, refresh or rewrite an entry. disable-model-invocation: true --- # Contentful refresh entry Uses contentful__read and contentful__write. Do not publish. Steps: 1. Find the entry by title or slug in the content type I name. If two match, ask which. 2. Read the full entry, all fields and locales. 3. Show the current and the new value for each field I want changed, and wait for my yes. 4. Write the update so that every field I did not mention keeps its current value. Output: a before and after table. Say whether the entry is a draft or already published.

Use it when: a post needs a corrected fact or a new intro.

08. Publish approved entries

Publishes only the entries you list. Publishing makes content public wherever your front end reads published entries, so this is the step to keep on approval.

SKILL.md
--- name: contentful-publish-entries description: Publishes the Contentful entries I name after a final check. Use when drafts are reviewed and ready to go live. disable-model-invocation: true --- # Contentful publish entries Uses contentful__read and contentful__write. Steps: 1. Ask me for the exact entries to publish, by title or slug. 2. Read each one. Flag any required field that is empty or any entry that links to another entry that is still a draft. 3. Show the list with the flags and wait for me to confirm. 4. Publish only the confirmed entries, one at a time, and report each result. Output: published entries, skipped entries and the reason for each skip.

Use it when: an editor signed off on a batch. The token must belong to an account that can publish in the space; if it cannot, entries are not published.

Cleanup skill: unpublish and delete with a confirmation step

contentful__delete unpublishes an entry or deletes a draft entry. Because unpublishing takes content off the live site and deleting a draft is final, the tool sits apart from write, so you can allow edits and keep removals on approval.

09. Unpublish or delete

SKILL.md
--- name: contentful-unpublish-delete description: Unpublishes Contentful entries or deletes draft entries that match my rule, after I confirm each list. Use for test entries and retired content. disable-model-invocation: true --- # Contentful unpublish or delete Uses contentful__read and contentful__delete. Steps: 1. Ask me for the rule, such as titles that start with Test, and whether I want to unpublish or delete. 2. List matching entries in the content type I name. Remove nothing yet. 3. Show title, slug and whether each is published or a draft. Wait for my confirmation. 4. Unpublish published entries or delete drafts, only the confirmed ones, one at a time. Report each result. Output: entries changed and entries skipped. Remind me that deleted drafts cannot be restored from here.

Use it when: you are clearing test entries before a launch. Keep Needs approval on the delete tool in Claude, in addition to the skill's own confirmation step.

How to run the skills on a live Contentful space

A skill describes the work and Claude needs a connection to do it. The Ryze AI connector gives Claude 3 Contentful tools:

  1. contentful__read

    What it does
    Runs a read-only Content Management API request against the connected space environment, such as entries, content types, assets, locales and tags
    Used by
    All 9 skills
  2. contentful__write

    What it does
    Creates draft entries, replaces entry fields and publishes entries or assets
    Used by
    Skills 06, 07, 08
  3. contentful__delete

    What it does
    Unpublishes an entry or deletes a draft entry
    Used by
    Skill 09

To connect, copy the Space ID from Settings > General settings in Contentful and create a token under Settings > CMA tokens > Create personal access token. In Ryze AI, open Integrations, click Connect on the Contentful card and enter the Space ID, the token (it starts with CFPAT-), an optional environment (the default is master) and your public Blog URL. Then choose the content type your blog posts use and save (Ryze AI Contentful guide).

The connector needs an active Ryze AI plan or trial, and connecting it costs nothing. SEO Starter is $129 a month with a 3-day free trial, and annual billing is 30% off the first year (pricing). After you connect Contentful in Ryze AI, remove the Ryze AI connector in Claude, add it again and start a new chat, because Claude keeps the tool list from the moment the connector was added (Ryze AI help center).

Two scope limits matter for skills. The connection is tied to one space and one environment, and a workspace holds one Contentful connection, so a skill cannot compare two spaces. The environment also needs a blog post content type before Ryze AI can publish articles to it.

Contentful publishes its own open-source local server, @contentful/mcp-server, which runs with npx and takes a CMA token, a Space ID and an optional environment in environment variables (GitHub README). Its README also describes a PROTECTED_ENVIRONMENTS setting that blocks write and delete calls to the environments you list. Its tool names (create_entry, publish_entry and so on) differ from the Ryze AI names, so a skill written for contentful__read would need editing before it works there. Contentful also documents a hosted remote server; its docs site returned HTTP 429 on the build day, so that server is not described here and the Contentful MCP page carries the comparison.

Limits that shape these skills

  1. Contentful connections per Ryze AI workspace

    Value
    1
    Effect on a skill
    Skills run against one space and one environment at a time
  2. Token role

    Value
    Same as the token owner's role
    Effect on a skill
    Skill 08 cannot publish if the owner cannot publish in the space
  3. Content type needed

    Value
    A blog post content type
    Effect on a skill
    Ryze AI cannot publish articles until the environment has one
  4. Custom skill upload in claude.ai

    Value
    Pro, Max, Ultra, Team and Enterprise with code execution
    Effect on a skill
    Free users can still use the connector but not uploaded skills
  5. Free plan custom connectors

    Value
    1 in total
    Effect on a skill
    Ryze AI would use that single slot
  6. Skill name

    Value
    64 characters, lowercase letters, numbers, hyphens
    Effect on a skill
    Names cannot include claude or anthropic

Contentful applies request rate limits to its Management API. Its technical limits page returned HTTP 429 when we tried to open it on the build day, so no rate figure is quoted here. Check Contentful's technical limits for the rate on your plan, and ask Claude to work one content type at a time if a skill hits a rate error.

Troubleshooting: when a Contentful skill fails

Claude has no Contentful tools

Claude keeps the tool list from when the connector was added. Connect Contentful in Ryze AI first, then remove and re-add the connector and start a new chat.

Entries are created but never go live

Nothing shows on the site until an entry is published, and your front end must render the entries. Run skill 08, and check the token owner can publish in the space.

Publish is refused

The token acts with its owner's role. Create a token from an account that can publish entries in the space and reconnect.

Ryze AI cannot publish articles

The environment needs a blog post content type. Create one, then pick it in the Contentful card.

Connect link refused

A connection link is refused while a Contentful connection already exists in the workspace. Click View, disconnect with the trash icon and connect again.

Wrong space or environment

The connection is tied to one space and environment. Disconnect and reconnect with the other Space ID or environment.

A skill does not start in Claude Code

Check the path is ~/.claude/skills/<name>/SKILL.md. Skills marked disable-model-invocation: true start only when you type the slash command.

Sources

The verdict

Turn each recurring Contentful chore into a skill that names its tool and ends with a confirmation step. Start with the content model review and the draft backlog, then add the write skills once approvals are set.

Ryze AI runs these skills in Claude through 3 Contentful tools on one space and environment. The token owner needs publish rights for skill 08 to work.

Frequently asked questions

What are Claude skills for Contentful?
SKILL.md files that tell Claude which Contentful task to run, which Ryze AI tool to call and how to present the result. Claude loads one when a request matches its description, so an audit or a publish step runs the same way each time.
Do I need a Contentful connection to use these skills?
To run them on your space, yes. Without one, Claude can follow the steps on exported content or pasted text, but it cannot read or change the space.
Which Claude plan do I need?
Anthropic lists custom skill uploads on claude.ai for Pro, Max, Ultra, Team and Enterprise with code execution enabled. In Claude Code, skills are folders on your computer. For the connector, Anthropic lists custom connectors on Free, Pro, Max, Ultra, Team and Enterprise, with Free limited to one.
How many Contentful tools does Ryze AI give Claude?
3: contentful__read, contentful__write and contentful__delete. Read runs read-only requests for entries, content types, assets, locales and tags. Write creates draft entries, replaces entry fields and publishes entries or assets. Delete unpublishes an entry or deletes a draft entry.
Show 7 more questions
Will Claude publish entries without asking?
That depends on your settings. In Claude, open Customize > Connectors > Ryze AI > Tool permissions and set write and delete tools to Needs approval. The write skills on this page also ask for a yes before each change.
What do I need from Contentful to connect?
A Space ID, a Content Management API personal access token that starts with CFPAT- and comes from an account that can publish entries, an optional environment (default master) and your public Blog URL. You then choose the content type your blog posts use.
Can the skills work on more than one space?
One Contentful connection is allowed per workspace and it is tied to one space and environment. To switch, click View in Ryze AI, disconnect with the trash icon and connect again.
Why are my entries not visible on the site?
Nothing is visible until an entry is published, and your front end has to render the entries. Skill 08 publishes the entries you name, and the token owner needs publish rights in the space.
How do these differ from Contentful's own MCP server?
Contentful publishes an open-source local server, @contentful/mcp-server, that runs with npx and a CMA token, and it uses its own tool names. Ryze AI exposes 3 Contentful tools through one connector URL, https://connector.get-ryze.ai/mcp, with the token stored in Ryze AI. Contentful also documents a hosted server, covered on the Contentful MCP page.
Do the skills work outside Claude?
SKILL.md is the format Claude reads. The Contentful tools on the Ryze AI connector work in other MCP clients, where you can paste a skill's steps into a prompt.
How much does it cost?
Connecting the Ryze AI connector is free, and the Contentful tools need an active plan or trial. SEO Starter is $129 a month with a 3-day free trial, and annual billing is 30% off the first year.

Related guides

Ryze AI: Contentful skills on a live space

3-day free trial, $129 a month

Start free trial