tda-external-data-lookup

Retrieves external economic and statistical data with full provenance records for research papers.

1|Updated Dec 13, 2025
One-click install
npx skills add https://github.com/ZK-Theory/TDL --skill tda-external-data-lookup-zk-theory
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tda-external-data-lookup
Source: https://github.com/ZK-Theory/TDL/tree/main/.agents/skills/tda-external-data-lookup
Command: npx skills add https://github.com/ZK-Theory/TDL --skill tda-external-data-lookup-zk-theory

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Research papers often cite external statistics (unemployment rates, GDP series, market data) that are typed in by hand without a verifiable source, making claims impossible to audit or reproduce. This Skill enforces a provenance-first workflow where every external data lookup becomes a stored, dated, versioned artifact linked to the paper claim it supports. ## Core Features & Use Cases - Provenance-First Retrieval: Records the source database, dataset ID, endpoint, retrieval date, version/release, units, and coverage period for every external series. - Use Classification: Classifies each lookup as contextual, inferential, or illustrative, with inferential use triggering the full provenance path including schema validation and vintage checks. - Scripted Transformations Only: Prohibits hand-edited spreadsheets between source and artifact, requiring all transformations to be scripted. - Use Case: A World Bank series is about to enter a panel model as a covariate. The Skill classifies it as inferential, stores the raw response with retrieval metadata, and checks that the series vintage matches the panel window before the value enters the model. ## Quick Start Retrieve the UK unemployment rate series from ONS for my paper's background section and store it as a dated provenance artifact.

Frequently Asked Questions about tda-external-data-lookup

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

FAQPage Schema
How do I cite external economic data in a research paper?

Retrieve the series from the primary publisher (FRED, World Bank, ONS), record the dataset ID, endpoint, retrieval date, and version, and store the raw response as an artifact. Cite the artifact by reference rather than typing values into prose.

How do I add a World Bank series as a model covariate?

Classify the series as inferential use, which triggers the full provenance path: a date-suffixed artifact, scripted transformations, schema validation, and a check that the series vintage matches your panel window.

What is the difference between contextual and inferential data use?

Contextual use is background prose and illustrative use is figures only, both needing basic provenance. Inferential use means the data enters a model, requiring the full provenance artifact with seeds, validation, and vintage checks.

Can I use this skill for Understanding Society or BHPS data?

No. Understanding Society and BHPS core data go through official survey documentation and the bhps-wave-crosswalk skill. This skill covers external sources like FRED, Eurostat, ONS, SEC, and market data only.

What should I do if a series only exists from a non-authoritative aggregator?

Surface the sourcing risk explicitly rather than quietly using the aggregator. The skill prefers primary publishers such as statistical agencies and central banks over secondary aggregators.