CtrlK
BlogDocsLog inGet started
Tessl Logo

find-hypertable-candidates

Use this skill to analyze an existing PostgreSQL database and identify which tables should be converted to Timescale/TimescaleDB hypertables. **Trigger when user asks to:** - Analyze database tables for hypertable conversion potential - Identify time-series or event tables in an existing schema - Evaluate if a table would benefit from Timescale/TimescaleDB - Audit PostgreSQL tables for migration to Timescale/TimescaleDB/TigerData - Score or rank tables for hypertable candidacy **Keywords:** hypertable candidate, table analysis, migration assessment, Timescale, TimescaleDB, time-series detection, insert-heavy tables, event logs, audit tables Provides SQL queries to analyze table statistics, index patterns, and query patterns. Includes scoring criteria (8+ points = good candidate) and pattern recognition for IoT, events, transactions, and sequential data.

66

Quality

83%

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

71%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 content is highly actionable and dense, built around executable SQL and a concrete scoring rubric with a clear analysis→scoring workflow and a defined decision threshold. Its main weaknesses are repetition in the pattern examples, absent feedback loops for ambiguous outcomes, and a monolithic structure with no progressive disclosure into reference files.

Suggestions

Move the 'Common Patterns' schema catalog (the four good-candidate and three poor-candidate CREATE TABLE examples) into a references/ file (e.g., references/patterns.md) and keep a one-line summary with a clearly signaled link in SKILL.md, enabling one-level-deep progressive disclosure.

Trim duplication: the poor-candidate examples (users, user_settings) restate the Option B '❌ POOR' schema indicators — consolidate them into a single section to tighten conciseness.

Add a short validation/feedback step at the end of Step 2, e.g., what to do when a table scores near the threshold (6–8 points) or when no candidates are found (report why and confirm with the user), and add the missing growth-rate query needed for the 'Size: current size and growth rate' output requirement.

DimensionReasoningScore

Conciseness

The body is dense and operational — SQL, terse bullets, and point values — with no explanation of concepts Claude already knows, placing it above 3. It falls short of 5 because the 'Common Patterns' section repeats four nearly identical good-candidate schemas and the poor-candidate examples restate the Option B schema indicators, which could be trimmed.

4 / 5

Actionability

Nearly all guidance is executable: copy-paste-ready SQL for table stats, indexes, pg_stat_statements (with an availability check), and constraints, plus a concrete point-based scoring rubric ('Has timestamp/timestamptz column: **3 points**'). Minor gaps — e.g., the required output 'Size: Current size and growth rate' has no query for growth rate, and several queries need placeholder substitution — hold it at 4 rather than 5.

4 / 5

Workflow Clarity

A clear two-step sequence (schema analysis via Option A/B → candidacy scoring) with per-query 'Look for' checkpoints and an explicit decision gate ('8+ points = good candidate') plus an availability check for pg_stat_statements, matching the 4 anchor. It lacks 5's feedback loops — no guidance for ambiguous results, zero-candidate outcomes, or how to re-check when data is inconclusive.

4 / 5

Progressive Disclosure

The file is well-sectioned with headers and a clear pointer to the companion 'migrate-postgres-tables-to-hypertables' skill, but it is a ~300-line monolith with no bundle files or reference structure — the 'Common Patterns' schema catalog and the ID-based special case are content that belongs in a separate references file. This matches the 3 anchor ('some structure but... content that should be separate is inline') rather than 4, which requires most bulk content placed in clearly signaled external files.

3 / 5

Total

15

/

20

Passed

Description

88%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 states what the skill does and when to use it, with concrete capabilities (SQL analysis queries, scoring criteria, pattern recognition) and a rich keyword list. The only weaknesses are a few missing natural trigger synonyms and minor keyword overlap with the companion migration skill.

DimensionReasoningScore

Specificity

Names the domain (PostgreSQL → TimescaleDB hypertable conversion) and multiple concrete actions: 'analyze an existing PostgreSQL database and identify which tables should be converted', 'Provides SQL queries to analyze table statistics, index patterns, and query patterns', 'Includes scoring criteria (8+ points = good candidate) and pattern recognition for IoT, events, transactions, and sequential data'. Coverage of the skill's capabilities is comprehensive with no notable gaps, matching the 5 anchor rather than 4.

5 / 5

Completeness

Both what and when are explicit: the what ('analyze an existing PostgreSQL database and identify which tables should be converted... Provides SQL queries... Includes scoring criteria') and the when ('**Trigger when user asks to:**' followed by five concrete trigger scenarios). This matches the 5 anchor exactly; the when is not merely implied as at 4.

5 / 5

Trigger Term Quality

Strong keyword list ('hypertable candidate, table analysis, migration assessment, Timescale, TimescaleDB, time-series detection, insert-heavy tables, event logs, audit tables') plus five explicit trigger bullets ('Score or rank tables for hypertable candidacy'). A few natural user phrasings are missing (e.g., 'convert to hypertable', 'time-series data', 'telemetry', 'sensor data'), so it sits at 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

Clear niche (hypertable candidacy analysis) with distinct, specific triggers, so well above the 3 anchor. However, the 'migration assessment' keyword and 'Audit PostgreSQL tables for migration to Timescale/TimescaleDB/TigerData' trigger overlap with the companion 'migrate-postgres-tables-to-hypertables' skill referenced in the body, keeping it at 4 rather than 5.

4 / 5

Total

18

/

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
timescale/pg-aiguide
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.