CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

postgres-patterns

PostgreSQL database patterns for query optimization, schema design, indexing, and security. Quick reference for common patterns, index types, data types, and anti-pattern detection. Based on Supabase best practices.

59

Quality

74%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.kiro/skills/postgres-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, token-efficient PostgreSQL cheat sheet with excellent executable SQL examples throughout. Its weaknesses are structural: a duplicated 'when to use' section, no validation/rollback guidance for the destructive system-configuration template (capping workflow clarity at 3), and a fully inlined ~150-line body with no progressive disclosure into reference files.

Suggestions

Add verification steps around the configuration template (e.g., checking current values with SHOW before ALTER SYSTEM, and how to revert), since unvalidated system-wide changes cap workflow clarity at 3.

Remove the duplicate 'When to Use This Skill' section or merge it with 'When to Activate' to eliminate redundant content.

Split the larger reference blocks (index cheat sheet, data-type table, anti-pattern queries, config template) into files under references/ and link them from SKILL.md to enable progressive disclosure.

DimensionReasoningScore

Conciseness

The body is dominated by dense tables and copy-paste SQL with almost no prose padding and no explanation of concepts Claude already knows. It misses anchor 5 because of clear redundancy: the 'When to Activate' section (lines 16-22) and the 'When to Use This Skill' section (lines 150-157) are near-duplicate lists, and the closing Supabase credit line duplicates the frontmatter metadata.

4 / 5

Actionability

Every section is executable: concrete CREATE INDEX statements mapped to query patterns, a data-type decision table, complete SQL for composite/covering/partial indexes, RLS, UPSERT, cursor pagination, SKIP LOCKED queue processing, and ready-to-run diagnostic queries against pg_catalog/pg_stat_statements. This matches anchor 5's copy-paste-ready coverage of common cases.

5 / 5

Workflow Clarity

As a quick-reference skill there is no multi-step workflow to sequence, and the 'Configuration Template' performs system-wide, hard-to-reverse changes (ALTER SYSTEM, REVOKE ALL ON SCHEMA public) with no validation or verification steps beyond pg_reload_conf(). Per the rubric's feedback-loops rule for database operations, the missing validate/verify checkpoints cap workflow clarity at 3, overriding the simple-skill exception; it is not lower because no incoherent or misleading sequence exists.

3 / 5

Progressive Disclosure

Sections are clearly organized with headers and tables, but this is a ~150-line monolithic quick reference with no bundle files at all — content that would naturally live in separate references (index cheat sheet, data-type reference, anti-pattern queries, config template) is all inlined in SKILL.md, and pointers to the 'database-reviewer' agent and sibling skills are not file-based references. This matches anchor 3 ('some structure, content that should be separate is inline'); it beats anchor 2 because the inline content is well-sectioned and navigable, and falls short of anchor 4's 'most content appropriately placed' since nothing is split out.

3 / 5

Total

15

/

20

Passed

Description

66%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A reasonably strong description: specific about its PostgreSQL domain and capability areas, in third person, without fluff. Its main weakness is the complete absence of a 'Use when...' trigger clause, which caps completeness at 3, plus a few missing natural synonyms (Postgres, SQL, slow queries).

Suggestions

Add an explicit trigger clause, e.g. 'Use when writing SQL queries or migrations, designing schemas, troubleshooting slow queries, or implementing Row Level Security.'

Include natural user synonyms such as 'Postgres' and 'SQL' alongside 'PostgreSQL' to improve trigger recall.

Mention the operational tasks covered in the body (connection pooling, RLS) so the description's capability list is comprehensive.

DimensionReasoningScore

Specificity

The description names concrete capability areas — 'query optimization, schema design, indexing, and security' plus 'anti-pattern detection' — which is several specific items with only minor gaps (e.g., connection pooling and RLS from the body are absent). It falls short of anchor 5's comprehensive action coverage because these are topic areas rather than fully enumerated actions, but exceeds anchor 3's '1-2 concrete actions' bar.

4 / 5

Completeness

The 'what' is clear (patterns for optimization, schema design, indexing, security), but there is no 'Use when...' clause or equivalent trigger guidance anywhere in the description, which caps completeness at 3 per the judging guidelines. This matches anchor 3 ('clear what, when missing') and is above anchor 2 because the 'what' is specific, not vague.

3 / 5

Trigger Term Quality

Good natural keywords: 'PostgreSQL', 'query optimization', 'schema design', 'indexing', 'anti-pattern'. A few common user phrasings are missing — the synonym 'Postgres', 'SQL', 'slow queries', and 'migrations' — so it does not reach anchor 5's comprehensive synonym coverage, but it clearly beats anchor 3's partial keyword set.

4 / 5

Distinctiveness Conflict Risk

'PostgreSQL database patterns' carves a clear niche with a strong discriminator, but the broad coverage of 'schema design' and 'security' creates minor overlap risk with closely related sibling skills the body itself references ('database-migrations', 'backend-patterns'). This fits anchor 4 ('mostly distinct; minor overlap risk') better than anchor 5's minimal-conflict profile.

4 / 5

Total

15

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

affaan-m/ECC

Path

.kiro/skills/postgres-patterns/SKILL.md

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.