Agent Resources

Reusable Claude Code resources for Drupal 10/11 development with DDEV and Docker-based local environments.

Built on the agent-resources package manager by Kasper Junge.

Installation

Install resources with a single command using agr (auto-detects resource type):

# Skills
agr add madsnorgaard/drupal-expert
agr add madsnorgaard/drupal-security
agr add madsnorgaard/drupal-migration
agr add madsnorgaard/ddev-expert
agr add madsnorgaard/docker-local

# Agents
agr add madsnorgaard/drupal-reviewer

# Commands
agr add madsnorgaard/drush-check
agr add madsnorgaard/module-scaffold
agr add madsnorgaard/config-export
agr add madsnorgaard/security-audit
agr add madsnorgaard/performance-check

Quick Start

# Install agr via uv
uv tool install agent-resources

# Add a resource (type auto-detected)
agr add madsnorgaard/drupal-expert

# Or try temporarily without installing
agrx madsnorgaard/drupal-expert

# Remove a resource
agr remove drupal-expert

# List installed resources
agr list

Philosophy

Research before building. These resources emphasize checking drupal.org for existing contrib modules before writing custom code. Maintainable Drupal sites minimize custom code.

Available Resources

Skills

Skill	Description
`drupal-expert`	Drupal 10/11 development - modules, themes, services, hooks, D10/D11 compatibility
`drupal-security`	Security expertise - auto-warns about XSS, SQL injection, access bypass while coding
`drupal-migration`	Migration expertise - D7-to-D10, CSV imports, custom source/process plugins
`ddev-expert`	DDEV local development - commands, Xdebug, custom services, performance tuning
`docker-local`	Custom Docker Compose patterns for non-DDEV projects

Agents

Agent	Description
`drupal-reviewer`	Code review for Drupal - security, standards, performance, DI compliance

Commands

Command	Usage	Description
`/drush-check`	`/drush-check`	Run health checks on a Drupal site
`/module-scaffold`	`/module-scaffold [name]`	Generate a new module with best-practice structure
`/config-export`	`/config-export`	Export Drupal configuration with review workflow
`/security-audit`	`/security-audit [path]`	Audit site for security vulnerabilities
`/performance-check`	`/performance-check [path]`	Analyze caching, queries, and optimization opportunities

Usage Examples

After installing the drupal-expert skill, Claude automatically applies Drupal best practices when you work on Drupal code - dependency injection, proper hooks, cache metadata, and more.

After installing the drupal-reviewer agent, Claude uses it to review your code for security issues, coding standards violations, and performance problems.

Commands are invoked with a slash:

/module-scaffold my_custom_module
/security-audit modules/custom/

Target Environment

These resources assume:

Drupal 10.3+ or Drupal 11
PHP 8.2+
Composer-based project structure
Configuration management (config sync directory)
Either DDEV or custom Docker Compose for local development

Coding Standards

All generated code follows:

Drupal coding standards (phpcs with drupal/coder)
PSR-4 autoloading
Dependency injection (no static \Drupal::service() calls)
PHP 8.2+ features (constructor property promotion, typed properties)
PHP attributes for plugins (Drupal 11 style)

Contributing

Add new resources by creating files in:

.claude/skills/<skill-name>/SKILL.md - For skills
.claude/agents/<agent-name>.md - For agents
.claude/commands/<command-name>.md - For slash commands

Push to GitHub and they're immediately available via agr add.

License

MIT

madsnorgaard/agent-resources

README