SkillHub

Skills yuan1z0825 nature-skills

nature-reader

Use it when:
You want a full Chinese-English reader of a paper, not a summary, or source-grounded answers about it.
It does:
Detects the source format, anchors every block in a source map, then extracts and aligns text, figures, tables and equations.
You get:
A paper.md with paired Original/中文 blocks, a source_map.json, translation notes and an assets folder.
Keeps:
Equations unchanged and every block traceable to its place in the source.

Loads a shared terminology ledger from the repo's nature-shared support package; install it alongside. For PDF input it also loads a separate pdf skill for extraction and OCR guidance.

TL;DR

Creates a faithful bilingual reader of a paper rather than a summary. It detects the source format (text PDF, scanned PDF, HTML, a DOI/arXiv link to resolve, or pasted text) and loads the matching extraction guidance, then follows a source-map-first workflow: give every block a stable anchor, extract figures and tables, render equations, and translate prose for meaning while leaving math untouched. The output is paper.md with paired Original and 中文 blocks, a source_map.json of those anchors, a translation_notes.md and an assets folder, checked by a deterministic math validator before delivery, plus a reader.html preview only if you ask. If it cannot fully process the source it still produces a draft and labels the gaps, never switching to summary mode. A question about the paper or a requested excerpt gets just that, cited to the source, without rebuilding the reader. A shared terminology ledger from the repo's nature-shared package keeps recurring terms consistent, so install that package alongside it.

Summarizes the skill at d774add.

npx skills add https://github.com/yuan1z0825/nature-skills --skill nature-reader

skills.sh pageSource on GitHubAll skills from yuan1z0825/nature-skills

Total Downloads
15,900 on skills.sh, Nov 9, 2026
Repo stars
52,794 yuan1z0825/nature-skills
First seen
May 11, 2026 on skills.sh
Weekly Downloads
443
-58% over the 8 weeks to Nov 9
Weekly values
Week toInstalls
Sep 211,050
Sep 28832
Oct 5566
Oct 12703
Oct 19735
Oct 26653
Nov 2504
Nov 9443
Category
category:science

Research reproduction, financial data, charts and diagrams.
Type
type:workflow

A multi-step process the agent follows: interview, debug, run a TDD loop, review.
Effect
effect:local

Its own steps create or change files, git state or local tools.
Needs
needs:cli

A specific command-line tool or desktop app must be installed, such as gh, agent-browser, LibreOffice, Obsidian or a vendor CLI.
Publisher
by:community

Everyone else. Unverified vendor claims default to community.
Topics
researchpdf

SKILL.md

From yuan1z0825/nature-skills at d774add. Checked daily, last changed Nov 6, 2026.

Frontmatter
name: nature-reader
description: "Create source-grounded Chinese-English paper readers with aligned text, figures, tables, and equations. Use for 全文翻译、中英文对照、论文精读 or source-linked questions about a paper; respect a requested excerpt or question without generating a full reader."
metadata:
  version: "2.1.1"
  author: Community contribution, refactored into static/dynamic layers

Full-Paper Markdown Reader — Router

Routing protocol

First distinguish creating a reader from answering a question or translating an excerpt. For a source-linked question, read references/grounding-rules.md and inspect only the relevant source material; reuse existing source-map IDs when available. Do not regenerate the reader or require a full source map before answering. For an explicit excerpt request, apply extraction, translation, and grounding rules to that excerpt. The full-artifact workflow below applies when the user requests a reader or full-paper translation.

For a new task, load the core and matching resources below. Reuse already loaded guidance on follow-ups; load more only when the task needs it.

1. Load the manifest and the core layer

Read manifest.yaml. It declares the source_format axis, the allowed values, and the file paths each value maps to.

Also read every file listed under always_load. These hold the core principles, the reading workflow, and the output contract that apply to every reading job, plus the shared Terminology Ledger used to build the recurring-term table.

2. Detect the source format

Decide the source_format value using the manifest's detect: hint and the user's input:

  • pdf-text — selectable-text PDF. Default.
  • scanned-pdf — image-only or OCR-required PDF.
  • html — publisher or preprint HTML page.
  • doi-arxiv — a bare DOI or arXiv link that must be resolved first.
  • pasted-text — pasted prose or notes with no retrievable original layout.

State the detected value in one short line to the user before processing, so they can correct you cheaply. A source may map to more than one value (for example a DOI that resolves to a PDF); load the resolution fragment first, then the fragment for the resolved artifact.

3. Load the matching fragment(s)

Read the file mapped for the detected source_format. Do not read every fragment in static/. Load only what step 2 selected.

4. Build the reader using the loaded material

Apply the loaded fragments in this priority order:

  1. Core principles (core/principles.md) — bilingual reader by default, translate for meaning, never degrade to a summary, copyright caution.
  2. Source-format fragment — how to extract text, figures, and tables for this input.
  3. Reading workflow (core/workflow.md) — the six-step source-map-first process.
  4. Output contract (core/output-contract.md) — required files and the pre-response verification checklist.

Build the Terminology Ledger as you translate (../nature-shared/core/terminology-ledger.md); it becomes the paper.md recurring-term table and the source_map.json glossary.

If constraints prevent full processing, still create a draft reader and label missing pages, figures, or low-confidence crops in translation_notes.md. Do not switch to summary mode.

5. Reach for references only when needed

The files under references/ are deep references, not defaults. Open them on demand per the references.on_demand table in the manifest:

  • detailed figure/table cropping and placement → references/figure-extraction.md.
  • exact field schema for paper.md / source_map.json → references/output-spec.md.
  • equations, mathematical expressions, chemical formulae, or image-only formulae → references/equation-handling.md.
  • answering follow-up questions with source citations → references/grounding-rules.md.