Content
88%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 actionable, well-structured body: executable commands with full JSON payloads, explicit validation checkpoints around destructive operations, and detailed offload of depth to six well-described reference files. The only weaknesses are mild redundancy (drop-schema workflow repeated in two places) and one reference file (medallion-from-cdc.md) that is orphaned from SKILL.md's navigation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious product specifics (500-role limit, NULLIF RLS pattern, pooled-connection '' vs NULL, Data API open defaults) with no basic-concept padding, and the legacy Provisioned material is framed as retired context. Minor trimmable redundancy: the drop-schema recovery workflow appears in both the Schema Permissions section and the Troubleshooting table row, and version-specific details sit outside a deprecated section. Not 5 due to these repeated/could-be-tightened spots; well above 3 since nearly every token carries product knowledge Claude cannot infer. | 4 / 5 |
Actionability | Fully executable throughout: complete CLI commands with --json payloads (create/update/delete project, branches, endpoints), a copy-paste scriptable block extracting HOST/TOKEN via python3, a JSON-path table for connection values, concrete SQL grant sequences, and an exact apps create-update JSON body. Covers the common cases (create, verify, connect, attach to app, grant, troubleshoot). Minor placeholder (<USERNAME>) does not detract from copy-paste readiness. | 5 / 5 |
Workflow Clarity | Multi-step flows are explicitly sequenced with validation: create-project is followed by verify commands (list-branches/endpoints/databases) and an endpoint-size check; the deploy-first workflow is a numbered checklist with grant steps and local-dev validation via has_schema_privilege; RLS testing validates with SET ROLE as a non-BYPASSRLS role. Destructive operations (delete project, drop schema, delete branch) are gated on explicit user permission with export-first recovery options A/B, and the Troubleshooting table provides error-to-fix feedback loops, matching the 5 anchor. Not 4 because checkpoints are explicit rather than mostly present. | 5 / 5 |
Progressive Disclosure | Good structure: SKILL.md is an overview plus core workflows, with a 'Reference docs' block giving one-line descriptions of six real reference files (all verified to exist, including deep-linked anchors), and detail (sizing tables, connection patterns, pgvector, off-platform) correctly split out. Minor gaps keep it below 5: references/medallion-from-cdc.md is not reachable from SKILL.md at all (only via lakehouse-sync.md and synced-tables.md, a 2-level chain), and the synced-table grant workflow is inlined in SKILL.md where it arguably belongs in synced-tables.md. Well above 3 since references are clearly signaled and content is appropriately placed. | 4 / 5 |
Total | 18 / 20 Passed |