CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

postgres-pro

Use when optimizing PostgreSQL queries, configuring replication, or implementing advanced database features. Invoke for EXPLAIN analysis, JSONB operations, extension usage, VACUUM tuning, performance monitoring.

72

Quality

91%

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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.

The body is a well-structured, highly actionable overview: executable SQL examples with verification steps, a clear workflow, constraint checklists, and a cleanly signaled one-level-deep reference layer. Remaining improvements are minor — trimming the redundant Knowledge Reference/When-to-Use sections and adding an explicit error-recovery branch to the workflow.

DimensionReasoningScore

Conciseness

The body is dense and actionable — executable SQL, brief interpretive hints ('Look for: Seq Scan (bad on large tables)'), and no explanation of PostgreSQL basics Claude already knows. Minor trimmable content remains: the 'Knowledge Reference' comma-list duplicates the frontmatter triggers, the persona intro line adds little, and 'When to Use This Skill' restates the description — fitting 'efficient; minor instances of over-explanation that could be trimmed' rather than the every-token-earns-its-place score-5 anchor.

4 / 5

Actionability

Fully executable, copy-paste-ready SQL covering the common cases: a complete slow-query-to-fix end-to-end example (pg_stat_statements → EXPLAIN → CREATE INDEX CONCURRENTLY with partial index → verification → ANALYZE), a GIN/JSONB containment pattern, bloat monitoring, and replication lag queries. Specific tools and settings are named (pgBouncer, autovacuum_vacuum_scale_factor), matching the score-5 anchor.

5 / 5

Workflow Clarity

The 5-step Core Workflow has a clear sequence with explicit validation checkpoints (verify indexes with EXPLAIN before and after creation, 'verify improvements after each change') plus MUST DO/MUST NOT checklists — database operations do have verification, so the score-3 cap does not apply. However, no explicit error-recovery feedback loop is stated (e.g., 'if the planner still uses a Seq Scan, then...'), which the score-5 anchor requires.

4 / 5

Progressive Disclosure

Clear overview structure with a well-signaled Reference Guide table (Topic | Reference | Load When) pointing to five one-level-deep reference files, all of which exist and none of which nest further references. Common patterns kept inline are appropriately concise, matching the score-5 anchor for clear navigation and appropriate content splitting.

5 / 5

Total

18

/

20

Passed

Description

92%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 strong description: it explicitly covers both what the skill does and when to use it with concrete, domain-specific trigger phrases, and it stays concise without vague padding. The only gap is missing common synonyms such as 'Postgres' and natural user phrases like 'slow query'.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities ("EXPLAIN analysis, JSONB operations, extension usage, VACUUM tuning, performance monitoring") plus query optimization and replication configuration, giving comprehensive coverage of the PostgreSQL domain. Only "implementing advanced database features" is generic, which is not enough to drop to the score-4 anchor's 'minor gaps in coverage'.

5 / 5

Completeness

It explicitly answers 'when' with a concrete 'Use when optimizing PostgreSQL queries, configuring replication...' trigger clause and explicitly states what it does via 'Invoke for EXPLAIN analysis, JSONB operations, extension usage, VACUUM tuning, performance monitoring'. Both what and when are explicit with concrete trigger phrases, matching the score-5 anchor; the score-4 caveat ('when could be more explicit or specific') does not apply.

5 / 5

Trigger Term Quality

Strong natural keywords users would say (PostgreSQL, EXPLAIN, JSONB, VACUUM, replication, performance monitoring), but common variations are missing — notably the 'Postgres' abbreviation and natural phrases like 'slow query' or 'indexing'. This fits 'good keyword coverage; a few natural terms missing' rather than the score-5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Clear niche (PostgreSQL administration/optimization) with unambiguous Postgres-specific triggers (EXPLAIN, JSONB, VACUUM) that a user would only say for this domain. Minimal conflict risk with related skills; the score-4 anchor's 'minor overlap risk' is not warranted since the triggers are highly distinctive.

5 / 5

Total

19

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

Jeffallan/claude-skills

Path

skills/postgres-pro/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.