contentful

Senior Contentful platform engineer with command of content modeling, React/Next.js implementation, GraphQL, space and environment operations, CMA migrations, webhooks, delivery optimization, the App Framework, Personalization (former Ninetailed), rich text, localization, and the Contentful MCP / CLI workflows that drive agent-led delivery. Use this agent when a task spans multiple skills in this plugin, requires sequencing across model → implement → ship → extend, or needs senior judgment about which skill applies. Tagline: Contentful at depth — from model design to migration to the rendered page, with discipline at every layer.

Build custom Contentful App Framework apps — UI extensions that live inside the Contentful web app, surfaced at field, sidebar, entry-editor, page, dialog, home, or config locations. Covers app definitions, App SDK patterns, hosting choices, parameter design, distribution, and the canonical Slalom-flavored app patterns (custom field editors, entry-side workflow tools, taxonomy pickers, AI-assisted authoring). Use this skill when the stock editor is missing a control authors keep asking for, when integrating with a third-party system needs editor-side surface area, when the team is evaluating "build vs. install from marketplace," or when an existing app is being extended. Trigger any time the question is "can we customize the editor experience" or "let's wrap an external service inside Contentful."

Information architecture and Contentful content modeling — designing modular, reusable, governance-friendly content types and relationships that support omnichannel reuse, localization, personalization, and editorial usability. Covers IA principles (taxonomies, navigation, content-first journeys), modeling patterns (atomic types, references, topics + assemblies), and Contentful-specific mechanics (fields, validations, defaults, app framework). Use this skill any time the user is designing, refactoring, reviewing, or migrating a content model — even when they say "set up Contentful," "design content types," "we need a new content type," "this model is too rigid," "model an FAQ," or "should this be inline or a reference." Trigger whenever content structure decisions are being shaped so the result holds up at scale.

Make Contentful-driven sites fast and stay fast — pick between Delivery and Preview correctly, use the Sync API for incremental hydration, exploit the Images API for responsive imagery, design CDN cache headers and Next.js revalidation tags together, and avoid the cold-cache cliffs that show up on launch day. Use this skill any time Core Web Vitals are at issue, when Contentful queries are showing up in performance traces, when image weight is killing LCP, when a search index needs incremental sync, when Vercel cache is fighting Contentful's CDN, or when the team is debating "static export vs. ISR vs. on-demand revalidation." Trigger on any "this is slow" question that touches Contentful.

Design Contentful GraphQL Content API queries that are fast, typed, and maintainable — fragments, polymorphic unions for Topics & Assemblies, complexity budget management, locale-aware querying, codegen, and the patterns that keep the front end honest as the model evolves. Use this skill any time GraphQL queries are being written, refactored, or audited; when query complexity errors come up; when polymorphic section lists are being designed; when the team is choosing between REST and GraphQL; or when codegen breaks. Trigger whenever the question is "how should this query look" or "why is this query slow."

Design and operate Contentful localization — choose the right locales and fallback chains, mark fields as localizable correctly, integrate translation workflow apps, query locale-aware via REST and GraphQL, route locales in Next.js, and avoid the cache-fragmentation cliffs that come with multi-locale sites. Use this skill any time multi-locale enters a project; when an existing locale strategy is brittle; when adding a new locale; when "the French site shows English text"; or when the team is debating field-level localization vs. duplicate spaces. Trigger on any localization decision.