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

These skills cover Drupal only. For a JavaScript framework on top of Drupal (React, Vue, Angular, and so on), install that framework’s skills alongside them, for example with npx skills find .

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

Skills (skills/)

Core Drupal

Design QA

Tooling & Observability

Drupal Canvas (page builder)

The React/JSX Code Component skills (component definition, metadata, composability, styling, data fetching, etc.) are maintained upstream — install them from the official suite rather than duplicating here (see Canvas Ecosystem). This repo ships only the complements that suite doesn’t cover:

8 Agents (.claude/agents/)

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

The core Drupal Canvas Code Component skills (component definition, metadata, composability, utils, styling, data fetching, push, regions, page definition, …) are maintained in the official drupal-canvas/skills repo. Install them directly rather than relying on a fork:

npx skills add drupal-canvas/skills

This repo intentionally does not duplicate those — it adds only the complements the official suite doesn’t cover: drupal-canvas-sdc (Twig SDC) and canvas-contribution (contributing upstream to drupal.org). Use them alongside the official suite.

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/                              # One dir per skill: SKILL.md + optional references/, examples/, scripts/
├── acquia-source/
├── canvas-contribution/
├── claude-code-mcp-setup/
├── design-review/
├── drupal-api-endpoints/
├── drupal-at-your-fingertips/
├── drupal-canvas/
├── drupal-canvas-sdc/
├── drupal-config-mgmt/
├── drupal-config-reconcile/
├── drupal-contrib-mgmt/
├── drupal-ddev/
├── drupal-deploy-safety/
├── drupal-mail/
├── drupal-performance/
├── drupal-search-api/
├── drupal-simple-oauth/
├── drupal-testing/
├── drupal-views-patterns/
├── drupal-vite-theme/
├── ivangrynenko-cursorrules-drupal/
├── mockup-parity/
├── sentry-integration/
└── skill-developer/
.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

Recommended Companion Tools

These aren’t Drupal-specific, so they live outside this repo — but they pair well with these skills on real Drupal work. Install separately; they’re optional.

• caveman — a token-compression skill that has the agent reply in a terse, fragmented style, cutting output tokens ~65–75% while keeping technical accuracy. Useful for long Drupal sessions (config audits, multi-file refactors) where verbose narration burns tokens. Toggle with /caveman; stop with “normal mode.”

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