{"kind":"Skill","metadata":{"namespace":"community","name":"contentful-automation","version":"0.1.0"},"spec":{"description":"Automate headless CMS operations in Contentful -- list spaces, retrieve space metadata, and update space configurations through the Composio Contentful integration.","files":{"SKILL.md":"---\nname: Contentful Automation\ndescription: \"Automate headless CMS operations in Contentful -- list spaces, retrieve space metadata, and update space configurations through the Composio Contentful integration.\"\nrequires:\n  mcp:\n    - rube\n---\n\n# Contentful Automation\n\nManage your **Contentful** headless CMS spaces directly from Claude Code. List spaces, retrieve metadata, and update space configurations without leaving your terminal.\n\n**Toolkit docs:** [composio.dev/toolkits/contentful](https://composio.dev/toolkits/contentful)\n\n---\n\n## Setup\n\n1. Add the Composio MCP server to your configuration:\n   ```\n   https://rube.app/mcp\n   ```\n2. Connect your Contentful account when prompted. The agent will provide an authentication link. Ensure your access token has space management scopes.\n\n---\n\n## Core Workflows\n\n### 1. List All Spaces\n\nDiscover all Contentful spaces accessible to your authenticated account. This is typically the first operation since most other actions require a `space_id`.\n\n**Tool:** `CONTENTFUL_LIST_SPACES`\n\nKey parameters:\n- `limit` (1-1000) -- maximum number of spaces to return (default: 100)\n- `skip` -- number of spaces to skip for pagination\n- `order` -- sort by field, e.g., `sys.createdAt` or `-sys.createdAt` for descending\n\nExample prompt: *\"List all my Contentful spaces\"*\n\n---\n\n### 2. Get Space Details\n\nRetrieve detailed metadata for a specific space including its current `sys.version`, which is required for updates.\n\n**Tool:** `CONTENTFUL_GET_SPACE`\n\nKey parameters:\n- `space_id` (required) -- the ID of the space to retrieve (alphanumeric, 1-64 chars)\n\nExample prompt: *\"Get details for Contentful space abc123def\"*\n\n---\n\n### 3. Update Space Name\n\nUpdate the name of a specific space. Requires the current version number for optimistic locking to prevent concurrent modification conflicts.\n\n**Tool:** `CONTENTFUL_UPDATE_SPACE`\n\nKey parameters:\n- `space_id` (required) -- ID of the space to update\n- `name` (required) -- new name for the space (1-255 chars)\n- `version` (required) -- current space version from `sys.version` (must be \u003e 0)\n\nExample prompt: *\"Rename Contentful space abc123def to 'Production Content Hub'\"*\n\n---\n\n### 4. Audit Space Inventory\n\nCombine space listing and detail retrieval to audit your organization's Contentful spaces.\n\n**Tools:** `CONTENTFUL_LIST_SPACES` then `CONTENTFUL_GET_SPACE`\n\nWorkflow:\n1. List all spaces to get IDs and names\n2. Fetch details for each space to get version info, creation dates, and metadata\n\nExample prompt: *\"Audit all Contentful spaces -- list them with their creation dates and current versions\"*\n\n---\n\n## Known Pitfalls\n\n- **Version conflicts on update:** `CONTENTFUL_UPDATE_SPACE` requires the latest `sys.version` from `CONTENTFUL_GET_SPACE`. If someone else modified the space between your read and write, the update will fail with a version conflict. Always fetch the space immediately before updating.\n- **Pagination for many spaces:** `CONTENTFUL_LIST_SPACES` uses `limit` and `skip` parameters. When you have many spaces, iterate by incrementing `skip` until no more results are returned to avoid missing spaces.\n- **Scope limitations:** These tools only manage space-level metadata (names). They cannot create or modify entries, content types, or assets within a space.\n- **Auth/permissions mismatch:** Updates via `CONTENTFUL_UPDATE_SPACE` will fail if your token lacks space management scopes, even if reads via `CONTENTFUL_GET_SPACE` succeed. Verify your token has write permissions.\n- **Space ID format:** The `space_id` must match the pattern `^[a-zA-Z0-9-_.]{1,64}$`. Invalid characters will be rejected.\n\n---\n\n## Quick Reference\n\n| Tool Slug | Description |\n|---|---|\n| `CONTENTFUL_LIST_SPACES` | List all spaces accessible to your account |\n| `CONTENTFUL_GET_SPACE` | Retrieve detailed metadata for a single space |\n| `CONTENTFUL_UPDATE_SPACE` | Update the name of a space (requires version) |\n\n---\n\n*Powered by [Composio](https://composio.dev)*\n"},"import":{"commit_sha":"f2b5e29bc315f04c8e09591ba275f4c4f7d4b8fe","imported_at":"2026-05-18T20:07:47Z","license_text":"","owner":"ComposioHQ","repo":"ComposioHQ/awesome-claude-skills","source_url":"https://github.com/ComposioHQ/awesome-claude-skills/tree/f2b5e29bc315f04c8e09591ba275f4c4f7d4b8fe/composio-skills/contentful-automation"}},"content_hash":[125,219,191,127,126,94,206,23,221,28,26,125,39,131,113,55,56,189,209,195,5,41,209,9,98,228,101,186,61,69,249,248],"trust_level":"unsigned","yanked":false}