Historic SQL Table Digest
A pipeline skill that turns one staged historic-SQL table JSON file into typed table-usage evidence.
Data & AnalyticsAdvanced★ 1,571⑂ 101AI score 7/10Last updated: Sep 3, 2026
What it does
Reads exactly one tables/<schema>.<name>.json file produced by the historic-sql adapter and condenses how that table is actually queried into a short narrative plus structured fields.
- Read order: WorkUnit notes → the table JSON →
manifest.jsononly if the dialect is missing - Maps
columnsByClause.whereto common filters,groupByto group-bys,observedJoinsto joins - Picks
frequencyTier(high/mid/low/unused) from execution, distinct-user and recency buckets - Calls
emit_historic_sql_evidencewithkind: "table_usage"exactly once, then stops - Hard boundaries: no wiki writes, no SL source edits, no duplicate evidence, no inventing columns, joins or tables
- Identifier verification protocol using
discover_data,entity_detailsandsql_executionprobes; unresolvable identifiers must be tagged[unverified - from <rawPath>]
Who it's for
- Engineers operating or extending the ktx (Kaelio) memory-agent pipeline
- Data platform teams auto-generating warehouse schema documentation from query logs
- Anyone studying design patterns that stop an LLM from hallucinating table and column names
Example scenarios
tables/public.orders.jsonchanges → the skill emits one evidence object: narrative about paid/refunded lifecycle analysis,frequencyTier: "high", common filtersstatusandcreated_at, a join topublic.customers.- A table with no recent templates →
frequencyTier: "unused"withstaleSinceset, then stop. - Unsure whether a literal
tiervalue really exists → runSELECT DISTINCT tier ... LIMIT 50as a probe before writing it down.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/Kaelio/ktx/HEAD/packages/cli/src/skills/historic_sql_table_digest/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the packages/cli/src/skills/historic_sql_table_digest folder from the GitHub repo Kaelio/ktx into my ~/.claude/skills/historic-sql-table-digest/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/Kaelio/ktx.git /tmp/ktx && mkdir -p ~/.claude/skills/historic_sql_table_digest && cp -r /tmp/ktx/packages/cli/src/skills/historic_sql_table_digest/* ~/.claude/skills/historic_sql_table_digest/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repo:
git clone https://github.com/Kaelio/ktx.git - Create the skill folder:
mkdir -p ~/.claude/skills/historic_sql_table_digest - Copy the files:
cp -r ktx/packages/cli/src/skills/historic_sql_table_digest/* ~/.claude/skills/historic_sql_table_digest/ - Restart Claude Code and confirm
historic_sql_table_digestshows up in your skill list. - Note: the skill invokes ktx runtime tools such as
read_raw_file,emit_historic_sql_evidenceandentity_details. Without the ktx CLI installed and configured it cannot run standalone.
View source on GitHub ↗License: Apache-2.0