paper-graph

Paper Graph

Build a Markdown report with embedded Mermaid diagrams showing how research on a user-specified topic (or paper) evolved — clustered into challenges → solutions and traced as per-solution evolution paths.

The skill has no outbound LLM dependency. The host agent provides all LLM calls; the skill provides deterministic data fetchers (S2 / DeepXiv), prompt templates, markdown parsers, and Mermaid renderers. Run the runbook below step-by-step.

When to Use This Skill

Trigger when the user asks something like:

• "Show me the history of " / "How did evolve?"
• "Where does stem from?" / "What did build on?"
• "What are significant improvements / follow-ups to ?"
• "Trace the lineage of ideas in " / "Give me a literature taxonomy of "
• "Citation tree of " / "Idea trace of "

Skip when:

• The user just wants a one-paper summary or single search hit (no relational/evolutionary aspect).
• The request is for non-academic citation work.
• The user explicitly wants a plain bibliography rather than a graph.

---

Inputs and Output

Inputs:

• A research query: a topic, a seed paper title/citation, or a hybrid. Free-form text.
• Output path (required): path for the final Markdown report. If not given, ask before running.
• (Optional) number of papers to fetch (--n flag on fetch_papers). Default 10.
• (Optional) Mermaid theme light or dark (--theme on render steps, or MERMAID_THEME env). Default light.

Output: a single Markdown file at the user-specified path with these sections:

1. Research goal (extracted from the query)
2. High-level taxonomy — one Mermaid graph: root → challenges → solutions → paper references
3. Per-solution evolution paths — one Mermaid graph per solution, showing paper-to-paper "evolution from" edges, evolution points, open challenges
4. Paper appendix — the numbered list of papers with title / year / authors / abstract / conclusion excerpt