
TimescaleDB Reference Guide
Gives an agent reference docs and examples for TimescaleDB time-series PostgreSQL work
- Repository
- 2025Emma/vibe-coding-cn
- Stars
- 23,127
- Licence
- MIT
- Files
- 6 files
What it does
This skill gives an AI agent a folder of reference notes about TimescaleDB, a PostgreSQL extension for storing and analysing time-stamped data such as metrics, logs and events. Once installed, the agent can consult these notes (index, performance, time buckets, tutorials and more) and a handful of example snippets when you ask about hypertables, continuous aggregates, compression or time-based queries. The SKILL.md file is largely a template: the quick-reference patterns are placeholders and the examples include unrelated items such as a Rails command and a Kubernetes namespace.
Great for
- Developers who are learning or building on TimescaleDB and want the agent to pull relevant docs into its answers
- Data engineers who want a quick offline-style lookup of time-bucket and performance guidance
Skip it if
- Production database changes or migrations, because the notes are auto-generated from documentation, may be out of date, and the skill includes no verification step; check against the official TimescaleDB docs
- Anyone expecting a complete reference: the SKILL.md lists api, compression, hypertables and other files that are not among the files provided, and the quick-reference section is a placeholder
Try asking
- “How do I create a hypertable from an existing PostgreSQL table in TimescaleDB?”
- “Show me how to use time_bucket to aggregate sensor readings by hour”
- “What performance settings should I check for a TimescaleDB instance with heavy inserts?”
- “Walk me through the TimescaleDB tutorial for setting up continuous aggregates”
Install in 3 steps
- 1
Download the skill
The ZIP contains the 6 original files, the MIT licence and an attribution note.
timescaledb.zip - 2
Add it to your agent
Claude Code (all projects)
mkdir -p ~/.claude/skills && unzip timescaledb.zip -d ~/.claude/skills/Claude Code / Agent SDK (this project only)
mkdir -p .claude/skills && unzip timescaledb.zip -d .claude/skills/Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.
- 3
Ask for the task
No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.
Get better results
- Ask for a specific feature (for example time_buckets or compression) so the agent reads the matching reference file rather than guessing
- Verify any SQL or configuration against the official TimescaleDB documentation before running it on real data
- Note that the skill's SKILL.md says it was auto-generated and its scripts/ and assets/ folders are empty placeholders
What's inside
- references/index.md
- references/llms.md
- references/performance.md
- references/time_buckets.md
- references/tutorials.md
- SKILL.md
Redistributed unmodified from 2025Emma/vibe-coding-cn under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.