CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

coolify-deployment

Deploys and manages apps, databases and services on a self-hosted Coolify instance, with env vars, diagnostics and batch operations. Use when deploying to Coolify, debugging a Coolify deployment, or managing its servers.

67

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

72%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exceptionally lean, high-density reference of non-obvious Coolify gotchas with concrete tool calls and a ready-to-use webhook command. Its main weakness is workflow clarity: batch and destructive operations lack explicit validation/verification checkpoints, which the rubric caps at 3, and one inline version pin works against perfect conciseness.

Suggestions

Add a validation checkpoint after deploys and batch env updates (e.g., verify app health via `diagnose_app` or the response's `_actions` before considering the operation done), which would lift workflow_clarity past the batch-operation cap.

Show one complete MCP invocation example with full argument shape (e.g., a `bulk_env_update` or `deploy` call) so guidance is fully copy-paste ready.

Move the "Requires Coolify ≥ v4.0.0-beta.411" constraint into a clearly labeled compatibility/version note so time-sensitive information is isolated from the evergreen guidance.

DimensionReasoningScore

Conciseness

The body is dense, gotcha-driven, and assumes Claude's competence (e.g., "Raw mode... forbids `build:` and external file mounts"), with no padding or explanations of known concepts. Not 5 because the time-sensitive version pin "Requires Coolify ≥ v4.0.0-beta.411" sits inline rather than in a deprecated/old-patterns section, which the rubric penalizes.

4 / 5

Actionability

Gives concrete tool calls with arguments (`env_vars` → `control action="restart"`, `database_backups action="create"` with cron `frequency` + `retention`) and a copy-paste-ready curl webhook command. Not 5 because complete MCP invocation examples are absent — e.g., no full call syntax or argument shape for `deploy`, `diagnose_app`, or `bulk_env_update`, leaving minor gaps.

4 / 5

Workflow Clarity

An entry point exists ("Start every session with `get_infrastructure_overview`") and the env-var change sequence is ordered, but the skill explicitly covers batch and destructive operations (`bulk_env_update`, restarts, deleting `ports:`) with no validate-then-verify loop after deploys or batch updates. Per the rubric's cap, batch/destructive workflows without validation steps cannot score above 3; the single error-recovery hint ("check `docker ps`") is not a general checkpoint.

3 / 5

Progressive Disclosure

At ~25 lines with no bundle files (references/, scripts/, assets/ absent) and no need for external references, the skill qualifies for the simple-skill exception: well-organized sections (MCP tools, Docker Compose gotchas) plus a single external docs link make navigation trivial.

5 / 5

Total

16

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description in third-person voice with concrete capabilities and an explicit, naturally worded trigger clause. Coverage of capabilities is good but slightly narrower than the skill body, and a few natural synonyms are absent.

DimensionReasoningScore

Specificity

Lists several concrete actions — "Deploys and manages apps, databases and services", "env vars, diagnostics and batch operations" — going well beyond the 1-2 actions of a score-3 anchor. Not 5 because body topics like Docker Compose gotchas, backups, and deploy webhooks are absent from the description, leaving minor coverage gaps.

4 / 5

Completeness

Explicitly answers both questions: the "what" ("Deploys and manages apps, databases and services... with env vars, diagnostics and batch operations") and a concrete "Use when deploying to Coolify, debugging a Coolify deployment, or managing its servers" trigger clause, matching the score-5 anchor pattern.

5 / 5

Trigger Term Quality

Triggers use natural phrasing users would say: "deploying to Coolify", "debugging a Coolify deployment", "managing its servers". Not 5 because common variations such as "self-hosted", "redeploy", "restart", or "add a database" are missing; not 3 since the terms present are specific and natural rather than generic.

4 / 5

Distinctiveness Conflict Risk

"self-hosted Coolify instance" carves out a clear niche and every trigger names Coolify explicitly, so it is unlikely to fire for unrelated deployment or database skills — minimal conflict risk per the score-5 anchor.

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

monkilabs/opencastle

Path

src/orchestrator/plugins/coolify/skills/coolify-deployment/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.