validate-topology

Runs topological validation pipelines and summarizes results for TDA research domains.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Validating topological data analysis results against published benchmarks and statistical criteria is manual and error-prone; this Skill runs the validation pipeline for a chosen research domain and summarizes pass/fail outcomes with diagnostic context. ## Core Features & Use Cases - Domain-Scoped Validation: Runs validation for financial_tda, poverty_tda, or trajectory_tda via pytest markers and domain-specific scripts. - Benchmark Comparison: Checks results against known references such as Gidea-Katz 2017, 2008 GFC H1 spikes, ARI thresholds above 0.3, and permutation null p-values. - Failure Diagnosis: Reads failing tests to identify whether issues stem from data, topology computation, or statistical tests, then suggests targeted fixes. - Use Case: A researcher suspects the poverty_tda persistence diagrams no longer match known deprivation deciles; the Skill runs the validation suite, reports ARI agreement, and flags suspicious near-zero persistence thresholds. ## Quick Start Ask the assistant to validate the financial_tda domain and summarize which topological benchmarks passed or failed.

Frequently Asked Questions about validate-topology

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

FAQPage Schema
How do I run topological validation for a TDA research domain?

Run pytest with the validation marker for the target domain, for example uv run pytest tests/financial_tda/ -m validation -v. The Skill locates the domain's validation modules, executes them, and summarizes which checks passed or failed.

What benchmarks does TDA validation compare against?

financial_tda checks for H1 spikes during the 2008 GFC and H0 fragmentation during COVID 2020. poverty_tda expects ARI above 0.3 against deprivation deciles, and trajectory_tda expects permutation null p-values below 0.05 for primary hypotheses.

Can I validate all TDA domains at once?

Yes, the Skill prompts you to choose a domain or select all. It then locates validation modules under financial_tda/validation, poverty_tda/validation, and trajectory_tda scripts prefixed with null_ or validation_.

Why do TDA validation tests fail with near-zero persistence?

Very low or near-zero persistence thresholds usually indicate problems in the topology computation or input data rather than the statistical test. The Skill reads the failing test to isolate whether the issue is in data, topology computation, or the statistical layer.

Does the validation skill apply fixes automatically?

No, it only suggests targeted fixes after diagnosing failures. Changes are never applied without explicit user confirmation, keeping the validation workflow read-only by default.