Content
83%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 an exemplary lean quick-reference: fully executable SQL, dense tables instead of prose, and no filler. Its one substantive weakness is the absence of validation checkpoints around its riskier guidance (ALTER SYSTEM, REVOKE ALL, queue processing) — per the rubric's scoring notes this caps workflow clarity at 3. Structure and organization are good for a single-file skill of this size.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is almost entirely tables, terse SQL snippets, and one-line explanatory comments (e.g. the index cheat-sheet table, "-- SELECTでラップ!", "-- O(1) vs OFFSET は O(n)") with zero space spent explaining what PostgreSQL is or how basic concepts work. This matches anchor 5 ("Lean and efficient; assumes Claude's competence; every token earns its place"); the one-line intro and trailing attribution are minimal and do not constitute the padding that would drop it to 4. | 5 / 5 |
Actionability | Every pattern is copy-paste-ready executable SQL: index DDL per query pattern, a complete antipattern-detection query set against pg_constraint/pg_stat_statements/pg_stat_user_tables, a working FOR UPDATE SKIP LOCKED queue UPDATE, an ON CONFLICT upsert, and ALTER SYSTEM config templates. This matches anchor 5 ("Fully executable; copy-paste ready code or commands; specific examples cover the common cases"); it is not 4 because the snippets are complete rather than having minor gaps — table aliases like `t` are placeholders, not missing detail. | 5 / 5 |
Workflow Clarity | This is a lookup/reference skill rather than a multi-step workflow, and the sections are individually unambiguous, but it includes database operations with no validation or verification checkpoints: `ALTER SYSTEM SET max_connections/work_mem`, `REVOKE ALL ON SCHEMA public`, and the queue-processing UPDATE are applied with no "verify first" step (e.g. EXPLAIN before indexing, pg_reload_conf/testing before config changes). The scoring notes list database operations as a context where missing feedback loops cap workflow_clarity at 3, and that cap takes precedence over the simple-skill exception, so this is 3 ("Steps listed but validation gaps") rather than 4 or 5. | 3 / 5 |
Progressive Disclosure | The single-file body (~140 lines) is well organized with clear section headers (quick reference tables, patterns, antipattern detection, config templates, related resources) and no nested or dead references — the `database-reviewer`, `clickhouse-io`, and `backend-patterns` pointers are cross-links to agents/skills, not broken file paths. This fits anchor 4 ("Good structure; most content is appropriately placed; minor organization gaps"); it is not 5 because at this length the antipattern-detection queries and config templates are plausible candidates for separate reference files, and not 3 because nothing is badly buried or misfiled. | 4 / 5 |
Total | 17 / 20 Passed |