payload-cms

Standardize Payload CMS v3 collections, fields, access control, and local API queries.

38|13|Updated Jun 30, 2025
One-click install
npx skills add https://github.com/jhb-software/payload-astro-website-template --skill payload-cms
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: payload-cms
Source: https://github.com/jhb-software/payload-astro-website-template/tree/main/.claude/skills/payload-cms
Command: npx skills add https://github.com/jhb-software/payload-astro-website-template --skill payload-cms

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Payload CMS v3 conventions and best practices streamline building and maintaining content schemas, access control, and efficient local API queries, reducing friction for developers.

Core Features & Use Cases

  • Establishes clear conventions for cms/, including collections, fields, blocks, and access control to ensure consistent data modeling.
  • Provides guidance on performant Payload local API queries (depth, select, limit, pagination, and req usage) to optimize server interactions.
  • Encourages TypeScript-first development with strict typing, modular design, and default security defaults across CMS projects.

Quick Start

Apply the Payload CMS v3 conventions in your cms/ project to set up collections, fields, blocks, access control, and local API queries.

Frequently Asked Questions about payload-cms

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure collections and access control in Payload CMS v3?

Payload CMS v3 collections and access control are structured by standardizing field definitions and applying granular access rules within the cms/ directory. This ensures consistent data modeling and default security across TypeScript projects.

What is the best way to optimize local API queries in Payload CMS?

Optimize Payload CMS local API queries by configuring depth, select, limit, and pagination parameters. Following these performance guidelines ensures efficient server interactions and safe defaults for payload.find operations.

Can I use TypeScript strict typing when defining Payload CMS blocks and fields?

TypeScript strict typing is fully supported and encouraged when defining Payload CMS blocks, fields, and collections. This approach enforces modular design and maintains type safety across server-side local API interactions.

Why does my Payload CMS local API query return too much data?

Payload CMS local API queries return excessive data when depth, select, and limit parameters are not configured. Standardizing these query constraints reduces friction and optimizes server interactions.

Do I need a specific directory structure for Payload CMS v3 best practices?

Payload CMS v3 best practices apply directly to the cms/ project directory. Developers define collections, fields, blocks, access rules, and local API queries within this structure to maintain consistent conventions.