coolify-deployment

A deployment tool for Coolify, a platform for running applications and services on your own servers.

In plain words
What is it for?
Use it to deploy applications, databases, and services; change environment variables; investigate server or app problems; configure backups; and perform batch updates.
Why use it?
It helps manage deployments, settings, databases, backups, and infrastructure checks in one workflow.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/monkilabs/opencastle/coolify
Any agent
npx skills add monkilabs/opencastle --skill coolify
Clone the repo
git clone --depth 1 https://github.com/monkilabs/opencastle

Made for: Claude Code, Codex.

Per session 63 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 578 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00063 $0.00578
Opus 5 $0.00032 $0.00289
Sonnet 5 $0.00013 $0.00116
Haiku 4.5 $0.00006 $0.00058

Measured 3d ago against content hash cf33f8d5bbeb, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

coolify-deployment scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (config.ts), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- Deploy webhook (outside MCP): `curl -H "Authorization: Bearer $COOLIFY_TOKEN" "$COOLIFY_URL/api/v1/deployments/deploy?tag=v1.2.3"` (or `?uuid=<app-uuid>`).
src/orchestrator/plugins/coolify/SKILL.md · 31 lines

How it starts

The opening of the file, as written. The whole thing — 31 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Coolify Deployment

Resource hierarchy: Server → Project → Environment → app/database/service. Start every session with get_infrastructure_overview.

MCP tools

  • diagnose_app / diagnose_server accept names, domains, or IPs — not just UUIDs. find_issues scans all infrastructure.
  • Env var changes need a restart to take effect: env_varscontrol action="restart". bulk_env_update sets one key across many UUIDs.
  • deploy force_rebuild=true only when cache corruption is suspected; plain deploys are faster.
  • Responses carry HATEOAS _actions naming the next tool call and args — follow them instead of guessing.
  • Deploy webhook (outside MCP): curl -H "Authorization: Bearer $COOLIFY_TOKEN" "$COOLIFY_URL/api/v1/deployments/deploy?tag=v1.2.3" (or ?uuid=<app-uuid>).
  • Databases supported: PostgreSQL, MySQL, MariaDB, MongoDB, Redis, KeyDB, ClickHouse, Dragonfly. Backups: database_backups action="create" with cron frequency + retention.

Docker Compose gotchas

  • Raw mode (pasted YAML) forbids build: and external file mounts — use image: plus inline content: volumes. Repository mode (git URL) allows the full spec.
  • Magic variables: declare with the port, reference without it. SERVICE_URL_APP_3000 activates proxy routing; $SERVICE_URL_APP injects the URL. Hyphenate before the port — SERVICE_URL_MY-SERVICE_3000, never SERVICE_URL_MY_SERVICE_3000. Requires Coolify ≥ v4.0.0-beta.411.
  • Reusing the same SERVICE_PASSWORD_X identifier in two services yields the same generated value.
  • Delete ports: for proxied services; Traefik routes via SERVICE_URL_NAME_PORT.
  • VAR=value is hidden from the UI, ${VAR} is UI-editable, ${VAR:?} blocks the deploy when empty.
  • Label init/migration containers exclude_from_hc=true to keep them out of health checks.
  • Volume is_directory: true makes Coolify create a missing directory.
  • "No Available Server" usually means an unhealthy container — check docker ps.

Docs: https://coolify.io/docs

Read the full file on GitHub · 31 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 31 lines · 63 tokens per session scan A cf33f8d5bbeb

Subscribe to this mod's changes

coolify-deployment is a skill published in the GitHub repository monkilabs/opencastle (61 stars, last pushed 5d ago), licensed MIT. It adds 63 tokens to every session and 578 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

deploying-scalable-agents

Take a working agent prototype to a scalable, observable production deployment on Microsoft Foundry. Covers deployment patterns (client-hosted, hosted agents, agent workflows), the agent lifecycle, model routing, response caching, evaluation gates, human-in-the-loop approval, observability with OpenTelemetry, cost…

microsoft/ai-agents-for-beginners · 197 tokens

k8s-cost-visibility

Estimate Kubernetes infrastructure costs by querying cluster node, pod, PVC/PV, and LoadBalancer data, applying cloud pricing models, and producing cost attribution reports with storage and LoadBalancer cost tracking, grouped by namespace, workload, node, label, or annotation.

initializ/forge · 58 tokens

product-architect

Complete product development system with 64 agents and 35 frameworks. Use when the user wants to build a product, write a PRD, plan an MVP or roadmap, design an app, research a market or check whether a feature already exists or is novel, do competitive analysis, run a security audit, build a financial model, plan…

ankitjha67/product-architect · 211 tokens

production-observability

Use when adding service-wide Spring Boot 3 Actuator, Micrometer metrics, distributed tracing, OpenTelemetry export, structured logging, health probes, dashboards, or alerts. Combine with ai-observability only for Spring AI-specific token, prompt, and model telemetry.

rrezartprebreza/spring-boot-skills · 58 tokens

codex-delegation

Use when a coding task would benefit from delegating work to Codex in the background — a deep independent second opinion, security or architecture analysis, or a parallel implementation running while the session continues. Lets Claude drive the codex companion itself (task, review, status --wait, result) without the…

zebbern/agent-collab · 74 tokens

cursor-delegation

Use when a coding task would benefit from delegating work to Cursor in the background — fast parallel implementation, scaffolding, or an everyday review running while the session continues. Lets Claude drive the cursor companion itself (task, review, status --wait, result) without the user typing /cursor: commands.

zebbern/agent-collab · 66 tokens