#601

Global Rank · of 601 Skills

coolify AI Agent Skill

View Source: oakoss/agent-skills

Critical

Installation

npx skills add oakoss/agent-skills --skill coolify

48

Installs

Coolify

Overview

Coolify is a self-hosted PaaS (Vercel/Netlify alternative) that deploys applications, databases, and services on your own infrastructure. It provides a REST API for programmatic control, supports multiple build packs, and uses Traefik for reverse proxy and SSL.

When to use: Deploying applications to self-hosted infrastructure, managing databases and services through API, automating deployments via CI/CD, self-hosting without vendor lock-in.

When NOT to use: Initial Coolify server installation (use the official install script via browser), managing Coolify's own infrastructure (Postgres, Redis — managed internally), or when a managed platform (Vercel, Railway) meets your needs without self-hosting requirements.

Quick Reference

Pattern Approach Key Points
API auth Authorization: Bearer <token> header Token created in dashboard, scoped permissions
List applications GET /api/v1/applications Returns all apps with status and config
Trigger deploy GET /api/v1/deploy?uuid=<app>&force=true Or use per-app webhook URL
Create application POST /api/v1/applications/public Requires project_uuid, server_uuid, env_name
Update application PATCH /api/v1/applications/<uuid> Accepts build, health check, domain, limit fields
Auto-deploy Enable in Advanced > General Deploys on every push to configured branch
Webhook deploy curl GET <webhook_url> -H "Authorization: Bearer ..." Controlled deploys from CI pipelines
GitHub Actions deploy Build image, push to registry, trigger webhook Full control over build + test before deploy
Nixpacks build Auto-detected from source code Zero-config for supported languages
Dockerfile build Set build pack to dockerfile Full control over build process
Compose build docker-compose.yaml as source of truth Multi-service stacks with Coolify labels
Environment variables API or dashboard per-environment Interpolated in Compose via ${VAR} syntax
Domain routing fqdn field or Traefik labels in Compose Automatic SSL via Let's Encrypt
Health checks Configurable path, interval, retries via API Required for running:healthy status

Common Mistakes

Mistake Correct Pattern
API returns "Unauthenticated" Add Accept: application/json header alongside Bearer token
Can't read sensitive fields (auto-deploy, etc.) Token needs view:sensitive or * permission scope
Auto-deploy not triggering Verify GitHub App is connected and auto-deploy enabled in Advanced
Using API token without deploy permission Token needs explicit deploy permission to trigger deployments
Health check fails on Compose services Add exclude_from_hc: true label for non-HTTP services
Webhook deploy without auth header Always include Authorization: Bearer <token> with webhook calls
Environment variables not available in build Use build arguments in Advanced menu, not runtime env vars
Compose services can't communicate Use service names as hostnames within the same stack network

Delegation

  • API exploration: Use Explore agent to discover existing Coolify resources
  • Dockerfile optimization: Use Task agent to review Dockerfiles for Coolify deployment
  • CI/CD pipeline design: Use Plan agent for deployment workflow strategy

If the docker skill is available, delegate Dockerfile authoring, multi-stage builds, and image optimization to it.
If the github-actions skill is available, delegate workflow syntax and CI pipeline patterns to it.
If the ci-cd-architecture skill is available, delegate deployment strategy and environment promotion to it.

References

Installs

Installs 48
Global Rank #601 of 601

Security Audit

ath Safe
socket Safe
Alerts: 0 Score: 90
snyk High
EU EU-Hosted Inference API

Power your AI Agents with the best open-source models.

Drop-in OpenAI-compatible API. No data leaves Europe.

Explore Inference API

GLM

GLM 5

$1.00 / $3.20

per M tokens

Kimi

Kimi K2.5

$0.60 / $2.80

per M tokens

MiniMax

MiniMax M2.5

$0.30 / $1.20

per M tokens

Qwen

Qwen3.5 122B

$0.40 / $3.00

per M tokens

How to use this skill

1

Install coolify by running npx skills add oakoss/agent-skills --skill coolify in your project directory. Run the install command above in your project directory. The skill file will be downloaded from GitHub and placed in your project.

2

No configuration needed. Your AI agent (Claude Code, Cursor, Windsurf, etc.) automatically detects installed skills and uses them as context when generating code.

3

The skill enhances your agent's understanding of coolify, helping it follow established patterns, avoid common mistakes, and produce production-ready output.

What you get

Skills are plain-text instruction files — not executable code. They encode expert knowledge about frameworks, languages, or tools that your AI agent reads to improve its output. This means zero runtime overhead, no dependency conflicts, and full transparency: you can read and review every instruction before installing.

Compatibility

This skill works with any AI coding agent that supports the skills.sh format, including Claude Code (Anthropic), Cursor, Windsurf, Cline, Aider, and other tools that read project-level context files. Skills are framework-agnostic at the transport level — the content inside determines which language or framework it applies to.

Data sourced from the skills.sh registry and GitHub. Install counts and security audits are updated regularly.

EU Made in Europe

Chat with 100+ AI Models in one App.

Use Claude, ChatGPT, Gemini alongside with EU-Hosted Models like Deepseek, GLM-5, Kimi K2.5 and many more.

Start for free View pricing
Customer Support