tda-visualisation-and-diagramming

Classifies research figures and enforces provenance binding, regeneration, and caption-claim proportionality.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Research figures often lack traceable provenance, cannot be regenerated from scripts, or carry captions that overstate the underlying statistics. This Skill governs figure classification, provenance binding, and caption-claim checks so that paper figures are reproducible and claims stay proportional to the evidence. ## Core Features & Use Cases - Figure Classification: Assigns every figure to a class (paper_figure, diagnostic_figure, exploratory_figure, pipeline_diagram, reviewer_response_figure, website_figure) with class-specific governance rules. - Provenance & Regeneration Binding: Requires paper figures to be bound to a script path, input artifact, and reproducible command, recording parameters and seeds. - Caption-Claim Proportionality: Checks that captions do not claim more than the underlying statistic supports, and propagates PROVISIONAL flags from input artifacts to figures. - Use Case: A striking exploratory UMAP plot is proposed as a paper figure; the Skill blocks direct promotion and requires a validation check, a regeneration script, an input artifact, and a proportional caption first. ## Quick Start Ask the assistant to classify a proposed paper figure and verify that it can be regenerated from a script with a proportional caption.

Frequently Asked Questions about tda-visualisation-and-diagramming

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

FAQPage Schema
How do I make a paper figure reproducible from a script?

Bind the figure to a script path, an input artifact, and a command that regenerates the file, then record all parameters and seeds including layout seeds for graph figures. Save figure and metadata together with date-suffixed outputs and never overwrite prior versions.

What figure classes exist for research visualization governance?

Six classes are defined: paper_figure, diagnostic_figure, exploratory_figure, pipeline_diagram, reviewer_response_figure, and website_figure. Paper figures require provenance binding, while exploratory figures cannot support claims until promoted through validation.

Can an exploratory plot be used directly as a paper figure?

No. An exploratory figure cannot support a claim until it is promoted through validation and provenance binding, which requires a regeneration script, an input artifact, and a caption proportional to the underlying statistic.

How do I check whether a figure caption overstates the results?

Compare the caption claim against the underlying statistic; the visual claim must not exceed what the data shows, and W2 and landscape L2 conventions apply to captions too. A caption claiming structural collapse from one dipping summary statistic should be flagged as disproportionate.

What happens when a figure's input data has a PROVISIONAL flag?

The figure inherits the PROVISIONAL flag from its input artifact and must not be typeset as final. If the needed data exists only in a gitignored intermediate, regenerate it from the committed script first.