find-data
Find a dataset for a Data2Story blog. Accepts a topic, a URL, or a DIP-style category. Downloads + validates against 4 completeness gates before handing off to /data2story-pro. Local-first: searches Economist/Pudding/TidyTuesday clones before going online. Supports --validate-only to audit a folder you already have.
npx skills add QinghongLin/data2story-skill --skill find-data --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# find-data Turn an idea, URL, or category into a `phase2/datasets/<name>/` folder that the `/data2story-pro` pipeline can run on without crashing. You are the **gatekeeper before the 7-agent newsroom**. Detective, Analyst, Editor, Designer, Programmer, Auditor, Inspector all assume the data is already there, parseable, and provenanced. Your job is to make sure that's true before they start. Refuse to mark a folder ready until it passes 4 gates. See `references/completeness_gates.md` for the criteria. The gates are codified in `tools/audit.py`, not in this prose. ## Prerequisites Python deps for the `tools/`: - **`pandas`** — required (`audit.py` reads/inspects CSV/JSON). - **`openpyxl`** — required **only** when a source is `.xlsx` (`audit.py`'s `pd.ExcelFile`); a mid-run missing-`openpyxl` is the usual cause of an XLSX audit error. - **`urllib`** — stdlib, no install (`fetch.py` downloads, `audit.py` HEAD-checks). One install line: ```bash pip install pandas openpyxl ``` After editing anything under `tools/`, run the no-network regression suite: `py tools/selftest.py` (exit 0 = pass). ## Resolve paths first - `SKILL_DIR` = directory containing this `SKILL.md` - `WORKSPACE` = ance
- Prerequisites
- Resolve paths first
- Step 0 — Classify the input
- Step 1 — Branch on mode
- validate-only mode
- url mode
- category mode
- topic mode
- Step 2 — Optional: generate / repair the README
- Step 3 — Audit (the 4 gates)
- Step 4 — Verdict
- Step 5 — Save a digest
- Constraints
- Reference files
pip install pandas openpyxl python "SKILL_DIR/tools/audit.py" "<folder>" python tools/browse_local.py "<INPUT>" --top 10 python tools/dip_query.py --category "<INPUT>" --top 10 python tools/browse_local.py "<INPUT>" python tools/dip_query.py "<INPUT>" --top 10 python "SKILL_DIR/tools/audit.py" "<OUT_DIR>"
What does the find-data skill do?
Find a dataset for a Data2Story blog. Accepts a topic, a URL, or a DIP-style category. Downloads + validates against 4 completeness gates before handing off to /data2story-pro. Local-first: searches Economist/Pudding/TidyTuesday clones before going online. Supports --validate-only to audit a folder you already have.
How do I install it?
Run `npx skills add QinghongLin/data2story-skill --skill find-data --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From QinghongLin/data2story-skill, a repository with 149 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.