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 queries, or set up database constraints.'

Include common user-facing trigger terms and variations such as 'database design', 'SQL tables', 'postgres', 'DDL', 'CREATE TABLE', 'migrations', and 'database modeling'.

Replace category listings with concrete actions, e.g., 'Designs table structures, selects appropriate PostgreSQL data types, defines indexes and foreign keys, implements partitioning strategies, and writes migration scripts.'

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 'Covers best-practices' rather than listing specific actions like 'creates migration scripts, defines foreign key relationships, generates index recommendations.'

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 the 'what' portion is also somewhat vague, placing this at 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', 'tables', 'SQL', 'migrations', 'DDL', 'CREATE TABLE', or 'postgres'.

2 / 3

Distinctiveness Conflict Risk

The PostgreSQL-specific qualifier helps distinguish it from generic database skills, but 'schema design' and 'performance patterns' could overlap with general database design skills or SQL optimization skills. Adding more specific triggers would reduce 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 specific guidance. Its main weaknesses are its length (could benefit from splitting detailed sections into referenced files) and the lack of explicit workflow sequences with validation checkpoints for multi-step operations like schema migrations or bulk data loading. The content is well-organized but borders on being a monolithic reference document rather than a concise skill with progressive disclosure.

Suggestions

Split detailed sections (JSONB Guidance, Data Types, Extensions, Partitioning) into separate referenced files to reduce the main skill's token footprint and improve progressive disclosure.

Add explicit validation workflows for schema changes—e.g., a step-by-step migration checklist with verification queries to confirm constraints, indexes, and data integrity after changes.

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. However, most content is genuinely useful PostgreSQL-specific knowledge.

2 / 3

Actionability

Provides concrete, executable SQL examples throughout (CREATE TABLE, CREATE INDEX, ALTER TABLE), specific syntax for constraints, indexing strategies, and JSONB patterns. The examples section gives copy-paste ready table definitions. Guidance is specific rather than abstract—e.g., exact operator lists for GIN indexes, specific fillfactor values.

3 / 3

Workflow Clarity

The 'Safe Schema Evolution' section provides some workflow guidance with transactional DDL testing, and the insert-heavy workload section sequences bulk load steps (drop index → load → recreate). However, there are no explicit validation checkpoints or feedback loops for schema design processes, and the overall structure is more reference-oriented than workflow-oriented.

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. Several sections (JSONB Guidance, Data Types, Extensions) are quite lengthy and could benefit from being split into separate reference files with pointers from the main skill.

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.