$npx -y skills add michtio/craftcms-claude-skills --skill servdServd (servd.host) — Craft-specialised managed hosting for Craft CMS. Covers git push-to-deploy with the optional servd.yaml build config, local → staging → production environments with uni-directional Project Config sync, the servd/craft-asset-storage plugin (S3-backed Flysystem
| 1 | # Servd — Managed Hosting for Craft CMS |
| 2 | |
| 3 | Reference for Servd (servd.host), a Craft-specialised managed hosting platform. Covers git push-to-deploy and the `servd.yaml` build config, the local → staging → production workflow, the `servd/craft-asset-storage` plugin, Servd's static caching (and running Blitz alongside it), databases over SSH, backups, the queue runner, the ephemeral filesystem, and how Servd differs from Craft Cloud. |
| 4 | |
| 5 | This skill is scoped to **Servd specifically** — what's different on Servd vs running Craft yourself on Forge or bare metal, and vs Pixel & Tonic's Craft Cloud. For generic Craft deployment, see the `craftcms` skill's `deployment.md`. For Craft Cloud, see the `craft-cloud` skill. |
| 6 | |
| 7 | ## Companion Skills — Load When Needed |
| 8 | |
| 9 | - **`craftcms`** — When the Servd topic intersects plugin or module PHP (ephemeral-filesystem guards, queue-job design, asset filesystem code). |
| 10 | - **`craft-site`** — When Servd intersects front-end templating (`{% dynamicInclude %}` islands in cached pages, transform usage, CSRF in cached forms). |
| 11 | - **`ddev`** — For local development; Servd has no first-party local environment, so DDEV is the standard local stack. |
| 12 | - **`craft-php-guidelines`** — When editing plugin PHP to add ephemeral-filesystem checks. |
| 13 | |
| 14 | ## Documentation |
| 15 | |
| 16 | Authoritative sources used to write this skill (Servd's own docs): |
| 17 | |
| 18 | - Docs landing: https://servd.host/docs |
| 19 | - The Servd workflow: https://servd.host/docs/the-servd-workflow |
| 20 | - Node build step (servd.yaml): https://servd.host/docs/node-build-step |
| 21 | - Asset volumes & filesystems: https://servd.host/docs/servd-asset-volumes-and-filesystems |
| 22 | - Installing the plugin: https://servd.host/docs/installing-the-servd-plugin |
| 23 | - Static caching: https://servd.host/docs/static-caching |
| 24 | - Caching with Blitz: https://servd.host/docs/caching-with-blitz |
| 25 | - Handling runtime-created files: https://servd.host/docs/handling-runtime-created-files |
| 26 | - Dedicated queue runner: https://servd.host/docs/dedicated-queue-runner |
| 27 | - Backup & restore: https://servd.host/docs/backup-restore |
| 28 | - Plugin console commands: https://servd.host/docs/servd-plugin-console-commands |
| 29 | - Plugin source: https://github.com/servdhost/craft-asset-storage |
| 30 | |
| 31 | Per-claim URLs appear in each reference file. Last verified against the docs on 2026-05-30. Some operational details (cron, exact plan tiers) are not in the public docs and are flagged as **Verify** where they appear. |
| 32 | |
| 33 | ## What's Different on Servd vs Self-Hosted |
| 34 | |
| 35 | Each row is a place self-hosted habits will mislead you. |
| 36 | |
| 37 | | Concern | Self-hosted | Servd | |
| 38 | |---|---|---| |
| 39 | | Config file | `.env`, `config/*.php`, web-server config | **`servd.yaml`** at repo root for the build step (optional; overrides dashboard); platform settings + runtime env vars in the Servd dashboard | |
| 40 | | Deploy | Whatever you've wired | **Git push-to-deploy** (GitHub/GitLab/Bitbucket or any SSH host) → Composer install + optional Node build | |
| 41 | | Environments | Yours to define | Fixed **local → staging → production**, **uni-directional**; `allowAdminChanges` off everywhere except local | |
| 42 | | Filesystem | Local disk | **Ephemeral + load-balanced** — disk writes don't persist; use Redis (Craft data cache) or a remote asset volume | |
| 43 | | Assets | Local or your own S3 config | **`servd/craft-asset-storage`** — S3-backed Flysystem on the `*.files.svdcdn.com` CDN, auto-separated per environment | |
| 44 | | Image transforms | Native / Imager-X / ImageOptimize on-server | **Off-server** transforms via the Servd Asset Platform; Imager-X |