ingest

Ingests academic papers into a structured wiki with cross-referenced pages and graph edges.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning a research paper into a connected knowledge base entry is tedious: you must create pages for the paper, its concepts, claims, and authors, then wire up bidirectional links and graph edges by hand. This Skill automates that entire pipeline from an arXiv URL, local .tex, or .pdf source. ## Core Features & Use Cases - Full paper ingestion: Resolves arXiv URLs, local TeX, or PDFs (with a preprocessing pipeline that recovers arXiv IDs and fetches original TeX source) into fully-formed wiki paper pages. - Entity dedup and merging: Uses find-similar-concept and find-similar-claim tools to merge candidates into existing pages instead of creating near-duplicates, with per-paper creation limits. - Graph and cross-reference wiring: Writes forward and reverse links atomically, appends semantic edges (introduces_concept, builds_on, improves_on, etc.) and bibliographic citations via tools/research_wiki.py. - Use Case: Drop an arXiv URL like https://arxiv.org/abs/2106.09685 into the conversation and receive a paper page plus linked concept, claim, and people pages, with graph edges, index updates, and a summary report of suggested follow-up ingests. ## Quick Start Ask the assistant to ingest the paper at your arXiv URL or local PDF path into the wiki, optionally adding the --discover flag to get related-paper suggestions.

Frequently Asked Questions about ingest

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

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

Pass the arXiv URL as the source argument. The skill extracts the arXiv ID, downloads the TeX source via init_discovery.py, enriches metadata from Semantic Scholar, then creates the paper page plus linked concept, claim, and people pages with graph edges.

How to add a local PDF paper to a knowledge base?

Provide the local .pdf path as the source. The skill runs a preprocessing pipeline that recovers the title and arXiv ID, fetches original TeX source when available, or builds a synthetic .tex fallback under raw/tmp/ before ingesting.

Does the ingest skill avoid creating duplicate concepts?

Yes. Before creating any concept or claim it calls find-similar-concept or find-similar-claim and merges into the top match when the similarity score is 0.80 or higher. Per-paper creation limits cap new entities based on paper importance.

What happens if Semantic Scholar is down during ingest?

The ingest degrades gracefully: it skips S2 enrichment, defaults the paper importance to 3, skips citation backfill, and notes the provisional importance in the final report. The paper page is still created.

Can multiple papers be ingested in parallel safely?

Yes. In INIT MODE the parent /init runs each ingest in an isolated git worktree. Shared files like edges.jsonl, citations.jsonl, index.md, and log.md are written only through append-only tool commands, and slugs are allocated deterministically.

When should I not create a new concept page during ingest?

Avoid creating a concept when a similar one scores above 0.40 without a clear technical distinction, when the candidate matches a foundation (link it as derived_from instead), or when the per-paper creation limit is reached. Merge or defer to /check instead.