timescaledb

Design hypertables, continuous aggregates, and compression policies in TimescaleDB.

6|1|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/RepairYourTech/cfsa-antigravity --skill timescaledb-repairyourtech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: timescaledb
Source: https://github.com/RepairYourTech/cfsa-antigravity/tree/main/.agent/skill-library/stack/databases/timescaledb
Command: npx skills add https://github.com/RepairYourTech/cfsa-antigravity --skill timescaledb-repairyourtech

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides comprehensive guidance on designing, optimizing, and managing time-series data using TimescaleDB, addressing challenges in data modeling, query performance, and storage efficiency.

Core Features & Use Cases

  • Hypertable Design: Learn best practices for creating and tuning hypertables, including chunk intervals and space partitioning.
  • Continuous Aggregates: Implement materialized views for real-time analytics and faster dashboarding.
  • Compression & Retention: Optimize storage costs with automated data compression and lifecycle policies.
  • Hybrid Queries: Leverage full PostgreSQL capabilities for complex time-series and relational data joins.
  • Migration: Seamlessly migrate existing PostgreSQL tables to TimescaleDB hypertables.
  • Use Case: When building a monitoring system for IoT devices, use this Skill to design efficient hypertables, set up continuous aggregates for real-time dashboards, and implement data retention policies to manage storage costs.

Quick Start

Use the timescaledb skill to create a hypertable named 'sensor_data' with 'time' as the time column and a chunk interval of '1 day'.

Frequently Asked Questions about timescaledb

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

FAQPage Schema
How do I create a TimescaleDB hypertable for time-series data?

To create a TimescaleDB hypertable, you first define a standard PostgreSQL table with a time column, then convert it using the create_hypertable function while specifying chunk intervals like 1 day for efficient storage and querying of time-series data.

What is the best way to optimize storage for time-series metrics in PostgreSQL?

The best way to optimize time-series storage is migrating to TimescaleDB and applying automated data compression and retention policies, which significantly reduce storage costs for high-volume metrics, logs, and IoT telemetry data.

How do continuous aggregates improve time-series query performance?

Continuous aggregates improve time-series query performance by implementing materialized views that automatically refresh, enabling real-time analytics and faster dashboarding without repeatedly processing raw historical data.

Can I use standard PostgreSQL relational queries with TimescaleDB time-series data?

Yes, TimescaleDB fully supports hybrid queries, allowing you to leverage standard PostgreSQL capabilities for complex joins between time-ordered data and relational data within the same database instance.

How do I migrate existing PostgreSQL tables to TimescaleDB hypertables?

You can seamlessly migrate existing PostgreSQL tables to TimescaleDB hypertables by converting them directly, which allows you to start utilizing time-series features like continuous aggregates and compression on your current data.