@se-studio/skills

Agent skills for SE Studio marketing site development with Contentful CMS.

Install

In this monorepo — skills are synced into .agents/skills/ (symlinked from .cursor/skills/):

pnpm skills:validate
pnpm skills:sync

From this package directory: pnpm validate (runs the same frontmatter check).

In external projects:

npx skills add @se-studio/skills

Auto-sync on pnpm install (see packages/project-build/README.md for the full package.json snippet). Use pnpm skills:sync manually to add or refresh third-party skill packs.

Package layout

| Path | Purpose | |------|---------| | skills/<name>/SKILL.md | Agent skills — the only directories scanned by skills-npm and the skills CLI | | references/<name>/ | Support docs, prompt packs, and pipeline references (no SKILL.md) |

Do not place non-skill material under skills/ — directories there without SKILL.md cause file_error warnings in consumer repos on pnpm install.

Authoring skills

Canonical sources live in packages/skills/skills/<skill-dir>/SKILL.md. Do not edit .agents/skills/ by hand.

Frontmatter contract (Claude Code compatible)

Every SKILL.md must start with YAML frontmatter containing only name and description:

---
name: se-marketing-sites-create-component
description: "Guide for creating new CMS-driven components. Use when asked to create a new CMS component."
---

Rules:

| Field | Requirement | |-------|-------------| | name | Must exactly match the skill directory name; [a-z0-9-]+ only; max 64 characters | | description | Single line, double-quoted, non-empty, max 1024 characters; no backticks |

Do not use:

• YAML block scalars for description (>, |)
• Multiline descriptions
• Extra frontmatter keys (license, metadata, promptSignals, etc.) — put those in the markdown body if needed
• Invalid name values (spaces, capitals, colons, dots)

Claude Code uses a naive frontmatter parser; violations cause descriptions to silently disappear from the skill selector.

Workflow

1. Edit packages/skills/skills/<skill-dir>/SKILL.md
2. Validate: pnpm skills:validate
3. Sync: pnpm skills:sync (copies skills/ → .agents/skills/ and references/ → .agents/references/, then strips AGENTS.md next to SKILL.md)
4. Add a changeset if publishing @se-studio/skills

cms-edit bundled skills (@se-studio/contentful-cms)

The CLI ships a subset of skills under packages/contentful-cms/skills/ for cms-edit skill install. Those files are generated from this package:

| Canonical source (packages/skills/skills/) | Bundled name (packages/contentful-cms/skills/) | |---------------------------------------------|--------------------------------------------------| | contentful-cms-core | core | | contentful-cms-editor-tasks | editor-tasks | | contentful-cms-templates | templates | | contentful-cms-setup | setup |

After editing any contentful-cms-* skill here, run:

pnpm --filter @se-studio/contentful-cms sync:skills

Do not edit packages/contentful-cms/skills/ directly. See packages/contentful-cms/docs/SKILLS.md.

Do not use .claude/skills/ in the repo as a skill source — it is untracked and local. Use .agents/skills/ (via pnpm skills:sync) or cms-edit skill install.

References

• Anthropic skill authoring best practices
• Monorepo skill index: root CLAUDE.md and docs/AI_QUICK_REFERENCE.md