Skip to content

Yuan1z0825/nature-skills / skills/nature-academic-search

nature-academic-search

Flagged

Search literature across sources, verify or manage citations, and build MeSH strategies or citation-impact audits. Use for 文献检索、引文核对、参考文献管理、严格他引 and evidence-backed citer profiles; not for translating a paper or drafting manuscript prose.

FileKindSize
README.mdmarkdown2.6 KB
README_EN.mdmarkdown3.0 KB
SKILL.mdexecutableskill md3.5 KB
agents/openai.yamlconfig265 B
config/mcp-snippet.jsonconfig502 B
config/settings-snippet.jsonconfig59 B
config/triggers-academic-search.tomlconfig978 B
install.shexecutablescript4.3 KB
manifest.yamlconfig3.1 KB
mcp-server/README.mdmarkdown1.9 KB
mcp-server/academic_search_server.pyscript20.9 KB
mcp-server/config.tomlconfig249 B
mcp-server/requirements.txtmanifest134 B
mcp-server/sources/__init__.pyscript352 B
mcp-server/sources/arxiv.pyscript11.4 KB
mcp-server/sources/crossref.pyscript8.0 KB
mcp-server/sources/elsevier_common.pyscript2.4 KB
mcp-server/sources/pubmed.pyscript13.7 KB
mcp-server/sources/sciencedirect.pyscript6.9 KB
mcp-server/sources/scopus.pyscript19.0 KB
mcp-server/tests/__init__.pyscript40 B
mcp-server/tests/test_arxiv_error_entries.pyscript1.4 KB
mcp-server/tests/test_citation_errors.pyscript1.6 KB
mcp-server/tests/test_crossref_version_relations.pyscript3.3 KB
mcp-server/tests/test_elsevier_live.pyscript2.6 KB
mcp-server/tests/test_format_converter_hardening.pyscript4.2 KB
mcp-server/tests/test_mcp_tools.pyscript2.6 KB
mcp-server/tests/test_pubmed_parsing.pyscript4.4 KB
mcp-server/tests/test_scopus_empty_result.pyscript1006 B
mcp-server/tests/test_script_converters.pyscript2.9 KB
mcp-server/tests/test_sources.pyscript30.5 KB
mcp-server/utils/__init__.pyscript359 B
mcp-server/utils/config.pyscript1.4 KB
mcp-server/utils/errors.pyscript620 B
mcp-server/utils/logging.pyscript1.1 KB
references/citation-parser.mdmarkdown2.7 KB
references/dedup-engine.mdmarkdown1.9 KB
references/pubmed-28344011.bibexecutablescript3.3 KB
references/pubmed-28344011.nbibexecutablescript11.9 KB
references/pubmed-28344011.risexecutablescript3.4 KB
references/ris-bibtex-format.mdexecutablescript4.5 KB
references/search-strategy.mdexecutablescript2.0 KB
references/source-tiers.mdmarkdown2.7 KB
references/workflows/wf1-multi-source-search.mdmarkdown1.9 KB
references/workflows/wf2-citation-verification.mdmarkdown1.6 KB
references/workflows/wf3-mesh-strategy.mdmarkdown538 B
references/workflows/wf4-citation-file-mgmt.mdmarkdown1.9 KB
references/workflows/wf5-reference-mgmt.mdmarkdown1.5 KB
references/workflows/wf6-strict-other-citation-impact-audit.mdmarkdown11.2 KB
scripts/academic_search.pyscript23.2 KB
scripts/converters.pyscript18.5 KB
scripts/format-converter.pyscript19.5 KB
scripts/preflight.pyscript3.7 KB
static/core/routing-and-ops.mdmarkdown6.1 KB
static/core/tools.mdmarkdown3.0 KB

references/ris-bibtex-format.md

View on GitHub
# RIS and BibTeX Format Specifications

## Contents

- [RIS Format](#ris-format)
- [BibTeX Format](#bibtex-format)
- [ENW (EndNote Tagged) Format](#enw-endnote-tagged-format)
- [Text Escaping (ris_escape)](#text-escaping-ris_escape)
- [Format Selection Guide](#format-selection-guide)


## RIS Format

RIS is the standard import format for EndNote, Zotero, and most reference managers.

### Journal article template
```
TY  - JOUR
AU  - Last, First
AU  - Last2, First2
TI  - Article Title
JO  - Journal Name (full)
JA  - Journal Abbreviation
PY  - 2024
VL  - 10
IS  - 3
SP  - 123
EP  - 145
DO  - 10.1234/example
UR  - https://doi.org/10.1234/example
AB  - Abstract text
KW  - keyword1
KW  - keyword2
AN  - PMID:12345678
DB  - PubMed
ER  -
```

### MEDLINE-to-RIS field mapping

| MEDLINE tag | RIS tag | Notes |
|---|---|---|
| `PMID-` | `AN  - PMID:` | Accession number |
| `TI  -` | `TI  -` | Title |
| `AU  -` | `AU  -` | Last, First format |
| `JT  -` | `JO  -` | Full journal title |
| `TA  -` | `JA  -` | Journal abbreviation |
| `DP  -` | `PY  -` | Extract year only |
| `VI  -` | `VL  -` | Volume |
| `IP  -` | `IS  -` | Issue |
| `PG  -` | `SP  -` / `EP  -` | Split on `-` |
| `AB  -` | `AB  -` | Abstract |
| `MH  -` | `KW  -` | MeSH as keywords |
| `LID -` | `DO  -` | DOI (strip `[doi]` suffix) |
| `AID -` | `DO  -` | Alternative DOI field |
| `SO  -` | `JO  -` | Source (journal + date + vol + pages) |

### RIS record separator
Each record must end with `ER  -` followed by a blank line.

## BibTeX Format

### Journal article template
```bibtex
@article{pmid12345678,
  author  = {Last, First and Last2, First2},
  title   = {Article Title},
  journal = {Journal Name},
  year    = {2024},
  volume  = {10},
  number  = {3},
  pages   = {123--145},
  doi     = {10.1234/example},
  url     = {https://doi.org/10.1234/example},
  abstract = {Abstract text},
  pmid    = {12345678}
}
```

### Citation key convention
- Use `pmid` prefix + PMID: `pmid12345678`
- If no PMID: use `firstauthorYEAR` format, lowercase: `smith2024`
- If duplicate keys: append `a`, `b`: `smith2024a`

### MEDLINE-to-BibTeX field mapping

| MEDLINE tag | BibTeX field | Notes |
|---|---|---|
| `PMID-` | `pmid` | Custom field |
| `TI  -` | `title` | Wrap in `{...}` to preserve case |
| `AU  -` | `author` | `Last, First and Last, First` |
| `JT  -` | `journal` | Full journal title |
| `DP  -` | `year` | Extract 4-digit year |
| `VI  -` | `volume` | |
| `IP  -` | `number` | |
| `PG  -` | `pages` | Replace `-` with `--` |
| `AB  -` | `abstract` | |
| `LID -` / `AID -` | `doi` | Strip `[doi]` suffix |

### Required fields by entry type

**`@article`**: author, title, journal, year
**`@book`**: author/editor, title, publisher, year
**`@inproceedings`**: author, title, booktitle, year
**`@phdthesis`**: author, title, school, year

### BibTeX cleaning rules
- Remove unescaped `&` in author fields (replace with `\&`)
- Wrap titles with special characters in `{...}`
- Strip HTML tags from abstract
- Ensure consistent author separator: ` and `
- Sort entries alphabetically by citation key

## ENW (EndNote Tagged) Format

ENW uses percent-tagged fields for EndNote import. Supported by EndNote desktop and EndNote Web.

### Journal article template
```
%0 Journal Article
%T Article Title
%A Last, First
%A Last2, First2
%J Journal Name
%V 10
%N 3
%P 123-145
%D 2024
%R 10.1234/example
%U https://doi.org/10.1234/example
%X Abstract text
```

### MEDLINE-to-ENW field mapping

| MEDLINE tag | ENW tag | Notes |
|---|---|---|
| `TI  -` | `%T` | Title |
| `AU  -` | `%A` | Last, First format; one per author |
| `JT  -` | `%J` | Full journal title |
| `VI  -` | `%V` | Volume |
| `IP  -` | `%N` | Issue |
| `PG  -` | `%P` | Pages |
| `DP  -` | `%D` | Year only |
| `LID -` / `AID -` | `%R` | DOI |
| — | `%U` | URL (derived from DOI) |
| `AB  -` | `%X` | Abstract |

### EndNote import instruction

In EndNote: File > Import > File, choose the `.enw` file, set Import Option to EndNote generated XML or Tagged format, then import.

## Text Escaping (ris_escape)

Applied to all free-text fields (TI, AU, JO, N2/AB, KW) in RIS and ENW output:

- HTML tags stripped: `<sup>1</sup>` → `1`
- Whitespace normalized: multiple spaces/newlines → single space
- Leading/trailing whitespace trimmed
- Abstract truncated to 500 chars in RIS/ENW to keep records compact

## Format Selection Guide

| User says | Use format |
|---|---|
| "EndNote", ".enw" | ENW (EndNote tagged) or RIS |
| "Zotero" | RIS (Zotero imports RIS natively) |
| "LaTeX", "BibTeX", "Bib" | BibTeX (.bib) |
| "PubMed format", "MEDLINE", ".nbib" | .nbib (default) |
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 196kUpdated Claude CodeCodexVerifiedInstall