Agent Skill for Warden – a Docker-based local development environment wrapper for PHP applications (Magento, Laravel, Symfony, WordPress, Drupal, and more).
# Via skills CLI
npx skills add wardenenv/ai-skills
# Or via npm
npm install @wardenenv/ai-skillsTeaches AI agents how to:
- Initialize and manage Warden environments
- Import/export databases (including
pv | gzip -d | warden db importpattern) - Run shell commands, debugging (Xdebug), and profiling (Blackfire, SPX)
- Manage global services (Traefik, DNS, Mailpit)
- Troubleshoot common issues (DNS, SSL, Xdebug, sync)
- Map
.envvariables to services and generate configuration tables
| Task | Command |
|---|---|
| Start environment | warden svc up -d && warden env up -d |
| Database import | pv dump.sql.gz | gzip -d | warden db import |
| Interactive MySQL | warden db connect |
| Shell (debugging) | warden debug |
| Shell (normal) | warden shell |
| Preview config | warden env config |
Releases are automated via Conventional Commits. Merge a PR with feat: or fix: commits to trigger a new version and npm publish.
-
npm access token
- Create at npmjs.com under the org/user that owns
@wardenenv - Type: Automation, enable "Bypass two-factor authentication (2FA)"
- Add as GitHub secret:
NPM_TOKEN
- Create at npmjs.com under the org/user that owns
-
GitHub PAT for release
- Create a Personal Access Token (classic:
reposcope, or fine-grained:Contents+Metadata= Read and write) - Add as GitHub secret:
RELEASE_TOKEN - Branch protection: If
mainis protected, add the PAT owner to Settings → Branches → main → Allow specified actors to bypass required pull requests. Otherwise the workflow's direct push will be rejected.
- Create a Personal Access Token (classic:
- Commit with Conventional Commits:
feat(commands): add X,fix(troubleshooting): correct Y - Open PR and merge to
main - CI calculates version, pushes version bump to
main, creates tag (e.g.v1.1.0) - Release workflow publishes to npm and creates GitHub Release
MIT - See LICENSE for details.