Use this skill when designing or reviewing a PostgreSQL-specific schema. Covers best-practices, data types, indexing, constraints, performance patterns, and advanced features
58
66%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/database-design/skills/postgresql/SKILL.mdQuality
Discovery
67%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description has a clear 'Use when' clause and identifies the domain well (PostgreSQL schema design/review), which is a strength. However, it lists topic categories rather than concrete actions, and misses common trigger term variations like 'Postgres' or 'database design'. The description would benefit from more specific action verbs and broader keyword coverage.
Suggestions
Replace category listings with concrete actions, e.g., 'Designs table structures, selects appropriate data types, creates indexes, defines constraints and foreign keys, optimizes query performance'.
Add common trigger term variations such as 'Postgres', 'database design', 'table structure', 'DDL', 'migrations', 'CREATE TABLE', and 'database schema'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (PostgreSQL schema) and lists several areas it covers (data types, indexing, constraints, performance patterns, advanced features), but these are categories rather than concrete actions. It doesn't list specific actions like 'create indexes', 'define foreign keys', or 'normalize tables'. | 2 / 3 |
Completeness | Explicitly answers both 'what' (covers best-practices, data types, indexing, constraints, performance patterns, advanced features) and 'when' ('Use this skill when designing or reviewing a PostgreSQL-specific schema'). The 'Use when' clause is present and clear. | 3 / 3 |
Trigger Term Quality | Includes 'PostgreSQL', 'schema', 'indexing', 'constraints', and 'data types' which are relevant keywords. However, it misses common user variations like 'Postgres', 'database design', 'table structure', 'migrations', 'DDL', or '.sql files'. | 2 / 3 |
Distinctiveness Conflict Risk | The PostgreSQL-specific qualifier helps distinguish it from general database skills, but terms like 'performance patterns' and 'advanced features' are vague enough to potentially overlap with general database optimization or query tuning skills. Could also conflict with a general SQL skill. | 2 / 3 |
Total | 9 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a comprehensive PostgreSQL schema design reference with strong actionability—concrete SQL examples, specific type recommendations, and clear 'do/don't' guidance. Its main weaknesses are length (could benefit from splitting into focused sub-files) and lack of explicit design workflows with validation steps. The content is valuable but reads more as an exhaustive reference document than a focused, workflow-oriented skill.
Suggestions
Split detailed reference sections (Data Types, JSONB Guidance, Extensions, Indexing) into separate referenced files to improve progressive disclosure and reduce the main skill's token footprint.
Add a schema design workflow/checklist at the top (e.g., '1. Identify entities → 2. Normalize to 3NF → 3. Define constraints → 4. Add indexes for query patterns → 5. Validate with EXPLAIN') with explicit validation steps.
Trim the Data Types section by removing types Claude already knows well (geometric, network) or condensing them to one-liners, keeping focus on PostgreSQL-specific gotchas and recommendations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is dense and mostly avoids explaining concepts Claude already knows, but it's quite long (~300+ lines) and some sections could be tightened. The data types section is exhaustive to the point of being a reference manual rather than a focused skill. Some items like explaining what TOAST is or what geometric types are add marginal value. However, most content is genuinely useful PostgreSQL-specific knowledge. | 2 / 3 |
Actionability | The skill provides concrete, executable SQL examples throughout—CREATE TABLE statements, CREATE INDEX commands, specific syntax for constraints, partitioning, JSONB indexing, and generated columns. The examples section at the end gives copy-paste-ready table definitions. Guidance is specific (e.g., 'use BIGINT GENERATED ALWAYS AS IDENTITY', 'add GIN index for JSONB containment') rather than vague. | 3 / 3 |
Workflow Clarity | The skill covers many topics but lacks explicit multi-step workflows with validation checkpoints. The 'Safe Schema Evolution' section hints at workflows (transactional DDL, concurrent index creation) but doesn't provide a clear step-by-step process with validation gates. For a schema design skill, there's no 'design review checklist' or ordered process for going from requirements to schema. The content reads more as a reference than a guided workflow. | 2 / 3 |
Progressive Disclosure | The content is well-organized with clear headers and logical grouping, but it's a monolithic document with no references to external files. Given its length and breadth (data types, indexing, partitioning, JSONB, extensions, etc.), splitting detailed sections like JSONB guidance, data types reference, or extensions into separate files would improve navigability. For a skill this comprehensive, the single-file approach creates a wall of text. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
112197c
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.