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.
The body is a well-structured, highly actionable guide: executable SQL throughout, a clearly sequenced workflow with validation checkpoints and error-recovery feedback loops, and a sensible split of the verbose parameter reference into a single one-level-deep file. The only mild weakness is length — some explanatory prose could be tightened to improve token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and information-rich — rules, tables, and executable SQL dominate with minimal padding, and it assumes Claude's competence about Snowflake/SQL/graph concepts. A few explanatory prose passages (e.g., the orientation rationale and some privilege-mode narrative) could be trimmed slightly without losing value, keeping it just below a 5. | 4 / 5 |
Actionability | Provides copy-paste-ready SQL CALL examples with full project/compute/write config, exact casting rules, real procedure names, and complete privilege-grant scripts covering both auth modes plus rotation/rollback. Placeholders like <user_name> are appropriately templated, and common cases are covered. | 5 / 5 |
Workflow Clarity | A clear 4-step sequence (Explore → Prepare projection views → Project-Compute-Write → Inspect) is explicitly sequenced with a STOP checkpoint for collecting the PAT secret, a Checklist, and a detailed Troubleshooting table mapping errors to fixes that serves as error-recovery feedback loops for these batch/write operations. | 5 / 5 |
Progressive Disclosure | SKILL.md acts as an overview with algorithm tables and the core flow, while the bulk per-algorithm compute/write parameter reference is correctly split into the one-level-deep references/algorithms.md, explicitly signaled with a link. The body is fairly long with auth-mode SQL and algorithm notes inlined, but that is appropriate core content rather than material that clearly belongs in a separate file, so it is just shy of a 5. | 4 / 5 |
Total | 18 / 20 Passed |