Content
77%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A thorough, highly actionable multi-phase migration workflow with strong validation and error-recovery structure. Its main weakness is conciseness and progressive disclosure: it is a long monolithic file with some tighten-able prose and no external reference split.
Suggestions
Move the git-over-HTTPS and Troubleshooting sections into separate reference files (e.g. references/git-over-https.md, references/troubleshooting.md) and link to them, so the main SKILL.md stays a lean overview.
Trim redundant prose — the opening paragraph rephrases the frontmatter description, and the standalone "Principle" line could fold into the relevant phases or be dropped.
Convert the verbose Troubleshooting paragraphs into a compact cause→fix table to cut tokens while keeping the same actionable content.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely command- and table-dense and assumes competence, but several prose passages (the opening paragraph restating the description, the "Principle" line, and verbose troubleshooting paragraphs) could be tightened without losing clarity. | 2 / 3 |
Actionability | Provides copy-paste-ready, fully executable commands with specific flags, plus mapping tables (env variable → secret type → host pattern) that leave no ambiguity about what to run. | 3 / 3 |
Workflow Clarity | A clearly sequenced five-phase workflow with explicit validation checkpoints (onecli version, secrets list, /health polling, build-fix-restart, log grep) and error-recovery feedback loops; destructive .env edits are guarded with "remove only credential lines, keep others". | 3 / 3 |
Progressive Disclosure | No bundle files exist, so everything is inline in one ~308-line document; well-sectioned, but self-contained chunks like git-over-HTTPS and Troubleshooting could be split into reference files to shorten the main body. | 2 / 3 |
Total | 10 / 12 Passed |