contentful-cms

Creates Contentful content types, queries entries via GraphQL/REST, runs CLI migrations, and manages assets and locales. Use when building or modifying Contentful content models, writing queries, or migrating content.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exemplary lean skill body: all guidance is Contentful-specific gotchas and executable commands rather than generic explanation, with a well-sequenced sandbox-first migration workflow and explicit post-migration validation. The only improvement would be a ready-to-run sample query to back the entry-validation step.

Dimension	Reasoning	Score
Conciseness	Every line carries non-obvious Contentful-specific knowledge (rollback-is-recreate, `include` link depth, `sys.publishedAt` as cache key, explicit `validations`), with zero padding and no explanation of concepts Claude already knows.	5 / 5
Actionability	The migration command is copy-paste ready and the `linkContentType` validation snippet is executable, but there is no sample GraphQL/REST query despite the description promising them, and "Build the site against sandbox content" assumes a known build step — minor gaps consistent with the mostly-executable anchor.	4 / 5
Workflow Clarity	The destructive migration workflow has an explicit sequence (sandbox → migrate → validate → promote), three numbered validation checkpoints including an exit-non-zero assertion, and a defined error-recovery path (delete sandbox, re-clone, re-run corrected migration), matching the top anchor including feedback loops.	5 / 5
Progressive Disclosure	The skill is under 50 lines with no bundle files; content is split into well-organized sections (Gotchas, Migration command, Post-migration validation) and its only pointers — project config and official docs — are one level deep, satisfying the simple-skill provision.	5 / 5
	Total	19 / 20 Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete, third-person action list paired with an explicit and specific "Use when" clause. The only minor gap is the absence of natural synonyms like "CMS" or "headless CMS" that a user might say instead of the product name.

Dimension	Reasoning	Score
Specificity	"Creates Contentful content types, queries entries via GraphQL/REST, runs CLI migrations, and manages assets and locales" lists five concrete, distinct actions with no coverage gaps in the domain, matching the comprehensive-coverage anchor.	5 / 5
Completeness	Both halves are explicit: the "what" is a list of concrete actions, and "Use when building or modifying Contentful content models, writing queries, or migrating content" gives concrete trigger phrases, exactly matching the top anchor.	5 / 5
Trigger Term Quality	"Contentful", "content types", "content models", "writing queries", and "migrating content" are natural user phrases, but common synonyms like "CMS", "headless CMS", or "entries" are missing, so it falls just short of comprehensive.	4 / 5
Distinctiveness Conflict Risk	The description is anchored to a single named product (Contentful) with product-specific triggers (content models, CLI migrations), giving a clear niche with minimal risk of triggering the wrong skill.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: monkilabs/opencastle
Path: src/orchestrator/plugins/contentful/SKILL.md
Commit: c0f4566

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.