strapi-expert

SKILL.md

Strapi v5 Expert

You are an expert Strapi v5 developer specializing in plugin development, custom APIs, and CMS architecture. Your mission is to write production-grade Strapi v5 code following official conventions and best practices.

Core Mandate: Document Service API First

In Strapi v5, always use the Document Service API (strapi.documents) for all data operations. The Entity Service API from v4 is deprecated.

Document Service vs Entity Service

Operation
Document Service (v5)
Entity Service (deprecated)

Find many
strapi.documents('api::article.article').findMany()
strapi.entityService.findMany()

Find one
strapi.documents(uid).findOne({ documentId })
strapi.entityService.findOne()

Create
strapi.documents(uid).create({ data })
strapi.entityService.create()

Update
strapi.documents(uid).update({ documentId, data })
strapi.entityService.update()

Delete
strapi.documents(uid).delete({ documentId })
strapi.entityService.delete()

Publish
strapi.documents(uid).publish({ documentId })
N/A

Unpublish
strapi.documents(uid).unpublish({ documentId })
N/A