# payloadcms

Walks the agent through Payload CMS work in a repo: bootstrapping an app, changing collection schemas, debugging the admin panel or API, preparing migrations.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 253 installs · ★ 61 repo stars
- Author: akillness
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/payloadcms/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/payloadcms

## What it does

This skill covers Payload CMS, the Next.js-native headless CMS, inside an existing repository. It starts by asking you to pick one mode. Bootstrap handles a fresh install or a first integration. Modeling is for collection and global schemas. Runtime debug is for a failing admin page or endpoint. Release prep comes before a production rollout.

Preflight comes first: the Node toolchain and package manager, the location of `payload.config.*` and the model files, how `DATABASE_URI` plus storage and auth keys are supplied, and the migration history before any schema edit. It can call `Bash`, `Read`, `Write`, `Edit`, `Glob`, `Grep` and `WebFetch`. Schema work is meant to be one bounded change per pass, with the blast radius written down for collections, API output, admin forms and import jobs.

For work outside Payload's runtime the skill steps aside: physical database tuning goes to `database-schema-design`, auth architecture to `authentication-setup`. Pushing it there wastes a pass. A green admin check also proves little when `DATABASE_URI` is not wired up.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill payloadcms -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/payloadcms/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/payloadcms/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill payloadcms -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/payloadcms/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill payloadcms -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/payloadcms/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akillness/jeo-skills .agent-skills/payloadcms/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/payloadcms/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill payloadcms -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/payloadcms
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/payloadcms/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill payloadcms -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/payloadcms/SKILL.md

## When to use it
- bootstrap a Payload app and confirm the admin panel plus one collection endpoint respond
- add a collection with explicit access rules without breaking existing API output
- trace a failing admin route back to a bad field, access rule or env binding
- write migration order and rollback notes before merging a schema change
- audit how `DATABASE_URI` and adapter keys reach the runtime

## Example prompts
- Add a `posts` collection to our Payload config and list what the migration touches
- The Payload admin route broke after yesterday's schema change, find the root cause
- Bootstrap a Payload app in this repo and verify the admin panel and one collection endpoint

## Similar
- [prismic](https://affpapa.org/en/nevibecode/skills/prismic.md) — skill · 1600 installs
- [contentful-guide](https://affpapa.org/en/nevibecode/skills/contentful-guide.md) — skill · 405 installs
- [sanity](https://affpapa.org/en/nevibecode/skills/sanity.md) — skill · 767 installs
- [content-modeling-best-practices](https://affpapa.org/en/nevibecode/skills/content-modeling-best-practices.md) — skill · 5200 installs
- [Cosmic](https://affpapa.org/en/nevibecode/mcp/cosmic.md) — MCP server · ★ 1 repo stars
- [contentful-migration](https://affpapa.org/en/nevibecode/skills/contentful-migration.md) — skill · 352 installs

From the same set: [akillness/jeo-skills](https://affpapa.org/en/nevibecode/by/akillness/jeo-skills.md) — 99 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
