Drupal Claude Skills

A comprehensive collection of Claude Code skills and agents for Drupal development. Install battle-tested patterns for configuration management, module updates, security, local development, OAuth, search, and more.

Quick Install

Option 1: Give this prompt to your AI agent

Copy-paste this into Claude Code (or any AI coding agent) from your Drupal project directory:

Install Drupal Claude Skills into this project from https://github.com/grasmash/drupal-claude-skills:

1. Clone the repo to a temp directory
2. Copy skills/ into .claude/skills/
3. Copy .claude/agents/ into .claude/agents/
4. Copy .claude/settings.json (if I don't already have one)
5. Read AGENTS.md from the repo and append the "Agent Workflow Guide" section to my CLAUDE.md (create CLAUDE.md if it doesn't exist)
6. Clean up the temp directory

Option 2: Shell script

bash <(curl -s https://raw.githubusercontent.com/grasmash/drupal-claude-skills/main/install.sh)

Or from a cloned copy:

./install.sh /path/to/your/drupal/project

Option 3: Skills CLI (skills only, no agents)

npx skills add grasmash/drupal-claude-skills

This copies skills into .claude/skills/ but does not install agents, settings, or the workflow guide. Works with Claude Code, Cursor, Codex, Gemini CLI, and any tool supporting the agentskills.io specification.

Option 4: Manual

git clone https://github.com/grasmash/drupal-claude-skills.git /tmp/drupal-skills

# Skills
cp -r /tmp/drupal-skills/skills/* .claude/skills/

# Agents
cp -r /tmp/drupal-skills/.claude/agents/* .claude/agents/

# Settings (review and customize)
cp /tmp/drupal-skills/.claude/settings.json .claude/settings.json

# Clean up
rm -rf /tmp/drupal-skills

Then add the agent workflow guide from AGENTS.md to your project's CLAUDE.md.

What's Included

9 Skills (skills/)

Skill	Description
drupal-at-your-fingertips	50+ Drupal topics from Selwyn Polit's book — services, hooks, entities, forms, theming, caching, testing
drupal-config-mgmt	Configuration management — safe import/export, config splits (complete vs partial), environment syncing, merge workflows
drupal-contrib-mgmt	Contrib module management — Composer updates, patch management, Drupal 11 compatibility, drupal.org contribution workflow
drupal-ddev	DDEV local development — setup, commands, database ops, Xdebug, performance (Mutagen), Docker/Mutagen troubleshooting
ivangrynenko-cursorrules-drupal	OWASP Top 10 security patterns from Ivan Grynenko — auth, access control, injection prevention, crypto
drupal-simple-oauth	OAuth2 with simple_oauth — TokenAuthUser permissions, scope/role matching, field_permissions, CSRF bypass, debugging
drupal-search-api	Search API — index configuration, boost processors, custom processors, config management, reindexing
drupal-canvas	Drupal Canvas Code Components — scaffolding, Nebula template, Acquia Source Site Builder integration
skill-developer	Meta-skill for creating new skills — agentskills.io spec, frontmatter schema, progressive disclosure, 500-line rule

8 Agents (.claude/agents/)

Agent	Description
quality-gate	Pre-commit code review — security, performance, testing, regressions
done-gate	Completion validator — builds pass, tests run, deliverables exist
drupal-specialist	Drupal/PHP implementation — modules, hooks, services, Drush
frontend-specialist	Frontend — Twig, SCSS, JavaScript, responsive design, accessibility
researcher	Codebase exploration — architecture, patterns, execution paths
reviewer	Code review — bugs, security, quality, actionable feedback
test-runner	Test execution — PHP, JS, SCSS validation, build checks
test-writer	ExistingSite test writing — bug reproduction, DTT patterns

Settings (.claude/settings.json)

Sample Drupal-safe permission patterns. Prompts for confirmation before destructive operations like drush cim, drush sql-drop, and drush site:install.

Canvas Ecosystem

For Drupal Canvas Code Components, this repo includes a lightweight drupal-canvas skill as an entry point. For the full 7-skill Canvas development suite:

npx skills add drupal-canvas/skills

Scaffold a new Canvas project:

npx @drupal-canvas/create my-project

Usage

Skills activate automatically based on context:

• Working with config splits → drupal-config-mgmt activates
• Updating a module → drupal-contrib-mgmt activates
• Security review → ivangrynenko-cursorrules-drupal activates
• OAuth debugging → drupal-simple-oauth activates
• Local dev issue → drupal-ddev activates

You can also invoke skills explicitly:

"Using the drupal-config-mgmt skill, help me set up partial config splits"

Repository Structure

skills/                              # Skills (agentskills.io format)
├── drupal-at-your-fingertips/       #   50+ Drupal topics
│   ├── SKILL.md
│   └── references/
├── drupal-config-mgmt/              #   Config management
│   ├── SKILL.md
│   └── references/
├── drupal-contrib-mgmt/             #   Module management
│   ├── SKILL.md
│   ├── references/
│   └── examples/
├── drupal-ddev/                     #   DDEV local dev
│   ├── SKILL.md
│   └── references/
├── ivangrynenko-cursorrules-drupal/ #   Security patterns
│   ├── SKILL.md
│   └── references/
├── drupal-simple-oauth/             #   OAuth2 patterns
│   └── SKILL.md
├── drupal-search-api/               #   Search API patterns
│   └── SKILL.md
├── drupal-canvas/                   #   Canvas components
│   └── SKILL.md
└── skill-developer/                 #   Meta-skill for creating skills
    └── SKILL.md
.claude/
├── agents/                          # Agent definitions
│   ├── quality-gate.md
│   ├── done-gate.md
│   ├── drupal-specialist.md
│   ├── frontend-specialist.md
│   ├── researcher.md
│   ├── reviewer.md
│   ├── test-runner.md
│   └── test-writer.md
├── settings.json                    # Sample Drupal permissions
└── scripts/                         # Upstream sync scripts
    ├── sync-d9book.sh
    └── sync-ivan-rules.sh

Updating Upstream Skills

Two skills sync from upstream sources:

# Sync Drupal at Your Fingertips references
./.claude/scripts/sync-d9book.sh

# Sync Ivan Grynenko security patterns
./.claude/scripts/sync-ivan-rules.sh

Contributing

See CONTRIBUTING.md for guidelines on:

• Adding new skills (follow agentskills.io spec)
• Adding new agents
• Improving existing content
• Syncing upstream sources

Credits

• Selwyn Polit — Drupal at Your Fingertips
• Ivan Grynenko — Drupal security patterns
• Drupal Community — Ongoing contributions to documentation and best practices

License

MIT — see LICENSE

Related Resources

• agentskills.io Specification
• Claude Code Documentation
• Drupal Canvas Skills
• Drupal.org
• DDEV Documentation

---

Star History