timescaledb

Optimize TimescaleDB hypertables, continuous aggregates, and compression policies for PostgreSQL time-series workloads.

9|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/diegoscarabelli/system2 --skill timescaledb-diegoscarabelli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: timescaledb
Source: https://github.com/diegoscarabelli/system2/tree/main/src/server/agents/skills/timescaledb
Command: npx skills add https://github.com/diegoscarabelli/system2 --skill timescaledb-diegoscarabelli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the complexity of managing time-series data in PostgreSQL, specifically preventing performance degradation caused by improper hypertable configuration, inefficient query patterns, and suboptimal retention policies.

Core Features & Use Cases

  • Schema Design & Optimization: Provides guidance on creating hypertables, configuring compression, and setting up continuous aggregates to ensure high performance.
  • Performance Troubleshooting: Identifies common pitfalls like non-sargable predicates, missing time filters, and incorrect index strategies that lead to slow query execution.
  • Lifecycle Management: Automates the implementation of retention policies and tiered data storage to manage storage costs and query speed effectively.

Quick Start

Use the timescaledb skill to analyze my current hypertable schema and suggest optimal compression and retention policies.

Frequently Asked Questions about timescaledb

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I optimize TimescaleDB hypertable schema design and query performance?

To optimize TimescaleDB hypertables, configure continuous aggregates, enforce sargable time filters, and apply chunk management best practices to prevent slow query execution and storage bottlenecks.

What is the best way to configure data lifecycle management and retention policies in PostgreSQL time-series workloads?

The best way to manage time-series data lifecycle in PostgreSQL is automating retention policies and tiered storage via TimescaleDB, which controls storage costs and maintains efficient retrieval speeds.

Why does my TimescaleDB continuous aggregate query performance degrade over time?

TimescaleDB query performance degrades due to common pitfalls like missing time filters, non-sargable predicates, and incorrect index selection, which require schema optimization and troubleshooting to resolve.

How do I set up compression policies for PostgreSQL time-series data?

Set up PostgreSQL time-series compression by configuring hypertable compression policies within TimescaleDB, ensuring efficient storage and retrieval while enforcing data lifecycle management best practices.

Can I use TimescaleDB for time-series data engineering without hitting storage bottlenecks?

Yes, TimescaleDB prevents time-series storage bottlenecks by enforcing correct chunk management, automated retention policies, and optimized compression strategies to manage costs and query speed effectively.

When should I not use continuous aggregates for time-series queries in PostgreSQL?

Avoid continuous aggregates when raw, real-time data precision is required without refresh lag, as they materialize pre-computed summaries that may not reflect the most recent hypertable inserts.