tda-domain-modeling

Resolves ambiguous research terminology into one canonical vocabulary across code, contracts, and papers.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Research projects drift when the same concept gets different names in code identifiers, contract fields, paper prose, and result keys. This Skill sharpens or changes ambiguous TDA (topological data analysis) terminology so one precise vocabulary holds across code, contracts, vault notes, papers, and agent prompts. ## Core Features & Use Cases - Term Resolution Procedure: States the conflicting term and every place it appears, checks existing usage in CONVENTIONS.md, notation files, and contracts, then proposes one canonical term with rejected alternatives recorded. - Canonical Term Guards: Protects fixed vocabulary such as Markov order k, W2 (Wasserstein-2), persistence landscape L2, pvalue_null_draws vs effect_null_pairs, and frozen vs re-fit PCA loadings. - Edge-Case Stress Testing: Validates proposed terms against 2-4 concrete cases before locking them at the right documentation level (code comment, glossary, paper notation, or contract term). - Use Case: A result field names a quantity unclearly and a code identifier conflicts with project vocabulary; use this Skill to pick one canonical term, test it against edge cases, and update the right documentation file. ## Quick Start Resolve the ambiguous term in my draft by checking existing usage across code, contracts, and papers, then propose one canonical term and update the appropriate documentation.

Frequently Asked Questions about tda-domain-modeling

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

FAQPage Schema
How do I fix inconsistent terminology across research code and papers?

State the conflicting term and every place it appears, check existing usage in conventions files and contracts, then propose one canonical term. Stress-test it against concrete edge cases before updating the appropriate documentation level.

What is the difference between pvalue_null_draws and effect_null_pairs?

pvalue_null_draws is the p-value denominator, while effect_null_pairs is the diagnostic effect-size pair count. Conflating them is a known defect class, so the two quantities must always be named distinctly in contracts and results.

When should a term become a locked convention versus a glossary entry?

Choose the level by scope: a local code comment for narrow cases, a glossary entry for shared vocabulary, a paper-notation entry for draft symbols, and a conventions lock for project-wide terms. A pure glossary entry carries no implementation detail.

When should I use notation-check instead of domain modeling?

Use notation-check for symbol-level drift inside a draft, such as stale notation in a paper section. Use domain modeling when the concept behind the symbol is ambiguous or when a new method decision should become a convention.

Can I silently edit a locked convention when terminology drifts?

No. Amending a locked convention requires a user decision plus a recorded decision entry, never a silent edit. If two papers already diverge on the same object, surface the conflict before either draft advances.