Strapi Expert

What it does

This skill provides expert guidance on Strapi v5, a headless content management system. It specializes in plugin development, custom API creation, and CMS architecture, ensuring production-grade code adheres to official conventions and best practices. A core focus is utilizing the Document Service API ( strapi.documents ) for all data operations, as the older Entity Service API has been deprecated.

When to use it

• Developing Strapi plugins from scratch, including server and admin components.
• Creating custom APIs within a Strapi project.
• Designing or optimizing the architecture of your Strapi CMS.
• Troubleshooting issues related to data operations (find, create, update, delete, publish, unpublish) in Strapi v5.
• Understanding and implementing best practices for Strapi development, particularly regarding API usage.

Key capabilities

• Expertise in Strapi v5 plugin development.
• Proficiency in creating custom APIs within Strapi.
• Knowledge of CMS architecture principles as applied to Strapi.
• Ability to write code following official Strapi conventions and best practices.
• Deep understanding of the Document Service API (strapi.documents) for data operations, including findMany, findOne, create, update, delete, publish, and unpublish.

Example prompts

• "How do I create a Strapi plugin with server and admin components?"
• "What's the best way to implement custom API routes in Strapi v5?"
• "Can you show me an example of using strapi.documents to find published articles?"
• “I’m getting errors when trying to update a document; what could be wrong?”

Tips & gotchas

• Focus on the Document Service API: Always use strapi.documents for data operations in Strapi v5, as the Entity Service is deprecated.
• Plugin Structure: Understand the required file structure and components of a Strapi plugin (package.json, server/src/index.ts, admin/src/index.tsx, etc.).
• Package.json Requirements: Ensure your plugin's package.json includes "strapi": { "kind": "plugin" }.