CtrlK
BlogDocsLog inGet started
Tessl Logo

postgresql-table-design

Design a PostgreSQL-specific schema. Covers best-practices, data types, indexing, constraints, performance patterns, and advanced features

65

1.27x
Quality

48%

Does it follow best practices?

Impact

92%

1.27x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./tests/ext_conformance/artifacts/agents-wshobson/database-design/skills/postgresql/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

32%

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 identifies a clear domain (PostgreSQL schema design) and lists relevant topic areas, but it reads more like a course syllabus than an actionable skill description. It lacks a 'Use when...' clause, which is critical for Claude to know when to select this skill, and the listed capabilities are categories rather than concrete actions.

Suggestions

Add an explicit 'Use when...' clause with trigger scenarios, e.g., 'Use when the user asks to design database tables, create PostgreSQL schemas, optimize database performance, or mentions Postgres/PostgreSQL schema design.'

Replace category listings with concrete actions, e.g., 'Designs normalized table structures, selects appropriate PostgreSQL data types, creates indexes for query optimization, defines constraints and foreign keys, implements partitioning and advanced PostgreSQL features.'

Include common user-facing trigger terms and variations like 'Postgres', 'database design', 'CREATE TABLE', 'migrations', 'DDL', and 'database modeling'.

DimensionReasoningScore

Specificity

Names the domain (PostgreSQL schema design) and lists several areas it covers (data types, indexing, constraints, performance patterns, advanced features), but these are categories rather than concrete actions. It says 'Design' and 'Covers' but doesn't list specific operations like 'create migration scripts, define foreign key relationships, optimize query performance with partial indexes.'

2 / 3

Completeness

Describes what it does (design PostgreSQL schemas covering various topics) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per the rubric, a missing 'Use when...' clause caps completeness at 2, and since the 'what' is also somewhat vague (listing categories rather than concrete actions), this falls to 1.

1 / 3

Trigger Term Quality

Includes relevant keywords like 'PostgreSQL', 'schema', 'indexing', 'constraints', 'data types', and 'performance patterns' which users might mention. However, it misses common variations like 'database design', 'SQL tables', 'migrations', 'DDL', 'CREATE TABLE', or 'Postgres'.

2 / 3

Distinctiveness Conflict Risk

The PostgreSQL-specific focus provides some distinctiveness, but 'schema design' and 'best-practices, indexing, constraints' could overlap with general database skills, SQL skills, or other RDBMS-specific skills. The lack of explicit trigger conditions increases conflict risk.

2 / 3

Total

7

/

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 and highly actionable PostgreSQL schema design reference with excellent concrete examples and PostgreSQL-specific gotchas that genuinely add value. Its main weaknesses are length (could benefit from splitting into overview + reference files) and lack of explicit validation workflows for schema design processes. The content quality is high but the document tries to be both a quick reference and a deep guide simultaneously.

Suggestions

Split detailed sections (Data Types catalog, JSONB Guidance, Extensions, Partitioning) into separate reference files and link from a leaner SKILL.md overview to improve progressive disclosure.

Add a brief schema design validation workflow or checklist (e.g., 'After designing: 1. Verify FK indexes exist, 2. Run EXPLAIN on expected queries, 3. Check constraint coverage') to improve workflow clarity.

Remove the 'Do not use' section since those recommendations are already stated in the Data Types section above it, reducing redundancy.

DimensionReasoningScore

Conciseness

The skill is mostly efficient and avoids explaining basic concepts Claude already knows, but it's quite long with some areas that could be tightened—e.g., the exhaustive TOAST storage explanation, the full enumeration of geometric types, and some data type entries that repeat information (like the 'Do not use' section restating what was already covered). 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 with exact operator references. The examples section at the end is copy-paste ready and demonstrates real patterns. Guidance is specific (e.g., 'use fillfactor=90', exact GIN opclass names).

3 / 3

Workflow Clarity

The 'Safe Schema Evolution' section provides some workflow guidance with transactional DDL testing, and the insert-heavy/update-heavy sections give ordered recommendations. However, there are no explicit validation checkpoints or feedback loops for schema design processes—e.g., no 'verify your schema with EXPLAIN ANALYZE' step or checklist for reviewing a completed design.

2 / 3

Progressive Disclosure

The content is well-organized with clear section headers and logical grouping, but it's a monolithic document with no references to external files for detailed topics. The JSONB section, extensions list, data types catalog, and partitioning guidance could each be separate reference files linked from a leaner overview. For a skill this long (~250+ lines), inline everything hurts discoverability.

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
Dicklesworthstone/pi_agent_rust
Reviewed

Table of Contents

Is this your skill?

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.