Agent skill

Paper Finder

by LigphiDonk in LigphiDonk/Oh-my--paper

Search existing paper notes by title, author, keyword, or research domain

MITAuto-check passedResearch & Science

Install Paper Finder

skills CLI
$ npx skills add LigphiDonk/Oh-my--paper --skill paper-finder -a claude-code

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

GitHub CLI
$ gh skill install LigphiDonk/Oh-my--paper paper-finder --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/LigphiDonk/Oh-my--paper.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/paper-finder .claude/skills/paper-finder && 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-finder
GitHub stars
739
Used in
1 other repo
Token cost
~741 tokens
SKILL.md length
271 words
Files
1
Skills in repo
27
Repo updated
First seen
Licence
MIT

At a glance

Search existing paper notes by title, author, keyword, or research domain

  • Works in 4 steps: Parse Query → Execute Search → Score Results → …
  • Research & Science work in your project
  • SKILL.md covers Canonical Summary, Trigger Rules, Resource Use Rules and Execution Contract, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Paper Finder is an agent skill from LigphiDonk/Oh-my--paper. Search existing paper notes by title, author, keyword, or research domain

Its SKILL.md is about 740 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Research & Science. The repository describes itself as: A Claude Code plugin that turns your terminal into an autonomous research lab — literature survey, experiment execution, paper writing, all in one pipeline. The licence is MIT.

When your agent uses it

  • Research & Science work in your project

Example prompts

  • “/paper-finder”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Parse Query
  2. Execute Search
  3. Score Results
  4. Display Results

What it can do on your machine

Read from SKILL.md and the folder at commit 6baece9. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    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

Paper Finder loads about 741 tokens when it runs. Until then it costs about 22 tokens; SKILL.md has 271 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from LigphiDonk/Oh-my--paper at commit 6baece9, republished under its MIT licence (© LigphiDonk). 271 words, ~741 tokens.

Download SKILL.mdSave it as .claude/skills/paper-finder/SKILL.md (or your agent's skills folder).
name
paper-finder
description
Search existing paper notes by title, author, keyword, or research domain
id
paper-finder
version
1.0.0
stages
survey
tools
read_file, search_project, write_file
summary
Search existing paper notes by title, author, keyword, or research domain
primaryIntent
research
intents
research
capabilities
search-retrieval
domains
cs-ai
keywords
paper-finder, paper search, search-retrieval, cs-ai, paper, finder, search, existing, notes, by, title, author

paper-finder

Canonical Summary

Search existing paper notes by title, author, keyword, or research domain

Trigger Rules

Use this skill when the user request matches its research workflow scope. Prefer the bundled resources instead of recreating templates or reference material. Keep outputs traceable to project files, citations, scripts, or upstream evidence.

Resource Use Rules

  • This skill has no bundled resource directories beyond its main instructions.

Execution Contract

  • Resolve every relative path from this skill directory first.
  • Prefer inspection before mutation when invoking bundled scripts.
  • If a required runtime, CLI, credential, or API is unavailable, explain the blocker and continue with the best manual fallback instead of silently skipping the step.
  • Do not write generated artifacts back into the skill directory; save them inside the active project workspace.

Upstream Instructions

You are the Paper Finder for Dr. Claw.

Goal

Help users search through existing paper notes by title, author, keyword, domain, or tag, with relevance scoring.

Workflow

Step 1: Parse Query

Determine search type: title, author, keyword, domain, or tag search. Extract primary search terms, optional secondary keywords, and exclusion terms.

Use Grep to search the papers directory:

  • Title search: search all .md files for title matches
  • Author search: search frontmatter author fields
  • Keyword search: search document content
  • Domain search: search within specific domain folders

Step 3: Score Results

  • Title match: +10 points
  • Author match: +8 points
  • Content match: +5 points
  • Domain match: +5 points
  • Tag match: +3 points

Step 4: Display Results

Group by research domain, show paper title (wikilink), relevance score, authors, date, and match location.

Usage

/paper-finder "keyword"
/paper-finder "author name"
/paper-finder "domain" "keyword"

Based on evil-read-arxiv — an automated paper reading workflow. MIT License.

© LigphiDonk, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/paper-finder of LigphiDonk/Oh-my--paper.

Open the folder on GitHubat commit 6baece9

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in LigphiDonk/Oh-my--paper, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Paper Finder 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.

Paper Finder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Paper Finder this skillLigphiDonk/Oh-my--paper7391 repos~741Automated safety check: PassMIT
Hypothesis Generationspacering-net/codeg3.9k14 repos~3.6kAutomated safety check: NotesMIT
GitHub Deep Researchbytedance/deer-flow84k4 repos~1.3kAutomated safety check: PassMIT
Nature Paper CardYuan1z0825/nature-skills47k2 repos~2.1kAutomated safety check: PassApache-2.0
Content Research Writerweapp-tailwindcss/weapp-tailwindcss1.9k25 repos~3.5kAutomated safety check: PassMIT
Last30daysmvanhorn/last30days-skill64k—~7.9kAutomated safety check: NotesMIT

Similar skills

  • Hypothesis Generation

    spacering-net/codeg

    Structured hypothesis formulation from observations. An agent skill from spacering-net/codeg.

    3.9k GitHub starsUsed in 14 repos~3.6k tokens
    Research & ScienceAuto-check: notes
  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    84k GitHub starsUsed in 4 repos~1.3k tokens
    Research & ScienceAuto-check passed
  • Nature Paper Card

    Yuan1z0825/nature-skills

    Builds a structured deep-reading card for one scientific paper, covering methods, how experiments support claims, limitations and research ideas, with a script to prepare the source.

    47k GitHub starsUsed in 2 repos~2.1k tokens
    Research & ScienceAuto-check passed
  • Content Research Writer

    weapp-tailwindcss/weapp-tailwindcss

    Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section.

    1.9k GitHub starsUsed in 25 repos~3.5k tokens
    Research & ScienceAuto-check passed
  • Last30days

    mvanhorn/last30days-skill

    Research what people actually say about any topic in the last 30 days.

    64k GitHub stars~7.9k tokensUpdated yesterday
    Research & ScienceAuto-check: notes
  • Peer Review

    spacering-net/codeg

    Structured manuscript/grant review with checklist-based evaluation.

    3.9k GitHub starsUsed in 17 repos~5.9k tokens
    Research & ScienceAuto-check: notes

More from LigphiDonk/Oh-my--paper

All 27 skills in this repo
  • Preprint Search on bioRxiv

    LigphiDonk/Oh-my--paper

    Searches bioRxiv life sciences preprints by keyword, author, date range or category with a Python script, returning JSON metadata and optional PDF downloads.

    739 GitHub starsUsed in 12 repos~3.7k tokens
    Auto-check passed
  • Literature PDF OCR Library Builder

    LigphiDonk/Oh-my--paper

    Searches and downloads legally accessible academic PDFs, OCRs them to Markdown, and organizes the results into a traceable, AI-readable literature library.

    739 GitHub stars~1.1k tokensUpdated 5 mo ago
    Auto-check passed
  • Inno Code Survey

    LigphiDonk/Oh-my--paper

    Finds and clones missing code repositories for a chosen research idea, then writes a survey that maps academic concepts to their implementations.

    739 GitHub stars~3.6k tokensUpdated 5 mo ago
    Auto-check passed
  • Turns experimental data such as CSV, JSON or TensorBoard logs into statistical significance tests, visualizations and a drafted Results section.

    739 GitHub stars~3k tokensUpdated 5 mo ago
    Auto-check passed
  • Citation Verification Guide

    LigphiDonk/Oh-my--paper

    Lays out principles for catching fake, mismatched, or inconsistently formatted citations in academic writing, checked through live web search.

    739 GitHub stars~2.2k tokensUpdated 5 mo ago
    Auto-check passed
  • Single-Cell Initial Analysis

    LigphiDonk/Oh-my--paper

    Runs a seven-step quality-control and exploration pipeline on scRNA-seq, CyTOF or flow cytometry data and writes a plain-language report of what it found.

    739 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed

Questions about Paper Finder

What does Paper Finder do?

Search existing paper notes by title, author, keyword, or research domain. Paper Finder is an agent skill from LigphiDonk/Oh-my--paper.

When should I use Paper Finder?

Paper Finder fits situations like: research & Science work in your project.

How do I install Paper Finder in Claude Code?

Run `npx skills add LigphiDonk/Oh-my--paper --skill paper-finder -a claude-code`. Or copy the skill folder (skills/paper-finder in LigphiDonk/Oh-my--paper) into .claude/skills/paper-finder in your project. Claude Code loads it when a task matches its description.

How do I install Paper Finder in Codex?

Run `npx skills add LigphiDonk/Oh-my--paper --skill paper-finder -a codex`. Or copy the skill folder (skills/paper-finder in LigphiDonk/Oh-my--paper) into .agents/skills/paper-finder in your project. Codex loads it when a task matches its description.

Can I use Paper Finder 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 LigphiDonk/Oh-my--paper --skill paper-finder -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-finder, .gemini/skills/paper-finder, .github/skills/paper-finder and .opencode/skills/paper-finder in your project.

What does Paper Finder need to run?

SKILL.md names no scripts, command-line tools or credentials: Paper Finder is instructions for the agent only.

Does Paper Finder access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Paper Finder 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. Review the folder before installing.

What licence does Paper Finder use?

Paper Finder is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Paper Finder use?

About 741 tokens (SKILL.md is roughly 3k 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 Paper Finder?

Skills that share tags, products or a category with Paper Finder: Hypothesis Generation (spacering-net/codeg, 3.9k stars), GitHub Deep Research (bytedance/deer-flow, 84k stars), Nature Paper Card (Yuan1z0825/nature-skills, 47k stars) and Content Research Writer (weapp-tailwindcss/weapp-tailwindcss, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Paper Finder?

LigphiDonk (a GitHub user) maintains it in LigphiDonk/Oh-my--paper, which has 739 GitHub stars. The repository holds 27 skills in this directory. The repository was last updated on April 15, 2026.

Source: LigphiDonk/Oh-my--paper on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.