Content
57%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.
The body is highly actionable and well-sequenced, with concrete tool/parameter detail throughout. Its main weaknesses are duplicated pitfall content, missing post-write verification for destructive SQL, and a monolithic structure with no progressive disclosure.
Suggestions
Deduplicate pitfalls: keep them only in "Known Pitfalls" (or only inline per workflow) and cross-reference, to recover token efficiency.
Add an explicit verify step after destructive SQL writes (e.g. re-query the affected rows or wrap multi-statement changes in a transaction with rollback on error) to lift workflow clarity past the destructive-operation cap.
Move the detailed per-workflow parameter reference and/or the Quick Reference table into a separate reference file (e.g. references/tools.md) and link to it from SKILL.md to improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Content is operationally dense and assumes competence, but pitfalls (project_ref format, array syntax, case-sensitive quoting, ERROR 42P01/42883) are restated in both per-workflow "Pitfalls" blocks and the later "Known Pitfalls" section, so it could be tightened. | 3 / 5 |
Actionability | Concrete tool slugs, exact parameter names, filter operators, regex patterns, and error codes give mostly executable guidance; the gap is the absence of worked end-to-end invocation examples. | 4 / 5 |
Workflow Clarity | Numbered "Tool sequence" steps with [Prerequisite]/[Required]/[Optional] tags and a "confirm ACTIVE" checkpoint are clear, but destructive SQL operations (INSERT/UPDATE/DELETE) lack an explicit post-write verification or rollback feedback loop, capping this at 3. | 3 / 5 |
Progressive Disclosure | The file is well-sectioned with a Quick Reference table, but it is a single 233-line monolith with no bundle files; the per-workflow parameter reference and pitfalls are content that could be split into separate reference files. | 3 / 5 |
Total | 13 / 20 Passed |