Craft CMS Claude Skills

Production-ready Claude Code skills, agents, and project templates for Craft CMS 5 development.

Built and maintained by michtio. Covers both plugin/module development (extending Craft) and site development (content modeling, Twig templates, front-end architecture).

Install

Three ways to install — pick what fits your workflow:

Method 1: Claude Code Plugin (recommended)

Register as a marketplace source, then install:

# In Claude Code
/plugin install craftcms-claude-skills@michtio/craftcms-claude-skills

This installs all skills and agents through Claude Code's native plugin system.

Method 2: Vercel Skills CLI

npx skills add michtio/craftcms-claude-skills --all

Installs all skills via the open Agent Skills ecosystem. Works with Claude Code, Cursor, Codex, and other compatible agents.

Method 3: Git Clone

git clone https://github.com/michtio/craftcms-claude-skills.git ~/.claude/craftcms-claude-skills
cd ~/.claude/craftcms-claude-skills && bash install.sh

Symlinks skills and agents into ~/.claude/. Existing skills are never overwritten.

To uninstall: cd ~/.claude/craftcms-claude-skills && bash uninstall.sh

What's Inside

Two Development Tracks

Plugin Development — Extending Craft

For building plugins, modules, custom element types, field types, services, controllers, migrations, queue jobs, events, and GraphQL schemas.

Site Development — Building with Craft

For content architecture, Twig templates, atomic design, component systems, and plugin configuration.

Shared

Agents

Six specialized sub-agents with dedicated models and tool scopes:

Plugin Development

Site Development

Project Template

A ready-to-use .claude/ directory for any Craft CMS 5 plugin repository. Copy project-template/ into your plugin repo and customize.

your-plugin/
├── CLAUDE.md                    # Imports rules, defines environment commands
└── .claude/
    └── rules/
        ├── architecture.md      # Service patterns, element operations, project config
        ├── coding-style.md      # PHPDocs, section headers, naming conventions
        ├── git-workflow.md      # Conventional commits, verification before push
        ├── migrations.md        # Idempotency, foreign keys, deployment safety
        ├── scaffolding.md       # ddev craft make generators
        ├── security.md          # Permissions, input sanitization, secrets
        ├── templates.md         # CP template macros, translations, admin checks
        └── testing.md           # Pest, factories, site context

Rules are path-scoped where appropriate — migrations.md only loads when editing files in src/migrations/, testing.md only in tests/.

CSS Framework Note

The craft-site skill documents an atomic design system that assumes Tailwind CSS for class composition. Craft CMS is unopinionated about front-end tooling — adapt the class patterns to your CSS framework. The component architecture (props, extends/block, include with only) is framework-agnostic.

Plugin Reference Library

The craft-site skill includes detailed references for 20 Craft plugins, each covering configuration, Twig/PHP API, common pitfalls, and cross-references:

Requirements

• Claude Code installed and configured
• DDEV for local Craft CMS development
• Craft CMS 5.x
• Bash (macOS/Linux) for the install script

Customization

Personal CLAUDE.md

The installer does not touch your ~/.claude/CLAUDE.md. A reference version is provided at reference/CLAUDE.md — review it and merge what you need.

Project Template

Copy the project template into your plugin repository:

cp -r ~/.claude/craftcms-claude-skills/project-template/.claude /path/to/your-plugin/
cp ~/.claude/craftcms-claude-skills/project-template/CLAUDE.md /path/to/your-plugin/

Then customize:

• Replace YourVendor in rules/coding-style.md with your author name
• Replace plugin-handle in rules/templates.md with your plugin's handle

Roadmap

• Additional plugin references (Neo, Imager-X, Feed Me, Commerce, Scout, Campaign)
• Twig element query reference (relatedTo patterns, cache tags)
• Multi-site patterns reference (propagation, language switchers)
• Release workflow reference (semver, changelog, CI/CD)
• Plugin Vite reference (VitePluginService, CP asset bundles)
• Hosting/deployment patterns (Craft Cloud, Servd, self-hosted)

Contributing

Contributions are welcome. See the issue templates for guidance:

• Skill improvements — open a PR with before/after examples
• New plugin references — follow the format in skills/craft-site/references/plugins/
• Bug reports — use the bug report issue template

All contributions must maintain the A+ quality standard established across the skill library.

License

MIT — see LICENSE.