CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

postgres-patterns

PostgreSQL database patterns for query optimization, schema design, indexing, and security. Based on Supabase best practices.

1.12x
Quality

74%

Does it follow best practices?

Impact

96%

1.12x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./docs/ja-JP/skills/postgres-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

83%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 an exemplary lean quick-reference: fully executable SQL, dense tables instead of prose, and no filler. Its one substantive weakness is the absence of validation checkpoints around its riskier guidance (ALTER SYSTEM, REVOKE ALL, queue processing) — per the rubric's scoring notes this caps workflow clarity at 3. Structure and organization are good for a single-file skill of this size.

DimensionReasoningScore

Conciseness

The body is almost entirely tables, terse SQL snippets, and one-line explanatory comments (e.g. the index cheat-sheet table, "-- SELECTでラップ!", "-- O(1) vs OFFSET は O(n)") with zero space spent explaining what PostgreSQL is or how basic concepts work. This matches anchor 5 ("Lean and efficient; assumes Claude's competence; every token earns its place"); the one-line intro and trailing attribution are minimal and do not constitute the padding that would drop it to 4.

5 / 5

Actionability

Every pattern is copy-paste-ready executable SQL: index DDL per query pattern, a complete antipattern-detection query set against pg_constraint/pg_stat_statements/pg_stat_user_tables, a working FOR UPDATE SKIP LOCKED queue UPDATE, an ON CONFLICT upsert, and ALTER SYSTEM config templates. This matches anchor 5 ("Fully executable; copy-paste ready code or commands; specific examples cover the common cases"); it is not 4 because the snippets are complete rather than having minor gaps — table aliases like `t` are placeholders, not missing detail.

5 / 5

Workflow Clarity

This is a lookup/reference skill rather than a multi-step workflow, and the sections are individually unambiguous, but it includes database operations with no validation or verification checkpoints: `ALTER SYSTEM SET max_connections/work_mem`, `REVOKE ALL ON SCHEMA public`, and the queue-processing UPDATE are applied with no "verify first" step (e.g. EXPLAIN before indexing, pg_reload_conf/testing before config changes). The scoring notes list database operations as a context where missing feedback loops cap workflow_clarity at 3, and that cap takes precedence over the simple-skill exception, so this is 3 ("Steps listed but validation gaps") rather than 4 or 5.

3 / 5

Progressive Disclosure

The single-file body (~140 lines) is well organized with clear section headers (quick reference tables, patterns, antipattern detection, config templates, related resources) and no nested or dead references — the `database-reviewer`, `clickhouse-io`, and `backend-patterns` pointers are cross-links to agents/skills, not broken file paths. This fits anchor 4 ("Good structure; most content is appropriately placed; minor organization gaps"); it is not 5 because at this length the antipattern-detection queries and config templates are plausible candidates for separate reference files, and not 3 because nothing is badly buried or misfiled.

4 / 5

Total

17

/

20

Passed

Description

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

The description names a clear domain and lists four relevant capability areas, but it reads as a topic list rather than an action statement, includes no 'Use when...' trigger guidance, and misses the natural vocabulary (slow query, migration, RLS, EXPLAIN) users would actually say. It is functional but below the quality of the reference good examples, which pair concrete actions with explicit trigger phrases.

Suggestions

Add an explicit trigger clause, e.g. "Use when writing or reviewing SQL queries and migrations, designing schemas, debugging slow queries, or implementing row level security in PostgreSQL."

State capabilities as concrete actions with natural synonyms: "Optimize slow queries with EXPLAIN, choose index types (B-tree, GIN, BRIN), review migrations, and write RLS policies."

Drop or tighten "Based on Supabase best practices" — provenance adds tokens without helping trigger or capability recognition (keep the attribution in the body, where it already exists).

DimensionReasoningScore

Specificity

The description "PostgreSQL database patterns for query optimization, schema design, indexing, and security" names the domain clearly and enumerates four capability areas, but these are topic categories rather than concrete actions (no verbs like "optimize queries", "create indexes", "write RLS policies"). This sits between anchor 3 ("Names domain and 1-2 concrete actions, but not comprehensive") and anchor 4 ("Lists several specific actions") — closer to 3 because nothing is stated as an action Claude performs.

3 / 5

Completeness

The 'what' is reasonably clear ("PostgreSQL database patterns for query optimization, schema design, indexing, and security"), but there is no 'Use when...' clause or equivalent trigger guidance anywhere in the description — "Based on Supabase best practices" is provenance, not a trigger. Per the judging guidelines, a missing explicit trigger clause caps completeness at 3, which matches anchor 3 ("Has a clear 'what' but 'when' is missing or only weakly implied").

3 / 5

Trigger Term Quality

Terms like "PostgreSQL", "query optimization", "schema design", "indexing" are relevant, but common natural phrases a user would actually say — "slow query", "migration", "RLS", "row level security", "EXPLAIN", "database performance" — are absent. This matches anchor 3 ("Some relevant keywords but missing common variations or synonyms"); not 4 because the keyword set is limited to the four headline topics with no synonyms or tool-specific extensions.

3 / 5

Distinctiveness Conflict Risk

"PostgreSQL" plus the Supabase attribution carves out a clear niche with distinct triggers, and the named subtopics keep it from conflicting with generic SQL or other-database skills. Minor overlap risk remains with closely related database skills (the body itself links sibling skills like `clickhouse-io`), so this fits anchor 4 ("Mostly distinct; minor overlap risk with closely related skills") rather than 5 ("Clear niche with distinct triggers; minimal conflict risk").

4 / 5

Total

13

/

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

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

affaan-m/ECC

Path

docs/ja-JP/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.