Agent skill

Omh Paper Learning

by rlaope in rlaope/oh-my-hermes

[omh] Paper or paper PDF to understand: explain a supplied paper or paper/PDF at a selected level while preserving full section coverage and source evidence boundaries.

MITAuto-check passedDocuments & Office

Install Omh Paper Learning

skills CLI
$ npx skills add rlaope/oh-my-hermes --skill omh-paper-learning -a claude-code

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

GitHub CLI
$ gh skill install rlaope/oh-my-hermes omh-paper-learning --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/rlaope/oh-my-hermes.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/omh-paper-learning .claude/skills/omh-paper-learning && 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
omh-paper-learning
GitHub stars
3.2k
Token cost
~2.2k tokens
SKILL.md length
1,083 words
Files
1
Skills in repo
143
Repo updated
First seen
Licence
MIT

At a glance

[omh] Paper or paper PDF to understand: explain a supplied paper or paper/PDF at a selected level while preserving full section coverage and source evidence boundaries.

  • The user says: paper-learning
  • SKILL.md covers Why This Exists, Do Not Use When, Examples and Completion Checklist, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Paper-explainer

What it does

Omh Paper Learning is an agent skill from rlaope/oh-my-hermes. [omh] Paper or paper PDF to understand: explain a supplied paper or paper/PDF at a selected level while preserving full section coverage and source evidence boundaries. Use when the user says: paper-learning, paper learning, paper-explainer, paper explainer, paper explanation, explain this paper, explain this arxiv paper, paper walkthrough.

Its SKILL.md is about 2.2k 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 Documents & Office, covering PDF and Academic paper search. It works with arXiv. The repository describes itself as: All in one plugin for Hermes Agent ⚚ the coding intelligence, a long-term memory system and model optimized workflow packages. The licence is MIT.

When your agent uses it

  • The user says: paper-learning
  • Paper-explainer
  • Paper explainer
  • Paper explanation

Example prompts

  • “/omh-paper-learning”

What it can do on your machine

Read from SKILL.md and the folder at commit 7cd0d02. 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 (its code samples are bash).

    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

Omh Paper Learning loads about 2.2k tokens when it runs. Until then it costs about 90 tokens; SKILL.md has 1,083 words of instructions outside code blocks.

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

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 rlaope/oh-my-hermes at commit 7cd0d02, republished under its MIT licence (© rlaope). 1,083 words, ~2,241 tokens.

Download SKILL.mdSave it as .claude/skills/omh-paper-learning/SKILL.md (or your agent's skills folder).
name
omh-paper-learning
description
[omh] Paper or paper PDF to understand: explain a supplied paper or paper/PDF at a selected level while preserving full section coverage and source evidence boundaries. Use when the user says: paper-learning, paper learning, paper-explainer, paper explainer, paper explanation, explain this paper, explain this arxiv paper, paper walkthrough.

Paper Learning

This is a Hermes-native paper-learning workflow skill.

Why This Exists

paper-learning exists so Hermes can act like a strong human tutor for papers: choose the right explanation level, walk through the full paper section by section, and keep PDF extraction and validation evidence honest.

Do Not Use When

  • The request asks to export, convert, render, or package a file; use materials-package.
  • The request asks for daily/weekly paper monitoring, digest, source inbox, or Scout/Analyst/Briefer operations; use research-department.
  • The request asks to find current papers or sources when no supplied paper exists; use research.
  • The request asks for a visual/image card; use img-summary.
  • The request asks to implement or reproduce the paper's code; prepare a coding handoff only after a paper learning or reproduction plan is accepted.

Examples

Good example:

  • Prompt: paper-learning 이 논문 PDF를 아주 쉽게 설명해줘. 내용은 줄이지 말고 섹션별로.
  • Expected behavior: Prepare paper_learning_card/v1, ask or record level=very_easy, mark PDF extraction/source_state evidence, then explain section-by-section with a coverage ledger.
  • Why: The user supplied a paper/PDF explanation intent with an explicit level and coverage-preserving constraint.

Bad example:

  • Prompt: paper-learning 이 PDF를 PPT로 변환해서 공유용 파일 만들어줘.
  • Expected behavior: Route to materials-package because the user wants file conversion/export, not conceptual paper explanation.
  • Why: PDF file output and render QA are material packaging work, not paper learning evidence.

Completion Checklist

  • The selected explanation level is one of: very_easy, moderate, expert, choose.
  • The source_state is recorded and scoped to observed text or extraction evidence.
  • The coverage ledger lists observed, missing, or prepared sections before claiming completion.
  • The explanation is section-aware and does not compress away claims, equations, figures, limitations, or reproducibility notes.
  • Not-observed boundaries remain visible: full_pdf_extraction, figure_ocr, external_citation_check, math_proof_validation, code_or_benchmark_reproduction, peer_review_or_claim_correctness.

Recovery Notes

  • If no paper text is observed, prepare the learning card from metadata only and ask for an attachment, excerpt, or extraction evidence.
  • If only an abstract or excerpt is supplied, label the result as excerpt explanation and list missing sections.
  • If context is too long or the session ends mid-paper, continue section-by-section: record each chunk with omh paper progress and, in a new session, run omh paper list then omh paper show <paper_id> to resume from the recorded next section instead of re-reading from the abstract.
  • If the paper is longer than one read_file window, call omh_document_plan (action=plan with the pages, lines, and outline the first read showed) and walk its numbered ranges, marking each covered.
  • If the user asks for validation, citation checking, math proof review, or reproduction, create a separate observed-evidence or coding handoff path.

Workflow Lane

  • Current lane: Research and company ops (product-docs, source-finder, web-research, research, model-optimization, inference-serving, model-finetuning, research-brief, +20 more) - research, signals, ops, and briefings.
  • If intent belongs to another lane, hand back to oh-my-hermes or name the adjacent workflow.
  • Shared product, routing, compatibility, and evidence rules: omh-routing/references/skill-common-rail.md.

Use When

Use when Hermes should explain a supplied paper, arXiv entry, paper PDF, pasted excerpt, or extracted paper text at a selected level while keeping a coverage ledger instead of shrinking the paper into a lossy summary.

Strong routing signals: `paper-learning`, `paper learning`, `paper-explainer`, `paper explainer`, `paper explanation`, `explain this paper`, `explain this arxiv paper`, `paper walkthrough`, `research paper explanation`, `arxiv paper explain`, `pdf paper explain`, `paper pdf explanation`, `explain the attached paper`, `explain this pdf paper`, `without dropping details`, `very easy paper explanation`, `moderate paper explanation`, `expert paper explanation`, `논문 설명`, `논문 해설`, `논문 쉽게 설명`, `논문 아주 쉽게`, `논문 적당한 난이도`, `논문 전문가급`, `이 논문 설명해줘`, `이 논문 PDF 설명해줘`, `논문 PDF 쉽게 설명`, `논문 내용 줄이지 말고`
Show full SKILL.md (497 more words)Show less

Catalog Metadata

Category: research Phase: paper-learning Hermes role: researcher Quality tier: paper-learning-gated Reasoning demand: standard

Quality bar:

  • Ask for or state the explanation level before drafting: very easy, moderate, or expert.
  • Record source_state as one of: metadata_only, excerpt_text_observed, file_text_extraction_observed, full_text_observed, unknown_or_missing.
  • Preserve the coverage policy coverage_preserving_not_lossy_summary through a section-by-section ledger.
  • Explain by chunks when the source is long; keep each chunk linked to coverage_ledger status.
  • List missing sections and not-observed claims before presenting the explanation as complete.

Handoff policy:

Keep paper explanation in Hermes. Route file export to materials-package, current-source discovery to research, recurring monitoring to research-department, and reproduction or implementation to an accepted coding handoff only after the explanation plan is accepted.

Required inputs:

  • paper identity or attachment reference
  • observed text scope or extraction evidence
  • explanation level: very_easy, moderate, expert, or choose
  • coverage scope: full paper, selected sections, or supplied excerpt
  • output language when different from the source

Expected outputs:

  • paper_learning_card/v1
  • explanation level metadata
  • source_state boundary
  • coverage ledger
  • section-by-section explanation outline
  • missing-section and not-observed list

Artifact expectations:

  • record the card with omh paper plan --title <title> --source <path or url> --level <level> --source-state <state>, which writes paper_learning_card/v1 to $OMH_HOME/paper-learning/<paper_id>/card.json and hashes a local source file without parsing it
  • record each explained chunk with omh paper progress <paper_id> --covered <section> --next <section> [--missing <section>] [--note <text>], which updates the coverage ledger and appends one line to ledger.jsonl; omh paper validate checks the store

Safety rules:

  • Do not claim full PDF extraction, figure OCR, external citation checking, math validation, code reproduction, peer review, or full-paper coverage without observed evidence.
  • A pasted abstract or excerpt supports only excerpt explanation until the remaining sections are observed.
  • Level changes may change scaffolding, vocabulary, analogies, and critique depth, but must not drop substantive content.
  • End each chunk with covered / next / missing rather than done unless the coverage ledger is complete.

Runtime Evidence

Preferred harness for this skill: paper-learning.

sh
omh runtime record --skill paper-learning --harness paper-learning --status started

Record observed delegation results; otherwise return not_available or not_observed. Prepared OMH routing is not execution, review, CI, merge-readiness, or merge evidence.

  • Treat wrapper memory/context summaries as advisory local context, not proof of opaque Hermes memory reads or changes. Preserve workflow intent and stop conditions; verify before claiming completion. Reply in the user's own words and the host's own voice: its SOUL.md persona owns reply language, tone, speech level, and sentence endings, progress updates included (where it sets no language, use the one the user wrote in), and OMH shapes structure and content only; OMH's record terms (surface, lane, wrapper, handoff, evidence boundary, not_observed) stay in records and tool calls, never in the sentence the user reads unless they ask about one; and when a stop condition or a decision the user owns ends the turn, offer the next action as a question rather than declaring what will not be done.

Use Hermes-native subagent/delegation features when available: native subagents -> Hermes delegation when available, otherwise sequential lanes.

Shared product, compatibility, topology, memory, harness, and execution rules: omh-routing/references/skill-common-rail.md. Load it when applicable; otherwise name an unavailable capability.

© rlaope, 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/omh-paper-learning of rlaope/oh-my-hermes.

Open the folder on GitHubat commit 7cd0d02

Compare with similar skills

Omh Paper Learning 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.

Omh Paper Learning compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Omh Paper Learning this skillrlaope/oh-my-hermes3.2k—~2.2kAutomated safety check: PassMIT
Paper Interpretationdigoal/blog8.6k—~1.5kAutomated safety check: PassGPL-2.0
Paper LensYSQ-boop/paper-lens101—~1.3kAutomated safety check: PassApache-2.0
Paper Interpreterchujianyun/skills742—~810Automated safety check: PassCustom licence
Fulltext RetrievalAperivue/medsci-skills333—~1.9kAutomated safety check: PassMIT
Paper2htmlcnfjlhj/ai-collab-playbook454—~2.4kAutomated safety check: PassNone

Similar skills

  • 从论文 PDF 文件或论文 PDF URL 生成通俗易懂、图文并茂、带批判性评估的中文 Markdown 解读,并保存到当前项目的 markdown 目录。Use when the user asks to interpret,精读,解读,summarize,explain,analyze, or write an article from an academic paper PDF…

    8.6k GitHub stars~1.5k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Paper Lens

    YSQ-boop/paper-lens

    Read and critically analyze one academic paper from an arXiv URL/ID or a local PDF, producing a source-grounded Markdown report that can grow from a quick read into a reviewer-level deep review.

    101 GitHub stars~1.3k tokensUpdated 11 days ago
    Documents & OfficeAuto-check passed
  • Paper Interpreter

    chujianyun/skills

    论文解读助手。适用于用户发送 arXiv 论文链接,并希望下载论文、解读论文、生成读书笔记、做论文拆解或输出详细报告时使用。会在工作目录创建论文文件夹、下载 PDF 与 TeX Source(如有)、生成中文 Markdown 报告。默认先交付初稿,不自动复查;如果用户明确同意,再安排后续复查。不适用于只要简短推荐语的情况。

    742 GitHub stars~810 tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Fulltext Retrieval

    Aperivue/medsci-skills

    A skill your agent uses when you need full-text PDFs for a list of DOIs, such as a meta-analysis screening set.

    333 GitHub stars~1.9k tokensUpdated 4 days ago
    Documents & OfficeAuto-check passed
  • Paper2html

    cnfjlhj/ai-collab-playbook

    A skill your agent uses when turning an academic paper PDF/arXiv/OpenReview page/local LaTeX source into a single-file Chinese HTML deep-reading page, especially when the user wants a Cheat-Sheet…

    454 GitHub stars~2.4k tokensUpdated 25 days ago
    Documents & OfficeAuto-check passed
  • Paper Reading

    Edwardxlai/easyread

    论文共读:用 EasyRead(E:\CursorProject\easyread)这个本地工具读论文。用户给一篇 PDF 或 arXiv 编号时,导入文献库、翻译成中文(后台引擎或对话里的 agent 亲自译);之后边读边讨论,agent 读用户在页面上的笔记和提问,把回答、解释、原文核对提示追加到对应段落旁。用于…

    885 GitHub stars~567 tokensUpdated today
    Research & ScienceAuto-check passed

More from rlaope/oh-my-hermes

All 143 skills in this repo
  • Omh Accessibility Audit

    rlaope/oh-my-hermes

    [omh] Screen-reader or keyboard accessibility gaps: prepare WCAG, keyboard, focus, screen-reader, target-size, and reflow evidence gates for UI surfaces.

    3.2k GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • Omh Agent Evaluation

    rlaope/oh-my-hermes

    [omh] Choosing between coding agents on evidence: compare executor or agent choices on reproducible tasks using quality, cost, time, tool, and evidence metrics.

    3.2k GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Omh Agent Instructions

    rlaope/oh-my-hermes

    [omh] Agent instruction file for a repo -- AGENTS.md, CLAUDE.md, a Cursor rule: write or update what an agent cannot derive from the code, inside a marked region, with every command verified or…

    3.2k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Omh Agent Ops Review

    rlaope/oh-my-hermes

    [omh] AI agent progress for managers: help managers inspect AI-agent progress, blockers, quality gates, and throughput levers.

    3.2k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Omh AI Slop Cleaner

    rlaope/oh-my-hermes

    [omh] Messy or AI-generated code to clean up: delete AI-generated slop, dead code, and duplication while observable behavior stays identical.

    3.2k GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Omh App Debugging

    rlaope/oh-my-hermes

    [omh] Application code misbehaves -- a wrong value, a flaky test, a lost update: reproduce it first, form competing hypotheses, discriminate them with the cheapest observation, and only then fix the…

    3.2k GitHub stars~2.3k tokensUpdated today
    Auto-check passed

Works with

Questions about Omh Paper Learning

What does Omh Paper Learning do?

[omh] Paper or paper PDF to understand: explain a supplied paper or paper/PDF at a selected level while preserving full section coverage and source evidence boundaries. Omh Paper Learning is an agent skill from rlaope/oh-my-hermes. [omh] Paper or paper PDF to understand: explain a supplied paper or paper/PDF at a selected level while preserving full section coverage and source evidence boundaries.

When should I use Omh Paper Learning?

Omh Paper Learning fits situations like: the user says: paper-learning; paper-explainer; paper explainer; paper explanation.

How do I install Omh Paper Learning in Claude Code?

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

How do I install Omh Paper Learning in Codex?

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

Can I use Omh Paper Learning 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 rlaope/oh-my-hermes --skill omh-paper-learning -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/omh-paper-learning, .gemini/skills/omh-paper-learning, .github/skills/omh-paper-learning and .opencode/skills/omh-paper-learning in your project.

What does Omh Paper Learning need to run?

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

Does Omh Paper Learning 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 Omh Paper Learning 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 Omh Paper Learning use?

Omh Paper Learning 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 Omh Paper Learning use?

About 2.2k tokens (SKILL.md is roughly 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 Omh Paper Learning?

Skills that share tags, products or a category with Omh Paper Learning: Paper Interpretation (digoal/blog, 8.6k stars), Paper Lens (YSQ-boop/paper-lens, 101 stars), Paper Interpreter (chujianyun/skills, 742 stars) and Fulltext Retrieval (Aperivue/medsci-skills, 333 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Omh Paper Learning?

rlaope (a GitHub user) maintains it in rlaope/oh-my-hermes, which has 3,243 GitHub stars. The repository holds 143 skills in this directory. The repository was last updated on October 10, 2026.

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