Content
100%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.
Excellent content: lean and dense with environment-specific knowledge the agent cannot infer, fully executable SQL with validation and failure paths built into the workflow, and a clean single-file structure with a required data-handling section. The read-only nature of the task means the permission-error stop path is the correct validation posture.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section carries non-derivable, repo-specific knowledge (synced table names, underscore aliases, sync lag, output rules) with no explanation of concepts Claude already knows; directives like "Do not stop at `system.insights` when the question spans teams" earn their tokens. This matches anchor 5 (lean, every token earns its place); it is not 4 because there is no over-explanation to trim. | 5 / 5 |
Actionability | Three copy-paste-ready SQL blocks (catalog check via system.information_schema, column verification, a full example aggregate query), exact table names for US and EU, explicit `team_id` grouping, join guidance, and the concrete tool name `posthog:execute-sql`. This matches anchor 5 (fully executable, covers the common cases); it is not 4 because no key detail or executable step is missing. | 5 / 5 |
Workflow Clarity | A numbered workflow with a pre-flight validation step ("Confirm columns before projecting — synced schemas drift with the Django models"), explicit failure handling ("If a query fails with a permissions error, report it and stop — do not look for another route"), a catalog-check fallback before declaring data inaccessible, and a sync-lag caveat. This matches anchor 5 (clear sequence, explicit validation, error-recovery paths); it is not 4 because checkpoints and failure behavior are explicit rather than implied. | 5 / 5 |
Progressive Disclosure | No bundle files exist and nothing that belongs in a separate file is inlined; sections are well-organized (Synced tables, Workflow, Output handling, Related) and the one cross-reference (querying-production-databases-via-metabase) is clearly signaled. Per the simple-skill scoring note, a self-contained well-organized SKILL.md matches anchor 5; it is not 4 because there is no organization gap or buried content. | 5 / 5 |
Total | 20 / 20 Passed |