okf-data-catalog
Installation
SKILL.md
Use this skill when the user wants to represent a data warehouse, lakehouse, or BigQuery/Snowflake-style catalog as an OKF bundle, or to enrich an existing catalog export with curated context.
This is OKF's flagship use case: agents answer data questions far better when they have curated table, metric, and join-path context instead of raw schemas.
Two-pass model
The reference OKF agent works in two passes. Mirror it.
- Metadata pass (cheap, deterministic): walk the catalog and emit one concept per durable asset using only structural metadata.
- Enrichment pass (selective, sourced): add descriptions, caveats, lineage,
and join paths from documentation, dbt models, query history, or owners.
Cite external documentation under
# Citations.
Do not block the metadata pass on enrichment. A skeleton catalog is useful immediately and can be enriched incrementally.