init

Bootstraps a research wiki from local sources with planner-guided discovery and parallel paper ingest.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires deepxiv-sdk, and includes references (resource) components.

What problem does it solve? Turning a pile of local PDFs, notes, and web clippings into a structured, interlinked research wiki is slow and error-prone, especially when discovery, deduplication, and multi-paper ingestion must stay consistent. ## Core Features & Use Cases - Deterministic source preparation: Normalizes local PDFs into prepared sources under raw/tmp/ with strict title and arXiv ID recovery rules, recording warnings instead of aborting. - Planner-guided discovery: Builds a shortlist via Semantic Scholar, DeepXiv, and arXiv, then requires an explicit LLM trim to a final 8-10 paper set before fetching into raw/discovered/. - Parallel ingest with worktree isolation: Fans out one /ingest subagent per paper in git worktrees, then merges sequentially, deduplicates graph edges and citations, and rebuilds indexes. - Use Case: A researcher drops five PDFs into raw/papers/ plus notes in raw/notes/, runs /init with a topic, and receives a scaffolded wiki with provisional pages, discovered papers, and fully ingested paper pages with a checkpointed, resumable manifest. ## Quick Start Run /init with your research topic after placing your papers, notes, and web sources under the raw/ directory to bootstrap the wiki and ingest the final paper set in parallel.

Frequently Asked Questions about init

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

FAQPage Schema
How do I bootstrap a research wiki from local PDFs and notes?

Place papers under raw/papers/ and notes under raw/notes/, then run /init with an optional topic. The workflow prepares local sources, plans discovery, scaffolds wiki pages, and ingests the final paper set through parallel subagents.

How does the /init skill select which external papers to add?

The planner over-picks a shortlist using Semantic Scholar, DeepXiv, and arXiv signals, then the LLM explicitly trims it to a final 8-10 papers before fetch. Exact ranking weights and thresholds live in tools/init_discovery.py, not in the skill instructions.

Can I disable external paper discovery during wiki initialization?

Yes, pass --no-introduction, but only when you explicitly want local-only behavior. The fetch step still runs with zero external IDs so the source manifest .checkpoints/init-sources.json is written for downstream ingest.

What happens if a PDF cannot be decoded or its title recovered?

The prepare step records a warning in .checkpoints/init-prepare.json and continues. Without a confident title it falls back to filename or path arXiv-ID recovery, then to a synthetic .tex, keeping the original raw/papers/ path as the ingest fallback.

Why does /init fail when the repository is on a detached HEAD?

Parallel ingest relies on git worktrees branched from a named base branch, so a detached HEAD is rejected before fan-out. Switch to or create a named branch, then rerun the workflow.

How are conflicts handled when merging parallel ingest results?

Worktree branches merge sequentially on the base branch, with merge=union configured for log, index, and graph JSONL files. True concept or claim conflicts are merged conservatively, followed by dedup-edges, dedup-citations, index rebuilds, and linting.