duck-time-travel

Enable DuckDB time-travel queries with deterministic color tracking via SplitMix64 hashing.

60|13|Updated Dec 22, 2025
One-click install
npx skills add https://github.com/plurigrid/asi --skill duck-time-travel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: duck-time-travel
Source: https://github.com/plurigrid/asi/tree/main/skills/duck-time-travel
Command: npx skills add https://github.com/plurigrid/asi --skill duck-time-travel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill uses DuckDB time-travel queries to enable historical data reconstruction with color tracking via Gay.jl.

Core Features & Use Cases

  • Versioned Queries: Query history via AT VERSION or AT TIMESTAMP.
  • Color Tracking: Map interactions to GF(3) colors for traceability.
  • Temporal Analysis: Reconstruct past states for auditing and debugging.

Quick Start

Run a simple SQL query with AT VERSION to see historical results and color traces.

Frequently Asked Questions about duck-time-travel

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

FAQPage Schema
How do I query historical data in DuckDB using time-travel queries?

Time-travel queries in DuckDB let you reconstruct past states using AT VERSION or AT TIMESTAMP syntax. This skill enables versioned queries on temporal data, allowing you to audit changes and retrieve historical snapshots without maintaining separate archives.

What is color tracking in temporal data analysis and why use it?

Color tracking maps interactions to GF(3) colors using deterministic hashing, creating traceable metadata for each query. This approach helps you trace cross-thread interactions and debug workflows by assigning consistent color identifiers to related data operations.

Can I use DuckDB time-travel queries with bi-temporal data models?

Yes. This skill supports bi-temporal schemas with versioning and timestamp-based queries, letting you maintain both transaction time and valid time dimensions for complete temporal coverage in auditing and regulatory compliance scenarios.

How do I set up color-tracked metadata for versioned queries?

Configure color metadata using color_seed, color_hex, and color_trit fields with SplitMix64 hashing. This generates deterministic color assignments per interaction, enabling systematic traceability across snapshot queries and version reconstructions.

What are the limitations of DuckDB temporal queries for large datasets?

Time-travel queries reconstruct historical state but require versioned table structures and sufficient storage. Performance depends on version chain depth and query selectivity; very deep histories or broad timestamp ranges may require query optimization or partitioning strategies.