empirical-ingest

Extracts variables, models, and identification strategies from empirical papers into a research wiki.

Updated Jul 15, 2026
One-click install
npx skills add https://github.com/1549171506/shizhengmubangai1 --skill empirical-ingest-1549171506
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: empirical-ingest
Source: https://github.com/1549171506/shizhengmubangai1/tree/main/Desktop/123/empiricalwiki/i18n/en/skills/empirical-ingest
Command: npx skills add https://github.com/1549171506/shizhengmubangai1 --skill empirical-ingest-1549171506

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning an empirical social-science paper into reusable, structured research-design knowledge is slow and error-prone; this Skill converts one paper into linked wiki pages covering variables, datasets, models, mechanisms, identification, robustness, and heterogeneity. ## Core Features & Use Cases - Structured Paper Ingestion: Reads a local PDF or TeX source, prepares it with tools/prepare_paper_source.py, and extracts only text-supported empirical facts such as sample periods, measurement formulas, fixed effects, and clustered standard errors. - Wiki Page Generation: Creates or updates pages under papers/, variables/, datasets/, models/, mechanisms/, hypotheses/, identification/, robustness/, heterogeneity/, and tables/ using the runtime page templates. - Knowledge Graph Edges: Adds typed edges (operationalizes, uses_dataset, estimates_model, tests_mechanism, addresses_endogeneity_with) via tools/research_wiki.py, then rebuilds index.md, context_brief.md, and open_questions.md and lints the wiki. - Use Case: A researcher downloads a Chinese-language PDF of an empirical economics paper with no online metadata and ingests it into the project wiki, producing a paper card plus linked variable, dataset, and identification pages without inventing any unreported details. ## Quick Start Run /empirical-ingest with the path to your local paper PDF or TeX file, optionally adding --topic to tag the research topic.

Frequently Asked Questions about empirical-ingest

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

FAQPage Schema
How do I ingest an empirical paper into a research wiki?

Run /empirical-ingest with the path to a local PDF or TeX file, optionally passing --topic for the research topic. The skill prepares the source, extracts empirical facts, creates wiki pages, adds graph edges, and rebuilds the index files.

What does empirical-ingest extract from a paper?

It extracts research question, mechanisms, hypotheses, sample period, data sources, variables, measurement formulas, baseline model, fixed effects, clustered standard errors, endogeneity handling, robustness checks, heterogeneity tests, and key tables.

Can I ingest Chinese-language PDFs without arXiv metadata?

Yes, local Chinese-language PDFs without arXiv or Semantic Scholar metadata are valid sources. The skill relies on the paper text itself and the local project structure rather than external metadata lookups.

What happens when a paper does not report a detail?

The skill writes "not reported" for any missing detail. It never invents formulas, database table names, variable names, or identification strategies that are not supported by the paper text.

What project structure does empirical-ingest require?

The working directory must contain wiki/, raw/, and tools/ folders. It uses tools/prepare_paper_source.py and tools/research_wiki.py, and it never overwrites or moves user-owned files under raw/papers/.