skills.rest
cosmicdreams
cosmicdreamsCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

module-dev-starter

Scaffold a Drupal contrib module workspace with DDEV and PHPUnit.

Updated Feb 28, 2026
Search Tags:#composer#phpunit#module scaffolding#workspace setup#drupal#ddev#contrib module
One-click install
npx skills add https://github.com/cosmicdreams/claude-plugins --skill module-dev-starter
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: module-dev-starter
Source: https://github.com/cosmicdreams/claude-plugins/tree/main/drupal-lab/skills/module-dev-starter
Command: npx skills add https://github.com/cosmicdreams/claude-plugins --skill module-dev-starter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ddev, docker, git, python3, sed, grep, find.

What problem does it solve?

It eliminates the repetitive setup work required to create a new Drupal contrib module workspace (directories, Claude docs, and DDEV configuration) so you can start developing and validating changes quickly.

Core Features & Use Cases

  • Scaffold base Claude worktree structure: Runs the generic admin scaffold to initialize the target project layout and core Claude files in an idempotent way.
  • Add Drupal-specific workspace essentials: Creates Drupal-oriented directories (like issue analysis reports and test scaffolding) and appends a Drupal contrib section to the target CLAUDE.md when missing.
  • Provision a ready-to-run DDEV environment: Configures and starts a DDEV Drupal project using the contrib addon, runs poser and symlinks the project, and marks scaffold completion so subsequent sessions stop prompting.
  • Verification and guardrails: After setup, runs ddev phpunit (when configured) and reminds you to keep worktrees/main clean by creating issue worktrees first.
  • Common use case: When you are starting a new Drupal contrib module, this sets up an environment where your tests and Drupal workflows work immediately instead of being assembled manually.

Quick Start

Ask your agent to scaffold a Drupal contrib module project at your chosen target directory using drupal-lab:module-dev-starter.

Frequently Asked Questions about module-dev-starter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a Drupal contrib module development environment with DDEV?▼

Scaffolding a Drupal contrib module environment involves initializing the project structure, configuring DDEV, installing required addons, and symlinking the project to provide a runnable containerized Drupal setup for validation and PHPUnit checks.

What do I need to set up before starting a Drupal contrib module workspace?▼

Before starting a Drupal contrib module workspace setup, you need DDEV, Docker, Git, Python 3, and standard Unix command-line utilities like sed, grep, and find installed and available on your system.

Does this Drupal module scaffolding process include PHPUnit configuration?▼

Yes, the Drupal module scaffolding process includes PHPUnit configuration. After provisioning the DDEV environment, it runs ddev phpunit when configured to ensure your tests and Drupal workflows function immediately.

Can I use this scaffolding tool for existing Drupal contrib modules?▼

This scaffolding tool is designed for new Drupal contrib module kickoffs where you need a Claude-ready project structure plus a runnable containerized Drupal environment, rather than modifying existing modules.

Why does my Drupal DDEV workspace setup keep prompting for initialization?▼

Your Drupal DDEV workspace setup keeps prompting because the scaffold completion marker has not been set. The tool marks scaffold completion after configuring DDEV so subsequent sessions stop prompting.

What is the best way to manage issue worktrees in a Drupal contrib module project?▼

The best way to manage issue worktrees in a Drupal contrib module project is to keep worktrees/main clean by creating issue worktrees first, as recommended by the scaffolding guardrails after setup completes.

Related Skills

Explore More Software Engineering Skills→
cosmicdreamscosmicdreams

ddev

Run Drupal PHP development tools inside DDEV containers.

Community
Intermediate
ddmanyesddmanyes

sp-git-worktrees

Create, navigate, commit, push, and clean up git worktrees.

Community
Intermediate
madsnorgaardmadsnorgaard
45

ddev-expert

Provisions and manages DDEV-based environments for Drupal projects with standard commands.

Community
Advanced
muskie9muskie9

Drupal DDEV Browser Login

Generates a Drush-based one-time login link for a Drupal DDEV environment.

Community
Intermediate