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
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.
- 01Content model reviewList content types and their fields
Tool used: contentful__read
Cadence: Monthly
- 02Draft backlogFind entries that were never published
Tool used: contentful__read
Cadence: Weekly
- 03Locale gapsFind entries missing a locale
Tool used: contentful__read
Cadence: Per release
- 04Tag auditSpot unused, duplicate or untagged content
Tool used: contentful__read
Cadence: Quarterly
- 05Asset description checkList assets with no title or description
Tool used: contentful__read
Cadence: Quarterly
- 06Draft an entryCreate one entry as a draft from your text
Tool used: contentful__read, contentful__write
Cadence: Per article
- 07Refresh entry fieldsReplace chosen fields with a before and after
Tool used: contentful__read, contentful__write
Cadence: Per refresh
- 08Publish approved entriesPublish the entries you name
Tool used: contentful__read, contentful__write
Cadence: Per batch
- 09Unpublish or deleteUnpublish an entry or delete a draft
Tool used: contentful__read, contentful__delete
Cadence: Quarterly
| # | Skill | Job | Tool used | Cadence |
|---|---|---|---|---|
| 01 | Content model review | List content types and their fields | contentful__read | Monthly |
| 02 | Draft backlog | Find entries that were never published | contentful__read | Weekly |
| 03 | Locale gaps | Find entries missing a locale | contentful__read | Per release |
| 04 | Tag audit | Spot unused, duplicate or untagged content | contentful__read | Quarterly |
| 05 | Asset description check | List assets with no title or description | contentful__read | Quarterly |
| 06 | Draft an entry | Create one entry as a draft from your text | contentful__read, contentful__write | Per article |
| 07 | Refresh entry fields | Replace chosen fields with a before and after | contentful__read, contentful__write | Per refresh |
| 08 | Publish approved entries | Publish the entries you name | contentful__read, contentful__write | Per batch |
| 09 | Unpublish or delete | Unpublish an entry or delete a draft | contentful__read, contentful__delete | 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.
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
Setup
- Chat prompt
- None
- Skill
- Save once for each Claude app
- Contentful connection
- A Space ID and a CMA token entered in Ryze AI
Repeatable
- Chat prompt
- Only if you retype it
- Skill
- Yes, the same steps every run
- Contentful connection
- Depends on the prompt or skill
| Chat prompt | Skill | Contentful connection | |
|---|---|---|---|
| What it is | One question typed into chat | A saved file with fixed steps and a fixed output | Tools Claude calls to reach the space |
| Setup | None | Save once for each Claude app | A Space ID and a CMA token entered in Ryze AI |
| Repeatable | Only if you retype it | Yes, the same steps every run | 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.
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.
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.
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.
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.
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.
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.
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.
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
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:
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
contentful__write
- What it does
- Creates draft entries, replaces entry fields and publishes entries or assets
- Used by
- Skills 06, 07, 08
contentful__delete
- What it does
- Unpublishes an entry or deletes a draft entry
- Used by
- Skill 09
| Tool | What it does | Used by |
|---|---|---|
| contentful__read | Runs a read-only Content Management API request against the connected space environment, such as entries, content types, assets, locales and tags | All 9 skills |
| contentful__write | Creates draft entries, replaces entry fields and publishes entries or assets | Skills 06, 07, 08 |
| contentful__delete | Unpublishes an entry or deletes a draft entry | 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
Contentful connections per Ryze AI workspace
- Value
- 1
- Effect on a skill
- Skills run against one space and one environment at a time
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
Content type needed
- Value
- A blog post content type
- Effect on a skill
- Ryze AI cannot publish articles until the environment has one
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
Free plan custom connectors
- Value
- 1 in total
- Effect on a skill
- Ryze AI would use that single slot
Skill name
- Value
- 64 characters, lowercase letters, numbers, hyphens
- Effect on a skill
- Names cannot include claude or anthropic
| Limit | Value | Effect on a skill |
|---|---|---|
| Contentful connections per Ryze AI workspace | 1 | Skills run against one space and one environment at a time |
| Token role | Same as the token owner's role | Skill 08 cannot publish if the owner cannot publish in the space |
| Content type needed | A blog post content type | Ryze AI cannot publish articles until the environment has one |
| Custom skill upload in claude.ai | Pro, Max, Ultra, Team and Enterprise with code execution | Free users can still use the connector but not uploaded skills |
| Free plan custom connectors | 1 in total | Ryze AI would use that single slot |
| Skill name | 64 characters, lowercase letters, numbers, hyphens | 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?
Do I need a Contentful connection to use these skills?
Which Claude plan do I need?
How many Contentful tools does Ryze AI give Claude?
Show 7 more questionsShow fewer questions
Will Claude publish entries without asking?
What do I need from Contentful to connect?
Can the skills work on more than one space?
Why are my entries not visible on the site?
How do these differ from Contentful's own MCP server?
Do the skills work outside Claude?
How much does it cost?
Related guides
Contentful MCP server
The 3 Contentful tools, setup per client, token and limits.
Claude skills for Webflow
SKILL.md files for another CMS on the same connector.
Claude skills for WordPress
Skills for posts and pages in WordPress.
How to connect Claude to WordPress
Another publishing platform, with setup for each Claude app.




