coolify-manager — Claude Code skill: manage Coolify
A skill for running Coolify through its official CLI and API: service status, logs, containers, SSL, WordPress fixes.
npx skills add ajmcclary/Coolify-Manager --skill coolify-manager -a claude-codeWhat coolify-manager does
This skill hands the agent a set of workflows for Coolify. It checks service and application status, reads logs, starts and stops containers and databases, edits environment variables, and triggers deployments. When the CLI can't do something, the skill falls back to direct REST API calls.
Two scripts ship with it. scripts/install_coolify_cli.sh puts the CLI in ~/.local/bin/coolify, and scripts/check_health.sh prints the CLI version, configured contexts, connection status, and available resources. Reference files cover API endpoints and WordPress repairs. You need access to a Coolify instance and an API token from the dashboard at /security/api-tokens, plus the instance URL. No token means no context, and the skill stalls at step one.
Common breakages are handled step by step. If a site goes down after an .htaccess edit, the skill reads the file under /var/www/html/, finds the offending line, and removes it. PHP limits go up with lines like php_value max_input_vars 3000, no = sign. When Site Health reports the REST API as unavailable but the site works, the skill tests the endpoint with curl and tells a false positive from a real failure.
What it helps with
- find out why a Coolify-hosted site stopped responding
- remove a broken line from
.htaccessand bring WordPress back - raise PHP limits for uploads and memory
- tell a false REST API warning from a real one
- read container logs and service status by UUID
Example prompts for the agent
- The site on Coolify returns 500 after an .htaccess edit — fix it
- Check the service status and show me the last container logs
- Raise the PHP upload limits on this WordPress install
How to install coolify-manager
1Skills CLI (Vercel)
npx skills add ajmcclary/Coolify-Manager --skill coolify-manager -a claude-code2Manually: put the files in place
~/.claude/skills/coolify-manager/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/coolify-manager/
1Skills CLI (Vercel)
npx skills add ajmcclary/Coolify-Manager --skill coolify-manager -a codex2Manually: put the files in place
.agents/skills/coolify-manager/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ajmcclary/Coolify-Manager --skill coolify-manager -a cursor2Manually: put the files in place
.cursor/skills/coolify-manager/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ajmcclary/Coolify-Manager coolify-manager2Manually: put the files in place
.github/skills/coolify-manager/SKILL.md1Skills CLI (Vercel)
npx skills add ajmcclary/Coolify-Manager --skill coolify-manager -a gemini-cli2Platform CLI
gemini skills install https://github.com/ajmcclary/Coolify-ManagerManually: put the files in place
.devin/skills/coolify-manager/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ajmcclary/Coolify-Manager --skill coolify-manager -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about coolify-manager
How do I install coolify-manager in Claude?
Run npx skills add ajmcclary/Coolify-Manager --skill coolify-manager -a claude-code. The skill lands at ~/.claude/skills/coolify-manager/SKILL.md.
What does coolify-manager do?
It manages Coolify deployments through the official CLI and API: service status, logs, container start and stop, environment variables, deployments. It also walks through common WordPress problems on Coolify.
What do I need before using it?
Access to a Coolify instance and an API token from the dashboard at /security/api-tokens. Then add a context with coolify context add <context-name> <coolify-url> <api-token> and verify it with coolify context verify.
