ts-paper-data
DATA-AWARE mode for the ts-paper suite. Activated by the orchestrator's router ONLY when the input ships REAL measured results (results_mode == "data_aware"); the proposal/no-numbers path is unchanged.
Install / Use
npx skills add Spark-To-Paper-Skills/spark-to-paper-skills --skill ts-paper-dataInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Data & AnalyticsSupported Platforms
Tags
Our assessment of ts-paper-data
ts-paper-data scores 90/100 on our quality scale, 311th of 604 Data & Analytics skills we index.
Its SKILL.md is 8.1 KB long, well organised into 9 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
With 1,126 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 3 months ago, so ts-paper-data is actively maintained.
- Our last check on 2026-10-30 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
ts-paper-data compared with similar skills
All 4 of these similar skills score higher than ts-paper-data; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| ts-paper-data (this skill)by Spark-To-Paper-Skills | 90 | 1.1k | 3mo ago | SKILL.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 149.0k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install ts-paper-data?
- Run
npx skills add Spark-To-Paper-Skills/spark-to-paper-skills --skill ts-paper-data. The install tabs above show the steps for each supported agent. - Which AI agents does ts-paper-data work with?
- It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is ts-paper-data safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is ts-paper-data still maintained?
- The repository was last updated about 3 months ago, so ts-paper-data is actively maintained.
Skill content
View source on GitHubname: ts-paper-data description: > DATA-AWARE mode for the ts-paper suite. Activated by the orchestrator's router ONLY when the input ships REAL measured results (results_mode == "data_aware"); the proposal/no-numbers path is unchanged. Claude reads the user's data in ANY form (CSV / JSON / a pasted table / numbers in prose), judges it directly — there is NO fixed results schema — fills the result tables itself with real numbers in past tense, and writes the per-section text from the evidence. Two thin code backstops keep it honest: a schema-agnostic number-audit (draft_lint) and matplotlib results figures (plot_results.py). Use when a proposal/report comes with real experimental data.
ts-paper-data — write the paper FROM real results (Claude judges the data)
The proposal path forbids numbers and writes forward-looking ("we expect…"). DATA-AWARE mode inverts
that: the experiments are done, so report what was measured, in past tense, with the real numbers.
Per the project philosophy, Claude reads and judges the data itself — no rigid results.json schema,
no loader. Code does only the two irreducible things: machine-check that no number is fabricated, and
plot precise results figures.
When this runs
Only when the router set template.results_mode == "data_aware" (the input had real results — a
file, a pasted table, or measured numbers in the prose). Otherwise the suite stays in proposal mode and
this skill is not used.
Step 1 — read the data and write results.facts.json (the one artifact)
Read whatever the user gave — a CSV, a JSON, a Markdown/LaTeX table, or numbers written in the proposal
prose. Understand it: which methods/variants, which datasets, which metrics, ablation deltas, runtime
costs, and any qualitative findings. Then write results.facts.json — simply the set of REAL numbers
you will use, in any convenient shape (a flat list, or {"label": value}, or nested). This is the
ground truth the number-audit checks against. Example:
{"main": {"Ours": {"HOTA": 0.621, "IDF1": 0.704}, "ByteTrack": {"HOTA": 0.476}},
"ablation": {"w/o formation prior": {"IDsw": 0.18}}, "runtime": {"fps": 27.3, "latency_ms": 36},
"notes": ["FPR is 0.03 — non-zero, a real weakness"]}
Rules: every number must come from the user's data — never invent or round-trip a number that wasn't
given. A metric that was measured-but-unavailable is the sentinel "TBD"; a cell never run is null.
Step 2 — fill the result tables yourself (real numbers, in order)
Write the experiment result tables directly in sections/experiments.tex (same LaTeX table pattern as
proposal mode, with \label{tab:main_results} / secondary_results / ablation_results in the spec
order) — but with the real measured numbers in the cells instead of --. null → --; "TBD" →
TBD. Keep cells consistent with results.facts.json (the audit cross-checks the prose, and you should
keep table and prose numbers identical). Do not write a metric the data doesn't contain.
Step 3 — write the data-aware sections (past tense, real numbers)
For each result-bearing section the active template defines (abstract + experiments always; plus any
analysis / results / limitations section present in template.sections), swap the proposal-mode rules
for evidence-grounded ones:
- abstract — Part-4 (results) states 2–3 most impactful real numbers in definitive past tense ("achieves 0.62 HOTA, outperforming the strongest baseline by 0.15"); NO forward-looking/vague outcome.
- experiments — past tense throughout (achieved/outperformed); reference specific numbers; real
ablation deltas between variants; NO "we expect", NO
--in prose, NO vague outcomes. - analysis — evidence-grounded: every quantitative claim cites a specific number; each ablation variant analysed with its actual measured delta; failure modes grounded in real data patterns (non-zero error, edge cases) — do NOT invent failure modes absent from the data. Do not re-state the Experiments numbers; cite the table, then explain the MECHANISM / WHY (Analysis's value-add is causal).
- conclusion — summarise contributions WITH the key real results, definitive past tense; no forward-looking language about results already obtained.
- limitations (only if the active template defines a limitations section) — quantify limitations with
the real data (a non-zero error rate, a perf gap, a runtime cost from the data); honestly surface any
data-revealed weakness with its actual value; never downplay a shown weakness, never invent one.
method/related_work/introductionare written normally (no results numbers). TBD rule: aTBD/missing metric is unavailable evidence — stay silent about it; never guess it.
Step 4 — the results-plot TOOLKIT (the figure stage renders; you provide data + toolkit)
The single owner of drawing figures is ts-paper-figure (routing is by SECTION: matplotlib ONLY for
the results-section data plots, image model for every other figure). In data-aware mode it draws the results plots from CODE
(numerically exact, never the image model) using THIS skill's toolkit and the numbers in
results.facts.json / your filled tables. Your job in the data stage is to make sure results.facts.json
and the filled tables exist (Steps 1–2); the figure stage runs the plotter.
The toolkit it uses (kept here):
scripts/plot_results.py --script figures/<label>.plot.py --out figures/<label>.png— runs a self-contained matplotlib script and saves PNG + a vector PDF (born-vector, even if the script self-saves). The figure stage embeds that.pdfvia an extension-less\includegraphics{figures/<label>}, so matplotlib figures are editable vectors with no extra step (they skip the DrawAI hybrid vectorization ints-figure-optimize, which is only for image-model rasters).scripts/plot_style.py— the figures4papers publication house style;plot_results.pyapplies the rcParams and injectsPALETTE,SEMANTIC,style_axes,finalizeinto the plot script's namespace.references/plot-style.md— colour BY MEANING (SEMANTIC["ours"]blue /["positive"]green /["contrast"]red /["baseline"]grey) + per-chart encoding rules (bars: black edges, value labels, alpha-ablation, hatch for grayscale, tight y-limits; trends: 2–4 curves +fill_between; heatmap/radar; wide canvas + dedicated legend axis) +finalize(fig, OUT)(dpi 300, +PDF; 600 for dense bars). Anull/TBDvalue is a gap in the plot, never a fabricated point. (This matplotlib toolkit is for the results-section data plots only. Concept / math-geometry illustrations are NOT drawn here anymore — the figure stage routes every non-results figure to the image model, since matplotlib renders concepts poorly.)
Step 5 — the number-audit gate (machine-checked honesty)
Run the write-stage linter; in data-aware mode it flips from "ban all numbers" to "flag untraceable ones":
python3 ../ts-paper-write/scripts/draft_lint.py <workdir>
It flags suspicious_number for any decimal/percent in prose not present in results.facts.json
(bare integers are treated as design constants and not audited), and missing_results_facts if you
forgot to write the facts file. Drive it to zero by correcting the prose to the real numbers — never by
adding a fake number to the facts file; it must be ok:true before proceeding. citations_lint and the
rest of the suite are unchanged.
Fusion (do it inline, not as a separate heavyweight stage)
If the input was an idea/proposal whose claimed outcomes don't match the real data, silently align the claims to the data as you plan and write (a proposal that predicted "large gains" but the data shows a small gain must say the small gain). This is just honest writing against the evidence — no separate fusion artifact needed.
Trace
Write logs/data.io.md — INPUT (the data form received + what you extracted), DECISIONS (table values,
per-section number choices, any TBD/weakness surfaced, the plot scripts), OUTPUT (results.facts.json
summary, draft_lint result). This is a conditional log (only when results_mode == data_aware); it is
linked from logs/index.md when this stage runs.
Related Skills
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
149.0kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
