Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a high-quality skill file that excels in actionability and workflow clarity, with concrete CLI commands, executable scripts, clear multi-step workflows with validation checkpoints, and appropriate warnings for destructive operations. The progressive disclosure is well-structured with clear references to supporting files. The main area for improvement is conciseness—the troubleshooting table, comparison table, and some inline details could potentially be moved to reference files to reduce the token footprint of the main skill.
Suggestions
Consider moving the detailed troubleshooting table and the Provisioned vs Autoscaling comparison table to reference files to reduce the main skill's token footprint while keeping a brief summary inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is generally efficient and avoids explaining basic concepts Claude already knows (e.g., what Postgres is), but it's quite long (~300+ lines) with some sections that could be tightened—like the capabilities bullet list, the provisioned vs autoscaling comparison table, and the detailed troubleshooting table that could live in a reference file. The inline content is mostly justified but borders on verbose for a top-level skill file. | 2 / 3 |
Actionability | Excellent actionability throughout: concrete CLI commands with exact flags, executable bash scripts for connecting to Postgres, specific JSON paths for extracting values, SQL examples for grants and extensions, and a scriptable single-copy-paste version for agents. Commands are copy-paste ready with clear placeholder conventions. | 3 / 3 |
Workflow Clarity | Multi-step workflows are clearly sequenced with explicit validation and checkpoints. The create-project flow includes verification steps, the schema permissions section has a clear 'deploy first' workflow with error recovery paths (options A and B), the SQL connection workflow is numbered with dependencies between steps, and destructive operations (delete, drop schema) have explicit warnings and user-consent requirements. | 3 / 3 |
Progressive Disclosure | The skill provides a clear overview with well-signaled one-level-deep references to six reference files (computes-and-scaling.md, connectivity.md, synced-tables.md, lakehouse-sync.md, pgvector.md, off-platform.md). It also references the parent databricks-core skill and the databricks-apps skill appropriately. The main file contains enough to be actionable for common tasks while deferring detailed topics to reference docs. | 3 / 3 |
Total | 11 / 12 Passed |