Drupal Development Skills for Claude Code

Comprehensive Drupal development skills for Claude Code, organized by specialization. Choose the skills you need for front-end development, back-end development, or development tooling for Drupal 8-11+.

Quick Start

Install from Marketplace

If this repository is hosted on GitHub or another git service:

# Add this marketplace
/plugin marketplace add Omedia/drupal-skill

# Install all three skills
/plugin install drupal-frontend
/plugin install drupal-backend
/plugin install drupal-tooling

# Or install just what you need
/plugin install drupal-frontend  # For theme development
/plugin install drupal-backend   # For module development

Install from Local Repository

For local development or testing:

# Add local marketplace
/plugin marketplace add /path/to/drupal-skill

# Install skills
/plugin install drupal-frontend
/plugin install drupal-backend
/plugin install drupal-tooling

Available Skills

drupal-frontend - Front End Specialist

Theme development, Twig templates, and Drupal's rendering system.

Features:

• Theme structure and configuration
• Twig templating syntax and filters
• Template suggestions and debugging
• Preprocessing functions
• CSS/JS library management
• Responsive design and breakpoints
• Accessibility best practices

Use when:

• Creating or customizing Drupal themes
• Working with Twig templates
• Implementing preprocessing functions
• Managing CSS/JS assets
• Building responsive, accessible designs

Includes:

• Complete theming reference (theming.md)
• Theme template scaffold
• Twig examples and patterns

drupal-backend - Back End Specialist

Custom module development, hooks, APIs, and PHP programming.

Features:

• Custom module development
• Drupal hooks system
• Controllers and routing
• Forms API (configuration and custom)
• Entity API operations
• Plugin system (blocks, fields, etc.)
• Services and dependency injection
• Database operations

Use when:

• Building custom modules
• Implementing hooks
• Working with entities, forms, or plugins
• Creating custom controllers or services
• Database operations and queries

Includes:

• Hooks reference with examples (hooks.md)
• Module structure patterns (module_structure.md)
• Module template scaffold

drupal-tooling - Development Tools

Development environment and command-line tools

DDEV Docker environments and Drush command-line operations.

Features:

• DDEV project setup and management
• Database import/export and snapshots
• Drush cache, configuration, and module commands
• Deployment workflows
• User management and debugging
• Performance optimization

Use when:

• Setting up local development environments
• Managing databases and configuration
• Running Drush commands
• Deploying configuration changes
• Debugging and troubleshooting

Includes:

• Complete DDEV reference (ddev.md)
• Complete Drush reference (drush.md)
• Workflow examples

Usage Examples

Once installed, Claude automatically invokes the appropriate skill:

# Frontend work (uses drupal-frontend)
"Create a custom theme with a two-column layout"
"Write a preprocess function to add custom variables"
"Create a Twig template for article nodes"

# Backend work (uses drupal-backend)
"Create a custom module that adds a new content entity"
"Write a hook_form_alter to modify the user registration form"
"Build a custom block plugin with configuration"

# Tooling work (uses drupal-tooling)
"Set up a new DDEV project for Drupal 10"
"Import this database and clear the cache"
"Export configuration using Drush"

Supported Drupal Versions

All skills support:

• Drupal 8.x
• Drupal 9.x
• Drupal 10.x
• Drupal 11.x

Requirements

• Claude Code installed
• For drupal-tooling: Docker and DDEV installed for local development
• For drupal-tooling: Drush 10+ for command-line operations
• For drupal-backend: PHP 7.0+ (version depends on Drupal version)

Repository Structure

drupal-skill/
├── .claude-plugin/
│   └── marketplace.json          # Marketplace with all three skills
├── drupal-frontend/
│   ├── SKILL.md                  # Frontend skill instructions
│   ├── references/
│   │   └── theming.md
│   └── assets/
│       └── theme-template/
├── drupal-backend/
│   ├── SKILL.md                  # Backend skill instructions
│   ├── references/
│   │   ├── hooks.md
│   │   └── module_structure.md
│   └── assets/
│       └── module-template/
├── drupal-tooling/
│   ├── SKILL.md                  # Tooling skill instructions
│   └── references/
│       ├── ddev.md
│       └── drush.md
├── LICENSE
├── .gitignore
└── README.md                     # This file

Development

Testing Locally

1. Clone this repository
2. Add as local marketplace: /plugin marketplace add ./drupal-skill
3. Install skills: /plugin install drupal-frontend (or backend, tooling)
4. Test with Drupal development tasks

Contributing

Contributions are welcome! Please:

1. Test changes thoroughly with multiple Drupal versions (8-11+)
2. Update reference documentation as needed
3. Follow existing code patterns and structure
4. Update version numbers in marketplace.json

Why Three Separate Skills?

Focused Content: Each skill loads only relevant documentation and templates

Modular Installation: Install only what you need (frontend-only, backend-only, or both)

Better Performance: Smaller skills mean less context usage

Clear Separation: Frontend vs Backend vs Tooling mirrors real-world specializations

Support

For issues, questions, or contributions:

• Open an issue in this repository
• Check skill-specific SKILL.md files for detailed instructions
• Review reference documentation in each skill's references/ directory