Agent Resources

# Agent Resources

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

Built on the [agent-resources](https://github.com/kasperjunge/agent-resources) package manager by Kasper Junge.

## Installation

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

```bash
# 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

```bash
# 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