Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, highly actionable skill that provides comprehensive guidance for converting Docker Compose files to Coolify templates. Its greatest strengths are the concrete before/after examples, clear conversion checklist, and practical troubleshooting table. The main weakness is length — at ~300 lines the body content could benefit from moving some reference material (health check patterns, env var syntax) into the referenced files to improve progressive disclosure.
Suggestions
Move the 'Health Check Patterns' and 'Environment Variable Syntax' sections into reference files (e.g., references/health-checks.md) and link to them, keeping the main SKILL.md as a tighter overview
Consolidate the two deployment mode sections — the feature comparison tables and 'Which Mode to Use?' table have overlapping information that could be merged into a single decision table
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is generally efficient and avoids explaining basic Docker Compose concepts, but it's quite long (~300 lines) with some redundancy. The deployment modes section has overlapping tables, and some patterns (like the config file mounting) are shown twice across sections. The feature comparison tables for raw vs repository mode could be consolidated. | 2 / 3 |
Actionability | Excellent actionability throughout. Every section provides concrete, copy-paste-ready YAML examples with clear before/after comparisons. The conversion checklist gives specific steps with executable code, the magic variables reference includes exact syntax, and the troubleshooting table maps problems to specific solutions. | 3 / 3 |
Workflow Clarity | The conversion checklist (steps 0-6) provides a clear, sequenced workflow for converting compose files. The decision trees for deployment mode selection and example selection serve as effective validation checkpoints. The 'Declaration vs Reference (Critical)' section explicitly calls out a common error point with clear correct/incorrect examples. | 3 / 3 |
Progressive Disclosure | The skill references external files (references/magic-variables.md, references/categories.md, examples/simple/, examples/with-database/, examples/multi-service/) which is good structure, but no bundle files were provided to verify these exist. The main SKILL.md itself is quite long and some content (like the full health check patterns and environment variable syntax sections) could potentially be moved to reference files to keep the overview leaner. | 2 / 3 |
Total | 10 / 12 Passed |