Content
72%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |