Drupal Deploy Safety

Things that pass locally and then break, or silently lose data, on a Drupal deploy. Use when planning or running a deploy, writing a hook_update_N / post-update / deploy hook, running drush updb / updatedb / config:import / drush deploy on a remote environment, a site is stuck in maintenance mode after a failed or killed update, adding a column to a custom_field field, an update hook talks to an external API (payment provider, cloud, SaaS), changing a service constructor or *.services.yml / drush.services.yml arguments, a Drush command is missing from drush list, or committing vendor/ for a ho

84 stars 5 forksDevOps & Cloud

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add grasmash/drupal-claude-skills --skill drupal-deploy-safety
Manual install
git clone --depth 1 https://github.com/grasmash/drupal-claude-skills.git /tmp/drupal-claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/drupal-claude-skills/skills/drupal-deploy-safety ~/.claude/skills/drupal-deploy-safety

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Drupal Deploy Safety

Most deploy failures are not bugs in the feature. The code works on the
developer's machine. It breaks during the trip to production: the order of
operations, a process that gets killed halfway, a hook that runs once per
database, or a file that never made it into the commit. Each section below
covers one way this happens, why it happens, how to detect it, and the guard.

Commands use `drush @<alias>`. For the Acquia / Terminus / Platform.sh / Upsun /
Lagoon equivalents, see the Remote CLI table in the `drupal-config-mgmt` skill.

Verified against: Drupal core 11.4, Drush 13.7, `drupal/custom_field` 4.0.8,
Composer 2.x.

## When This Skill Activates

- Planning how a change reaches production, or running a deploy tail
- Writing `hook_update_N()`, `hook_post_update_NAME()`, or a Drush deploy hook
- A site stays in maintenance mode after `updb` failed or was killed
- Adding a property/column to a `custom_field` field that already has data
- An update hook writes to something outside the Drupal database
- Changing a constructor that `*.services.yml` or `drush.services.yml` wires
- A custom Drush command is missing from `drush list`
- Committing `vendor/` for a host that deploys git state

---

## 1. Deploy is not a code push

Merging is not deploying. Pushing code to a host changes the PHP files, but on
most hosts it does not change the database or the active config. For every
change that alters DB state, config, or runtime behaviour, answer one question
Read the full skill on GitHub

Details

Skill name
drupal-deploy-safety
Path
skills/drupal-deploy-safety/SKILL.md
License
MIT
Repo updated
1 October 2026

FAQ

What does the Drupal Deploy Safety skill do?

Things that pass locally and then break, or silently lose data, on a Drupal deploy. Use when planning or running a deploy, writing a hook_update_N / post-update / deploy hook, running drush updb / updatedb / config:import / drush deploy on a remote environment, a site is stuck in maintenance mode after a failed or killed update, adding a column to a custom_field field, an update hook talks to an external API (payment provider, cloud, SaaS), changing a service constructor or *.services.yml / drush.services.yml arguments, a Drush command is missing from drush list, or committing vendor/ for a ho

How do I install the Drupal Deploy Safety skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add grasmash/drupal-claude-skills --skill drupal-deploy-safety. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Drupal Deploy Safety popular?

It lives in grasmash/drupal-claude-skills, which has 84 GitHub stars and 5 forks.

Related skills

Acquia Source

84

grasmash/drupal-claude-skills

Connect to an Acquia Source ("Source powered by Drupal CMS") site — its JSON:API and MCP endpoints, OAuth2 auth, the @drupal-canvas CLI, and the Canvas Page API deploy workflow. Use when wiring an AI agent or app to a Source CMS site, building/uploading Drupal Canvas Code Components, deploying landing pages via the Page API, or registering the Source MCP server with Claude Code/Cursor.

Frontend & Design

Canvas Contribution

84

grasmash/drupal-claude-skills

Workflow for contributing features and fixes to the Drupal Canvas module on drupal.org while consuming it from a separate project: the two-repository setup, Canvas UI development, issue forks, merge requests, and composer patches. Use when developing a Canvas feature or bug fix intended for upstream, or when moving a local Canvas change onto a drupal.org issue. Extends drupal-contrib-mgmt with Canvas-specific details.

Frontend & Design

Claude Code MCP Setup

84

grasmash/drupal-claude-skills

Add and configure MCP (Model Context Protocol) servers in Claude Code. Use when adding new MCP servers, configuring remote MCP, setting up OAuth MCP servers, troubleshooting MCP connections, or running /mcp diagnostics. Covers stdio, HTTP, and SSE transport types.

AI, LLMs & Agents

Insforge

47

InsForge/insforge-skills

Use this skill when writing app code with InsForge or @insforge/sdk: database CRUD, auth, storage uploads/storage RLS, functions, OpenRouter AI, realtime, emails, Stripe or Razorpay payments, or pointing S3-compatible tooling (aws CLI, AWS SDKs, rclone, Terraform, boto3) at InsForge Storage. Trigger on requests like add auth, fetch data, upload files, make a bucket public, add checkout, sell subscriptions, or send email. For infrastructure, SQL migrations, CLI commands, or payment provider setup, use insforge-cli instead.

DevOps & Cloud13

Drupal Config Reconcile

84

grasmash/drupal-claude-skills

Reconcile Drupal configuration drift between a working tree and a deployed environment one item at a time, deciding import (disk wins) vs export (DB wins) vs skip for each difference. Use when `drush config:status` shows drift, after pulling a fresh DB, before a deploy, or when local config and a remote/prod environment disagree. Pantheon/Terminus-aware but works with any remote alias; never writes to production.

DevOps & Cloud

R00 Borghei Claude Skills Devops

49

RollerRemember/r14-borghei-claude-skills-devops

☁️ DevOps & Cloud Infrastructure skill suite derived from borghei/Claude-Skills. CI/CD pipelines, container orchestration, IaC, monitoring and incident response. Provides 10 specialised commands for devops, cloud, docker workflows.

DevOps & Cloud

Browse the most popular Claude skills, all devops & cloud skills, or write your own with the skills generator.