Skip to content
Back to search

drupal-claude-skills

SkillWorks with Claude CodeGitHub

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,…

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/grasmash--drupal-claude-skills/badge.svg)](/listings/grasmash--drupal-claude-skills)

HTML

<a href="/listings/grasmash--drupal-claude-skills"><img src="/api/listings/grasmash--drupal-claude-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

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 <framework>`.

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](https://agentskills.io).

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](AGENTS.md) to your project's CLAUDE.md.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 259 lines · 1 finding marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Drupal Claude Skills
  2. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  3. [![Claude Code](https://img.shields.io/badge/Claude-Code-orange.svg)](https://claude.com/claude-code)
  4. [![Drupal](https://img.shields.io/badge/Drupal-10%20%7C%2011-blue.svg)](https://www.drupal.org)
  5. [![agentskills.io](https://img.shields.io/badge/spec-agentskills.io-purple.svg)](https://agentskills.io)
  6. 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.
  7. ## Quick Install
  8. ### Option 1: Give this prompt to your AI agent
  9. Copy-paste this into Claude Code (or any AI coding agent) from your Drupal project directory:
  10. ```
  11. Install Drupal Claude Skills into this project from https://github.com/grasmash/drupal-claude-skills:
  12. 1. Clone the repo to a temp directory
  13. 2. Copy skills/ into .claude/skills/
  14. 3. Copy .claude/agents/ into .claude/agents/
  15. 4. Copy .claude/settings.json (if I don't already have one)
  16. 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)
  17. 6. Clean up the temp directory
  18. ```
  19. ### Option 2: Shell script
  20. ```bash
  21. bash <(curl -s https://raw.githubusercontent.com/grasmash/drupal-claude-skills/main/install.sh)
    • Note: Runs a downloaded script through process substitution (bash <(curl …))
    • Line 30 on GitHub
  22. ```
  23. Or from a cloned copy:
  24. ```bash
  25. ./install.sh /path/to/your/drupal/project
  26. ```
  27. ### Option 3: Skills CLI (skills only, no agents)
  28. ```bash
  29. npx skills add grasmash/drupal-claude-skills
  30. ```
  31. 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 <framework>`.
  32. 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](https://agentskills.io).
  33. ### Option 4: Manual
  34. ```bash
  35. git clone https://github.com/grasmash/drupal-claude-skills.git /tmp/drupal-skills
  36. # Skills
  37. cp -r /tmp/drupal-skills/skills/* .claude/skills/
  38. # Agents
  39. cp -r /tmp/drupal-skills/.claude/agents/* .claude/agents/
  40. # Settings (review and customize)
  41. cp /tmp/drupal-skills/.claude/settings.json .claude/settings.json
  42. # Clean up
  43. rm -rf /tmp/drupal-skills
  44. ```
  45. Then add the agent workflow guide from [AGENTS.md](AGENTS.md) to your project's CLAUDE.md.
  46. ## What's Included
  47. ### Skills (`skills/`)
  48. **Core Drupal**
  49. | Skill | Description |
  50. |-------|-------------|
  51. | **[drupal-at-your-fingertips](skills/drupal-at-your-fingertips/)** | Core API patterns from [Selwyn Polit's book](https://drupalatyourfingertips.com) — 14 topics in depth (services, hooks, events, plugins, entities, forms, routes, Twig, caching, AJAX, queries, config, Paragraphs, DTT), the other 39 chapters linked online |
  52. | **[drupal-config-mgmt](skills/drupal-config-mgmt/)** | Configuration management — safe import/export, config splits (complete vs partial), environment syncing, merge workflows |
  53. | **[drupal-config-reconcile](skills/drupal-config-reconcile/)** | Resolve config drift item-by-item against a deployed env — import vs export vs skip, verify with the import transformer, never write to prod |
  54. | **[drupal-contrib-mgmt](skills/drupal-contrib-mgmt/)** | Contrib module management — Composer updates, composer-patches v2 (`patches.lock.json` + relock), Drupal 11 compatibility, drupal.org workflow |
  55. | **[drupal-ddev](skills/drupal-ddev/)** | DDEV local development — setup, commands, database ops, Xdebug, performance (Mutagen), Docker/Mutagen troubleshooting |
  56. | **[drupal-deploy-safety](skills/drupal-deploy-safety/)** | What passes locally and breaks on deploy — deploy path per change class, the `updb` → `cr` → `cim` → `cr` tail, killed-`updb` maintenance stranding, the custom_field `addColumn()` truncate trap, re-firing external-store update hooks, service arity, Drush discovery, committed-vendor autoloader skew |
  57. | **[drupal-mail](skills/drupal-mail/)** | Mail system configuration — Mailpit local testing, transactional-API production sending, HTML email Content-Type gotchas, sender/formatter plugins |
  58. | **[drupal-performance](skills/drupal-performance/)** | Performance methodology + anti-patterns — cold-render query count as the metric, `http.client` render-path hangs, batched projections, plus eight caching/invalidation lessons (`references/caching-lessons.md`) |
  59. | **[drupal-views-patterns](skills/drupal-views-patterns/)** | Views mechanics + the "View vs custom vs JSON:API" decision — cache plugins, the eager-entity-row trap, pager COUNT cost, lean projections |
  60. | **[drupal-api-endpoints](skills/drupal-api-endpoints/)** | Custom API endpoints with UUID-based security — route/controller/fetch templates, authenticated cURL testing, the JSON:API filter-access cache-poisoning fix |
  61. | **[drupal-testing](skills/drupal-testing/)** | TDD with PHPUnit + DTT — bug-fix RED-first, bootstrap-level cost (Unit/Kernel/ExistingSite), the anonymous-403 permission trap, vacuous-pass pin |
  62. | **[ivangrynenko-cursorrules-drupal](skills/ivangrynenko-cursorrules-drupal/)** | OWASP Top 10 security patterns from [Ivan Grynenko](https://github.com/ivangrynenko/cursorrules) — auth, access control, injection prevention, crypto |
  63. | **[drupal-simple-oauth](skills/drupal-simple-oauth/)** | OAuth2 with simple_oauth — TokenAuthUser permissions, scope/role matching, field_permissions, CSRF bypass, debugging |
  64. | **[drupal-search-api](skills/drupal-search-api/)** | Search API — index configuration, boost processors, custom processors, config management, reindexing |
  65. | **[drupal-vite-theme](skills/drupal-vite-theme/)** | Fast custom themes on Vite + Tailwind v4 + SDC — the drupal/vite dev-server probe cold-render trap, content-hashed dist vs `version:` pins, anti-monolith bundling, Tailwind v4 preflight/`@theme` pitfalls, dist drift |
  66. | **[skill-developer](skills/skill-developer/)** | Meta-skill for creating new skills — agentskills.io spec, frontmatter schema, progressive disclosure, 500-line rule |
  67. **Design QA**
  68. | Skill | Description |
  69. |-------|-------------|
  70. | **[design-review](skills/design-review/)** | Live-environment design/QA pass for UI changes — 7 review phases, mockup parity, a11y, triage-matrix reporting, the layout-topology gate, the Tailwind computed-styles trap |
  71. | **[mockup-parity](skills/mockup-parity/)** | Porting static HTML mockups into themed Twig/SDC routes — two-gate reconciliation workflow, delta classification, capability preservation, visual diff ledger |
  72. **Tooling & Observability**
  73. | Skill | Description |
  74. |-------|-------------|
  75. | **[sentry-integration](skills/sentry-integration/)** | Sentry for Drupal — MCP issue triage, the comment REST API, N+1 patterns, raven module tracing gotchas (the `trace` PII trap, the tracing permission gate) |
  76. | **[claude-code-mcp-setup](skills/claude-code-mcp-setup/)** | Add and configure MCP servers in Claude Code — stdio/HTTP/SSE transports, OAuth servers, troubleshooting `/mcp` failures |
  77. **Drupal Canvas** (page builder)
  78. 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](#canvas-ecosystem)). This repo ships only the complements that suite doesn't cover:
  79. | Skill | Description |
  80. |-------|-------------|
  81. | **[drupal-canvas](skills/drupal-canvas/)** | Short pointer to the official `drupal-canvas/skills` suite for Code Components — lists its skills and routes Twig SDC and contribution work to the complements below |
  82. | **[drupal-canvas-sdc](skills/drupal-canvas-sdc/)** | Twig-based Single Directory Components — `component.yml` schemas, Canvas registration rules, component config entities, instance version management, deploy pitfalls (the official suite is React/JSX only) |
  83. | **[canvas-contribution](skills/canvas-contribution/)** | Contributing Canvas features/fixes upstream to drupal.org — issue forks, MRs, composer patches |
  84. | **[acquia-source](skills/acquia-source/)** | Connect to an Acquia Source CMS — JSON:API (`/api`) + OAuth2, the MCP server (`claude mcp add`), the `@drupal-canvas` CLI, and Canvas Page API deploy pitfalls |
  85. ### 8 Agents (`.claude/agents/`)
  86. | Agent | Description |
  87. |-------|-------------|
  88. | **quality-gate** | Pre-commit code review — security, performance, testing, regressions |
  89. | **done-gate** | Completion validator — builds pass, tests run, deliverables exist |
  90. | **drupal-specialist** | Drupal/PHP implementation — modules, hooks, services, Drush |
  91. | **frontend-specialist** | Frontend — Twig, SCSS, JavaScript, responsive design, accessibility |
  92. | **researcher** | Codebase exploration — architecture, patterns, execution paths |
  93. | **reviewer** | Code review — bugs, security, quality, actionable feedback |
  94. | **test-runner** | Test execution — PHP, JS, SCSS validation, build checks |
  95. | **test-writer** | ExistingSite test writing — bug reproduction, DTT patterns |
  96. ### Settings (`.claude/settings.json`)
  97. Sample Drupal-safe permission patterns. Prompts for confirmation before destructive operations like `drush cim`, `drush sql-drop`, and `drush site:install`.
  98. ## Canvas Ecosystem
  99. 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](https://github.com/drupal-canvas/skills)** repo. Install them directly rather than relying on a fork:
  100. ```bash
  101. npx skills add drupal-canvas/skills
  102. ```
  103. 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.
  104. Scaffold a new Canvas project:
  105. ```bash
  106. npx @drupal-canvas/create my-project
  107. ```
  108. ## Usage
  109. Skills activate automatically based on context:
  110. - Working with config splits → `drupal-config-mgmt` activates
  111. - Updating a module → `drupal-contrib-mgmt` activates
  112. - Security review → `ivangrynenko-cursorrules-drupal` activates
  113. - OAuth debugging → `drupal-simple-oauth` activates
  114. - Local dev issue → `drupal-ddev` activates
  115. You can also invoke skills explicitly:
  116. ```
  117. "Using the drupal-config-mgmt skill, help me set up partial config splits"
  118. ```
  119. ## Repository Structure
  120. ```
  121. skills/ # One dir per skill: SKILL.md + optional references/, examples/, scripts/
  122. ├── acquia-source/
  123. ├── canvas-contribution/
  124. ├── claude-code-mcp-setup/
  125. ├── design-review/
  126. ├── drupal-api-endpoints/
  127. ├── drupal-at-your-fingertips/
  128. ├── drupal-canvas/
  129. ├── drupal-canvas-sdc/
  130. ├── drupal-config-mgmt/
  131. ├── drupal-config-reconcile/
  132. ├── drupal-contrib-mgmt/
  133. ├── drupal-ddev/
  134. ├── drupal-deploy-safety/
  135. ├── drupal-mail/
  136. ├── drupal-performance/
  137. ├── drupal-search-api/
  138. ├── drupal-simple-oauth/
  139. ├── drupal-testing/
  140. ├── drupal-views-patterns/
  141. ├── drupal-vite-theme/
  142. ├── ivangrynenko-cursorrules-drupal/
  143. ├── mockup-parity/
  144. ├── sentry-integration/
  145. └── skill-developer/
  146. .claude/
  147. ├── agents/ # Agent definitions
  148. │ ├── quality-gate.md
  149. │ ├── done-gate.md
  150. │ ├── drupal-specialist.md
  151. │ ├── frontend-specialist.md
  152. │ ├── researcher.md
  153. │ ├── reviewer.md
  154. │ ├── test-runner.md
  155. │ └── test-writer.md
  156. ├── settings.json # Sample Drupal permissions
  157. └── scripts/ # Upstream sync scripts
  158. ├── sync-d9book.sh
  159. └── sync-ivan-rules.sh
  160. ```
  161. ## Updating Upstream Skills
  162. Two skills sync from upstream sources:
  163. ```bash
  164. # Sync Drupal at Your Fingertips references
  165. ./.claude/scripts/sync-d9book.sh
  166. # Sync Ivan Grynenko security patterns
  167. ./.claude/scripts/sync-ivan-rules.sh
  168. ```
  169. ## Recommended Companion Tools
  170. 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.
  171. - **[caveman](https://github.com/JuliusBrussee/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."
  172. ## Contributing
  173. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on:
  174. - Adding new skills (follow [agentskills.io spec](https://agentskills.io/specification))
  175. - Adding new agents
  176. - Improving existing content
  177. - Syncing upstream sources
  178. ## Credits
  179. - **[Selwyn Polit](https://drupalatyourfingertips.com)** — Drupal at Your Fingertips
  180. - **[Ivan Grynenko](https://github.com/ivangrynenko/cursorrules)** — Drupal security patterns
  181. - **Drupal Community** — Ongoing contributions to documentation and best practices
  182. ## License
  183. MIT — see [LICENSE](LICENSE)
  184. ## Related Resources
  185. - [agentskills.io Specification](https://agentskills.io/specification)
  186. - [Claude Code Documentation](https://docs.anthropic.com/en/docs/claude-code)
  187. - [Drupal Canvas Skills](https://github.com/drupal-canvas/skills)
  188. - [Drupal.org](https://drupal.org)
  189. - [DDEV Documentation](https://ddev.readthedocs.io)
  190. ---
  191. ## Star History
  192. [![Star History Chart](https://api.star-history.com/svg?repos=grasmash/drupal-claude-skills&type=Date)](https://star-history.com/#grasmash/drupal-claude-skills&Date)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.