timescaledb-tiger-architect

Design TimescaleDB hypertables, chunk sizing, compression, retention, and Iceberg/S3 sync policies.

Updated Nov 25, 2025
One-click install
npx skills add https://github.com/filimorniga-ux/farmacias-vallenar-suit --skill timescaledb-tiger-architect
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: timescaledb-tiger-architect
Source: https://github.com/filimorniga-ux/farmacias-vallenar-suit/tree/main/.agent/skills/timescaledb-expert
Command: npx skills add https://github.com/filimorniga-ux/farmacias-vallenar-suit --skill timescaledb-tiger-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates guesswork and costly mistakes when designing and operating high-ingest time-series databases by prescribing hypertable design, chunk sizing, query optimization, compression, retention, and cloud-tiering strategies tailored for TimescaleDB and Tiger Cloud.

Core Features & Use Cases

  • Hypertable Best Practices: Ensures append-only temporal data is modeled as hypertables and avoids manual Postgres partitioning pitfalls.
  • Chunk Sizing & Memory Fit: Calculates chunk_time_interval using the 25% RAM rule to prevent index thrashing and optimize active-chunk performance.
  • Query & Read Optimization: Advises enabling chunk skipping for correlated columns and prescribes continuous aggregates with incremental refresh policies for real-time analytics.
  • Lifecycle Management: Recommends compression segmentby/orderby settings, automated compression policies, and chunk-based retention (DROP CHUNK) instead of row-level deletes.
  • Cloud Tiering (Tiger Lake / Iceberg): Guides configuring Iceberg/S3 synchronization for long-term, queryable cold storage.

Quick Start

Use the timescaledb-tiger-architect skill to analyze ingest rates and recommend hypertable chunk_interval, continuous aggregate policies, compression and retention settings, and S3/Iceberg sync for cold data.

Frequently Asked Questions about timescaledb-tiger-architect

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

FAQPage Schema
How do I calculate chunk_time_interval for TimescaleDB hypertables to fit available RAM?▼

Calculate TimescaleDB chunk_time_interval using the 25% RAM rule to prevent index thrashing and optimize active-chunk performance for high-ingest telemetry.

What is the best way to configure continuous aggregates and refresh policies for real-time analytics in TimescaleDB?▼

Configure continuous aggregates with incremental refresh policies to precompute time-series data, enabling fast real-time analytics queries without reprocessing the entire hypertable history.

How does compression segmentby and orderby work for TimescaleDB lifecycle management?▼

TimescaleDB compression uses segmentby to group correlated data and orderby to sort within groups, enabling chunk-based retention via DROP CHUNK and automated compression policies instead of row-level deletes.

Can I use Iceberg and S3 synchronization for cold storage tiering with TimescaleDB?▼

Yes, you can configure Iceberg and S3 synchronization to establish queryable cold storage, moving older time-series chunks out of the active database while keeping them accessible for long-term analysis.

When should I enable chunk skipping for correlated columns in time-series hypertables?▼

Enable chunk skipping for correlated columns when query patterns frequently filter by specific metadata, allowing the database to skip scanning irrelevant chunks and significantly accelerating telemetry retrieval.