Content
76%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.
A concise, well-organized orchestration skill that correctly defers the full procedure to a canonical recipe and preserves a clear sequencing/ordering structure with verification and escalation callouts. Its main weakness is actionability: the body holds no executable commands, relying entirely on the external recipe for the concrete steps.
Suggestions
Include 1-2 copy-paste-ready command stubs for the highest-risk step (e.g. the pg_dump/pg_restore invocation through the proxy) so the skill is minimally actionable even before opening the recipe.
Mirror the recipe's verification check explicitly as a short in-body checkpoint (e.g. the command used to confirm the restored DB is queryable) to satisfy the destructive/batch feedback-loop expectation within the skill itself.
Either bundle the recipe under references/ (and link to that bundled path) or add a one-line pointer clarifying where the canonical recipe lives relative to the repo root, so navigation is unambiguous when the skill is invoked outside its home directory.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence—'Do not restate the procedure from memory. Follow the recipe.' and 'Keep the skill focused on orchestration and verification, not duplicating the full runbook.'—with every line earning its place and no padding. It is a 5 rather than 4 because there is no over-explanation to trim; it deliberately offloads detail to the recipe. | 5 / 5 |
Actionability | Guidance is concrete in intent (names the canonical recipe, lists specific sub-tasks like 'URL rewriting', 'extension precreation', 'restore verification', and names a specific file 'docker-compose.restore-test.yaml') but provides no executable commands or copy-paste steps in-body. It is a 3 because the actionable specifics live in the external recipe rather than here, and not a 4 (which requires mostly executable code/commands) since the body is explicitly instruction-only with the actual commands deferred. | 3 / 5 |
Workflow Clarity | A clear orchestration sequence is present: canonical recipe handles proxy/URL rewrite/pg_dump/pg_restore/extension precreation/restore verification/startup, with an explicit ordering constraint ('Use docker-compose.restore-test.yaml only after the recipe has created the restored database container') and a verification reference plus an escalation callout. It is a 4 rather than 5 because the in-body feedback-loop/validation detail is referenced rather than spelled out, and a 4 rather than 3 because checkpoints (restore verification, post-container ordering) are explicitly named. | 4 / 5 |
Progressive Disclosure | Well-structured single-level reference: a concise overview points to one canonical recipe via a clearly signaled markdown link, with the body retaining only orchestration/navigation guidance in labeled sections. It is a 4 rather than 5 because the skill keeps all detail behind one external path outside the bundle and the recipe is not a bundled file under references/, leaving minor navigation gaps; it is a 4 rather than 3 because structure and signaling are clear and references are not buried. | 4 / 5 |
Total | 16 / 20 Passed |