Payload Skills

Два скилла для Payload CMS: коллекции, хуки и доступы плюс перенос контента из WordPress, Strapi и Contentful.

  • 172 ★ репозитория
  • Последний коммит
Скилл

Минимальный доступ

Почему такой уровень

  • Только инструкции и справочники без собственного кода и сетевых вызовов.
Все причины и проверки

payloadcms/skills

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/payload-skills

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Минимальный доступИнструмент ничего не запускает и не ходит в сеть.

  • Только инструкции и справочники без собственного кода и сетевых вызовов.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Репозиторий выкладывает два скилла для проектов на Payload. Скилл `payload` — справочник для разработки: коллекции с авторизацией, загрузками и черновиками, все типы полей, хуки `beforeChange` и `afterChange`, контроль доступа вплоть до ролей и мультиарендности, запросы через Local API, REST и GraphQL, адаптеры MongoDB, Postgres и SQLite, очередь задач, свои эндпоинты и локализация. Он срабатывает, когда агент видит `payload.config.ts` или отлаживает ошибки валидации, связей и транзакций. Скилл `cms-migration` ведет диалог о переносе: агент разбирает выгрузку из другой CMS в JSON или CSV, определяет типы полей и связи, затем по шагам строит конфиги коллекций Payload и только после этого импортирует данные. В комплекте таблицы соответствия полей для WordPress, Contentful и Strapi и список типичных ловушек, например различие между select и relationship.

Для кого. Разработчикам на Payload CMS и командам, которые переезжают на него с WordPress, Contentful, Strapi, Sanity или Webflow.

Подходит, если

  • В проекте на Payload падает валидация или не находится связанный документ, и агенту нужны правила поведения полей.
  • Список записей показывают пользователю по его роли, и правило описывают в access control.
  • Хук `afterChange` вызывает сам себя по кругу, и от петли защищает проверка `req.context`.
  • Сайт на WordPress переносят в Payload, и структуру коллекций проектируют по выгрузке контента.
  • Пишут плагин для Payload и собирают его пакет с нуля.

Не подходит, если

  • Проект не на Payload: скиллы целиком про его конфигурацию и API.
  • Структура коллекций уже готова, а данные нужно просто залить: диалог проектирования только замедлит работу.
  • Вы хотите скилл, который идет вместе с пакетом `payload` и совпадает с установленной версией: он вынесен в отдельную карточку.

Пример запроса к агенту

Вот выгрузка постов WordPress в JSON: предложи коллекции Payload, обсуди со мной связи и только потом импортируй данные.

Ограничения

Скиллы лежат отдельно от пакета `payload`, поэтому их справочник может расходиться с установленной у вас версией. Файла лицензии в репозитории нет: MIT заявлена только в тексте README. Скилл `cms-migration` начинает с диалога о структуре коллекций, поэтому переноса одной командой не будет. Для переноса нужна выгрузка в JSON или CSV, прямого подключения к WordPress, Contentful или Strapi в комплекте нет. Последний коммит в репозитории — август 2026 года.

Как отключить. Удалите папки `payload` и `cms-migration` из каталога скиллов агента (например, `.claude/skills/`) или выполните `npx skills remove` для этого набора.

Частые вопросы

Как поставить скиллы Payload в Claude Code?

Выполните `npx skills add payloadcms/skills`. Команда кладет обе папки в каталог скиллов агента, после чего скилл `payload` срабатывает на проекте с `payload.config.ts`.

Чем эти скиллы отличаются от скилла внутри пакета payload?

Тот скилл идет вместе с пакетом `payload` и совпадает с установленной версией. Здесь отдельный репозиторий: он ставится через `npx skills` и добавляет `cms-migration`, которого в пакете нет.

Что делает cms-migration?

Ведет диалог о переносе контента: разбирает выгрузку, намечает коллекции Payload и согласует связи. Импорт данных наступает после того, как структура утверждена.

Какие CMS покрывает перенос?

В описании названы WordPress, Contentful, Strapi, Sanity и Webflow. Таблицы соответствия полей есть для WordPress, Contentful и Strapi, для остальных агент опирается на общий справочник типов полей Payload.

Что охватывает скилл payload?

Коллекции, поля, хуки, контроль доступа, запросы через Local API, REST и GraphQL, адаптеры баз данных, очередь задач, эндпоинты, локализацию и разработку плагинов. Подробности лежат в файлах `reference/` и подгружаются по запросу.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Скилл Payload

Payload agent skill

Официальный скилл Payload CMS, который приходит вместе с пакетом: коллекции, поля, хуки, доступы, запросы и адаптеры баз данных

СкиллМинимальный доступ45,8 тыс.Звезды репозитория
Официальный

Скилл Elysia v2 учит агента писать, отлаживать и переносить бэкенды на Elysia: валидация, плагины, типизированные клиенты и деплой

СкиллМинимальный доступ71Звезды репозитория

Набор из 16 скиллов для Spring Boot: агент сначала изучает приложение, потом правит JPA, DTO, REST, Security, Kafka и тесты.

СкиллРасширенный доступ138Звезды репозитория

Пять скиллов от Vercel по Workflow SDK: установка, написание долговечных рабочих процессов и переход между версиями.

СкиллРасширенный доступ2,5 тыс.Звезды репозитория

Сотни скиллов по провайдерам учат агента принимать вебхуки, проверять подписи и разбирать события; примеры для Express и FastAPI.

СкиллМинимальный доступ101Звезды репозитория

Коротко о README

README коротко представляет оба скилла, для каждого дает цитату-описание, ситуации применения и перечень тем. Установка одной командой, подробности о `payload` вынесены в отдельный README внутри папки скилла.

Бейдж для README

Исходный SKILL.md

---
name: payload
description: Use when working with Payload projects (payload.config.ts, collections, fields, hooks, access control, Payload API). Use when debugging validation errors, security issues, relationship queries, transactions, or hook behavior.
---

# Payload Application Development

Payload is a Next.js native CMS with TypeScript-first architecture, providing admin panel, database management, REST/GraphQL APIs, authentication, and file storage.

## Quick Reference

| Task                     | Solution                                                                   | Details                                                                                                                          |
| ------------------------ | -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| Auto-generate slugs      | `slugField()`                                                              | [FIELDS.md#slug-field-helper](reference/FIELDS.md#slug-field-helper)                                                             |
| Restrict content by user | Access control with query                                                  | [ACCESS-CONTROL.md#row-level-security-with-complex-queries](reference/ACCESS-CONTROL.md#row-level-security-with-complex-queries) |
| Local API user ops       | `user` + `overrideAccess: false`                                           | [QUERIES.md#access-control-in-local-api](reference/QUERIES.md#access-control-in-local-api)                                       |
| Draft/publish workflow   | `versions: { drafts: true }`                                               | [COLLECTIONS.md#versioning--drafts](reference/COLLECTIONS.md#versioning--drafts)                                                 |
| Computed fields          | `virtual: true` with **field-level** `hooks.afterRead` returning the value | [FIELDS.md#virtual-fields](reference/FIELDS.md#virtual-fields)                                                                   |
| Conditional fields       | `admin.condition`                                                          | [FIELDS.md#conditional-fields](reference/FIELDS.md#conditional-fields)                                                           |
| Custom field validation  | `validate` function                                                        | [FIELDS.md#validation](reference/FIELDS.md#validation)                                                                           |
| Filter relationship list | `filterOptions` on field                                                   | [FIELDS.md#relationship](reference/FIELDS.md#relationship)                                                                       |
| Select specific fields   | `select` parameter                                                         | [QUERIES.md#field-selection](reference/QUERIES.md#field-selection)                                                               |
| Auto-set author/dates    | beforeChange hook                                                          | [HOOKS.md#collection-hooks](reference/HOOKS.md#collection-hooks)                                                                 |
| Prevent hook loops       | `req.context` check                                                        | [HOOKS.md#context](reference/HOOKS.md#context)                                                                                   |
| Cascading deletes        | beforeDelete hook                                                          | [HOOKS.md#collection-hooks](reference/HOOKS.md#collection-hooks)                                                                 |
| Geospatial queries       | `point` field with `near`/`within`                                         | [FIELDS.md#point-geolocation](reference/FIELDS.md#point-geolocation)                                                             |
| Reverse relationships    | `join` field type                                                          | [FIELDS.md#join-fields](reference/FIELDS.md#join-fields)                                                                         |
| Next.js revalidation     | Context control in afterChange                                             | [HOOKS.md#nextjs-revalidation-with-context-control](reference/HOOKS.md#nextjs-revalidation-with-context-control)                 |
| Query by relationship    | Nested property syntax                                                     | [QUERIES.md#nested-properties](reference/QUERIES.md#nested-properties)                                                           |
| Complex queries          | AND/OR logic                                                               | [QUERIES.md#andor-logic](reference/QUERIES.md#andor-logic)                                                                       |
| Transactions             | Pass `req` to operations                                                   | [ADAPTERS.md#threading-req-through-operations](reference/ADAPTERS.md#threading-req-through-operations)                           |
| Background jobs          | Jobs queue with tasks                                                      | [ADVANCED.md#jobs-queue](reference/ADVANCED.md#jobs-queue)                                                                       |
| Custom API routes        | Collection custom endpoints                                                | [ADVANCED.md#custom-endpoints](reference/ADVANCED.md#custom-endpoints)                                                           |
| Cloud storage            | Storage adapter plugins                                                    | [ADAPTERS.md#storage-adapters](reference/ADAPTERS.md#storage-adapters)                                                           |
| Multi-language           | `localization` config + `localized: true`                                  | [ADVANCED.md#localization](reference/ADVANCED.md#localization)                                                                   |
| Create plugin            | `(options) => (config) => Config`                                          | [PLUGIN-DEVELOPMENT.md#plugin-architecture](reference/PLUGIN-DEVELOPMENT.md#plugin-architecture)                                 |
| Plugin package setup     | Package structure with SWC                                                 | [PLUGIN-DEVELOPMENT.md#plugin-package-structure](reference/PLUGIN-DEVELOPMENT.md#plugin-package-structure)                       |
| Add fields to collection | Map collections, spread fields                                             | [PLUGIN-DEVELOPMENT.md#adding-fields-to-collections](reference/PLUGIN-DEVELOPMENT.md#adding-fields-to-collections)               |
| Plugin hooks             | Preserve existing hooks in array                                           | [PLUGIN-DEVELOPMENT.md#adding-hooks](reference/PLUGIN-DEVELOPMENT.md#adding-hooks)                                               |
| Check field type         | Type guard functions                                                       | [FIELD-TYPE-GUARDS.md](reference/FIELD-TYPE-GUARDS.md)                                                                           |

## Quick Start

```bash
npx create-payload-app@latest my-app
cd my-app
pnpm dev
```

### Minimal Config

Сообщить о проблеме