Agent skill

Obsidian Paper Notes Search

by juliye2025 in juliye2025/evil-read-arxiv

Searches already-saved paper notes in a local Obsidian vault by title, author, keyword, tag, field or arXiv ID, and ranks the matches by relevance.

No licenceAuto-check passedResearch & Science

SKILL.md written in Chinese; this summary is our English description.

Install Obsidian Paper Notes Search

skills CLI
$ npx skills add juliye2025/evil-read-arxiv --skill paper-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install juliye2025/evil-read-arxiv paper-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/juliye2025/evil-read-arxiv.git skills-src && mkdir -p .claude/skills && cp -r skills-src/paper-search .claude/skills/paper-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
paper-search
GitHub stars
1.7k
Token cost
~481 tokens
SKILL.md length
103 words
Files
3 (incl. scripts)
Skills in repo
5
Repo updated
First seen
Licence
None found

At a glance

Searches already-saved paper notes in a local Obsidian vault by title, author, keyword, tag, field or arXiv ID, and ranks the matches by relevance.

  • Works in 3 steps: 搜索类型 → 提取搜索参数 → 确定搜索范围
  • Finding a previously saved paper note by title or author
  • SKILL.md covers 步骤1:解析搜索查询, 步骤2:执行搜索, 步骤3:处理搜索结果 and 步骤4:展示结果, plus 2 more sections
  • Runs Python scripts from its folder

What it does

Given a query, the agent first works out whether it is a title, author, keyword, field or tag search, pulls out the main required terms plus any optional or excluded keywords, and decides whether to search every field or one in particular. It then greps the Papers folder under 20_Research rather than reading full files, checking titles, the authors field in frontmatter, document content, or a field-specific folder depending on the search type.

Matches are scored by where the hit occurred: a title match counts for the most, an author or field match next, and a tag or content match less. Papers containing an excluded keyword are dropped, and results are grouped by research field with title, author, date, a link to the note and a relevance score, using wikilink-style links. If nothing matches, the agent suggests other keywords or widening the scope instead of returning an empty result.

When your agent uses it

  • Finding a previously saved paper note by title or author
  • Searching your paper vault by keyword or tag
  • Combining a field and a keyword to narrow a search

Example prompts

  • “搜索关键词 "大模型" 加上 "量化" 这两个词”
  • “搜索作者 "Yoshua Bengio" 的论文笔记”
  • “Find the paper note about diffusion models I saved last month.”

Requirements

  • An Obsidian vault with paper notes stored under 20_Research/Papers

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 搜索类型
  2. 提取搜索参数
  3. 确定搜索范围

What it can do on your machine

Read from SKILL.md and the folder at commit ef3a594. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Obsidian Paper Notes Search loads about 481 tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 103 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~51
When it runs · the whole SKILL.md, loaded when a task matches
~481

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 103 words (~481 tokens).

“You are the Paper Searcher for OrbitOS.”

— opening of SKILL.md by juliye2025
name
paper-search

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (scripts) in paper-search of juliye2025/evil-read-arxiv.

  • SKILL.md
  • agents/openai.yaml
  • scripts/paper_hunter.py

Open the folder on GitHubat commit ef3a594

Compare with similar skills

Obsidian Paper Notes Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Obsidian Paper Notes Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Obsidian Paper Notes Search this skilljuliye2025/evil-read-arxiv1.7k—~481Automated safety check: PassNone
Deeppapernote917Dhj/DeepPaperNote1.2k1 repos~5.9kAutomated safety check: PassMIT
Lit ReviewGRIND-Lab-Core/night_owl_research_agent106—~3.2kAutomated safety check: PassNone
Nature Readerjing1312/nature-figure-skill171—~2.8kAutomated safety check: PassMIT
Zotero Obsidian BridgeGalaxy-Dawn/claude-scholar5.7k—~514Automated safety check: PassMIT
Read arXiv Paperkarpathy/nanochat59k1 repos~494Automated safety check: PassMIT

Similar skills

  • Deeppapernote

    917Dhj/DeepPaperNote

    Generate a high-quality deep-reading note for a single paper and write it into an Obsidian-style vault.

    1.2k GitHub starsUsed in 1 repo~5.9k tokens
    Research & ScienceAuto-check passed
  • Lit Review

    GRIND-Lab-Core/night_owl_research_agent

    Retrieves papers from local folder or ArXiv and Semantic Scholar using domain-aware keyword expansion, builds synthesis matrix, identifies gaps.

    106 GitHub stars~3.2k tokensUpdated 5 mo ago
    Research & ScienceAuto-check passed
  • Nature Reader

    jing1312/nature-figure-skill

    Build full-paper Chinese-English side-by-side, figure/table-aware, source-grounded Markdown readers for journal or conference papers from PDF, DOI, arXiv, publisher HTML, or pasted text.

    171 GitHub stars~2.8k tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed
  • Zotero Obsidian Bridge

    Galaxy-Dawn/claude-scholar

    Moves papers from Zotero into an Obsidian project knowledge base as source notes, literature synthesis and writing outputs, with evidence records behind every promoted claim.

    5.7k GitHub stars~514 tokensUpdated 18 days ago
    Research & ScienceAuto-check passed
  • Read arXiv Paper

    karpathy/nanochat

    Fetches the TeX source of an arXiv paper from its URL, reads it and writes a markdown summary tied to the nanochat project.

    59k GitHub starsUsed in 1 repo~494 tokens
    Research & ScienceAuto-check passed
  • Literature Review

    neflibata-feng/MyArxiv-Agent

    Conduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.).

    126 GitHub starsUsed in 20 repos~5.9k tokens
    Research & ScienceAuto-check: notes

More from juliye2025/evil-read-arxiv

  • Conference Paper Recommender

    juliye2025/evil-read-arxiv

    Searches DBLP for papers from top conferences such as CVPR, ICLR and NeurIPS, adds Semantic Scholar data, scores them and writes a yearly Obsidian note.

    1.7k GitHub stars~2.5k tokensUpdated 26 days ago
    Auto-check passed
  • Daily arXiv Paper Brief

    juliye2025/evil-read-arxiv

    Searches arXiv for recent papers matching your research interests, scores them and writes a daily recommendation note into an Obsidian vault.

    1.7k GitHub stars~4.3k tokensUpdated 26 days ago
    Auto-check passed
  • Paper and Web Source Analyzer

    juliye2025/evil-read-arxiv

    Analyzes arXiv papers, PDFs, project pages and blogs and writes an evidence-backed Obsidian note with images and a knowledge-graph entry.

    1.7k GitHub stars~715 tokensUpdated 26 days ago
    Auto-check passed
  • Paper Figure Extractor

    juliye2025/evil-read-arxiv

    Pulls architecture, method and result figures from an arXiv paper or PDF into an Obsidian vault and writes an index of them.

    1.7k GitHub stars~298 tokensUpdated 26 days ago
    Auto-check passed

Works with

Questions about Obsidian Paper Notes Search

What does Obsidian Paper Notes Search do?

Searches already-saved paper notes in a local Obsidian vault by title, author, keyword, tag, field or arXiv ID, and ranks the matches by relevance. Given a query, the agent first works out whether it is a title, author, keyword, field or tag search, pulls out the main required terms plus any optional or excluded keywords, and decides whether to search every field or one in particular. It then greps the Papers folder under 20_Research rather than reading full files, checking titles, the authors field in frontmatter, document content, or a field-specific folder depending on the search type.

When should I use Obsidian Paper Notes Search?

Obsidian Paper Notes Search fits situations like: finding a previously saved paper note by title or author; searching your paper vault by keyword or tag; combining a field and a keyword to narrow a search.

How do I install Obsidian Paper Notes Search in Claude Code?

Run `npx skills add juliye2025/evil-read-arxiv --skill paper-search -a claude-code`. Or copy the skill folder (paper-search in juliye2025/evil-read-arxiv) into .claude/skills/paper-search in your project. Claude Code loads it when a task matches its description.

How do I install Obsidian Paper Notes Search in Codex?

Run `npx skills add juliye2025/evil-read-arxiv --skill paper-search -a codex`. Or copy the skill folder (paper-search in juliye2025/evil-read-arxiv) into .agents/skills/paper-search in your project. Codex loads it when a task matches its description.

Can I use Obsidian Paper Notes Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add juliye2025/evil-read-arxiv --skill paper-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/paper-search, .gemini/skills/paper-search, .github/skills/paper-search and .opencode/skills/paper-search in your project.

What does Obsidian Paper Notes Search need to run?

Going by SKILL.md and its folder, Obsidian Paper Notes Search needs Python for the scripts in its folder. Our summary lists: An Obsidian vault with paper notes stored under 20_Research/Papers.

Does Obsidian Paper Notes Search access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Obsidian Paper Notes Search safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Obsidian Paper Notes Search use?

No licence was found for Obsidian Paper Notes Search or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Obsidian Paper Notes Search use?

About 481 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Obsidian Paper Notes Search?

Skills that share tags, products or a category with Obsidian Paper Notes Search: Deeppapernote (917Dhj/DeepPaperNote, 1.2k stars), Lit Review (GRIND-Lab-Core/night_owl_research_agent, 106 stars), Nature Reader (jing1312/nature-figure-skill, 171 stars) and Zotero Obsidian Bridge (Galaxy-Dawn/claude-scholar, 5.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Obsidian Paper Notes Search?

juliye2025 (a GitHub user) maintains it in juliye2025/evil-read-arxiv, which has 1,703 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on September 15, 2026.

Source: juliye2025/evil-read-arxiv on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.