Skip to content
Back to search

claude-paperloom

SkillWorks with Claude CodeGitHub

Claude Code Plugin for Self-maintaining research knowledge graph for Claude Code + Obsidian

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/trapoom555/claude-paperloom with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/trapoom555/claude-paperloom'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/trapoom555--claude-paperloom/badge.svg)](/listings/trapoom555--claude-paperloom)

HTML

<a href="/listings/trapoom555--claude-paperloom"><img src="/api/listings/trapoom555--claude-paperloom/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# 1. Install the plugin
claude --plugin-dir /path/to/claude-paperloom

# 2. Scaffold your vault (default ~/PaperLoom)
#    On first run, this creates `.venv` at the plugin root and installs
#    dependencies from `requirements.txt` automatically.
/paperloom:init

# 3. Ingest your first paper
/paperloom:ingest https://arxiv.org/abs/1706.03762

Open the vault folder in Obsidian and turn off Restricted Mode once to activate Dataview.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 92 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="docs/assets/paperloom-logo-wordmark-bg.svg" alt="claude-paperloom" width="520">
  3. </p>
  4. <p align="center">
  5. <em>A Claude Code Plugin for Self-maintaining research knowledge graph for Claude Code + Obsidian.</em>
  6. </p>
  7. <p align="center">
  8. <a href="LICENSE.txt"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License: Apache 2.0"></a>
  9. <a href="https://code.claude.com/docs/en/discover-plugins"><img src="https://img.shields.io/badge/Claude_Code-plugin-8B5CF6" alt="Claude Code"></a>
  10. <a href="https://obsidian.md"><img src="https://img.shields.io/badge/Obsidian-native-7C3AED" alt="Obsidian"></a>
  11. </p>
  12. <table align="center">
  13. <tr>
  14. <td align="center" width="50%">
  15. <img src="docs/assets/research-knowledge-graph.gif" alt="Research knowledge graph in Obsidian — yellow nodes are papers, green are findings, blue are fields, red are authors" width="100%">
  16. </td>
  17. <td align="center" width="50%">
  18. <img src="docs/assets/paper-info-page.gif" alt="Per-paper info page with 4-section summary, findings, and edges" width="100%">
  19. </td>
  20. </tr>
  21. <tr>
  22. <td align="center">
  23. <sub>
  24. Knowledge graph view — 🟡 papers · 🟢 findings · 🟣 fields · 🔴 authors. Example shown: <a href="https://opentyphoon.ai/blog/en">Typhoon.AI</a> research papers.
  25. </sub>
  26. </td>
  27. <td align="center">
  28. <sub>
  29. Per-paper info page — 4-section summary (incl. critique), atomic findings, metadata + quality scores, and typed edges to related work.
  30. </sub>
  31. </td>
  32. </tr>
  33. </table>
  34. **Keep every paper you care about. See how they connect.** Drop in a URL, arXiv ID, DOI, or PDF — Claude files it into an Obsidian vault, extracts the atomic claims, and wires them to everything you've read before with typed edges: `supports`, `contradicts`, `extends`, `uses`, `similar-to`.
  35. Based on [Andrej Karpathy's LLM Wiki pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f), tuned for research papers. **4 LLM calls per paper. Zero manual filing. Linking cost stays constant as the graph grows.**
  36. ---
  37. ## Features
  38. - **4-section triage summary per paper** — Key Takeaways → Background → Main Idea & Summary → **Critique**. The critique is generated by a reasoning model, so you get critical thinking, not a polite restatement of the abstract.
  39. - **Structured metadata + quality scores** — authors, venue, date, fields, and a quality assessment (credibility, experimental rigor, reproducibility) on every paper.
  40. - **Atomic findings as graph nodes** — one claim per file, with frontmatter and backlinks.
  41. - **Typed edges** — `supports`, `contradicts`, `extends`, `uses`, `similar-to`; auto-aggregated to paper-level (`cites`, `builds-on`, …).
  42. - **Deterministic citation matching** — arXiv ID → DOI → fuzzy title → first-author+year. The LLM never sees the reference list.
  43. - **Constant-cost linking** — pre-filter caps the LLM at ≤30 candidate findings, so the 100th paper costs the same as the 10th.
  44. - **Cross-paper contradiction surfacing** — bidirectional, with a pre-built Dataview view.
  45. - **Pre-built Dataview views** — by-author, by-field, contradictions, high-credibility, recent-papers.
  46. - **Obsidian-native** — plain wikilinks + YAML frontmatter, no custom app, no lock-in.
  47. ---
  48. ## Quick Start
  49. ```bash
  50. # 1. Install the plugin
  51. claude --plugin-dir /path/to/claude-paperloom
  52. # 2. Scaffold your vault (default ~/PaperLoom)
  53. # On first run, this creates `.venv` at the plugin root and installs
  54. # dependencies from `requirements.txt` automatically.
  55. /paperloom:init
  56. # 3. Ingest your first paper
  57. /paperloom:ingest https://arxiv.org/abs/1706.03762
  58. ```
  59. Open the vault folder in Obsidian and turn off Restricted Mode once to activate Dataview.
  60. ---
  61. ## Commands
  62. | You run | Claude does |
  63. |---|---|
  64. | `/paperloom:init [path]` | Scaffold the vault. Idempotent. Seeds Dataview. |
  65. | `/paperloom:ingest <url\|arxiv-id\|doi\|pdf>` | Fetch, summarize, extract findings, link. Skips if already in vault. |
  66. | `/paperloom:query <question>` | Search + synthesize across the vault with wikilink citations. |
  67. | `/paperloom:lint` | Health check. Auto-wires near-duplicate findings with bidirectional `similar-to`. |
  68. ---
  69. ## Docs
  70. - [Pipeline](docs/pipeline.md) — the 4-LLM-call ingest pipeline, section detection, models, token cost.
  71. - [Linking](docs/linking.md) — five-layer linking, relation types, paper-level aggregation.
  72. - [Architecture](docs/architecture.md) — vault layout, plugin structure, design principles, out-of-scope.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.