Skip to content

GeoGeekLab/nature-reviewer-skills / nature-chemistry-reviewer-skill

nature-chemistry-reviewer

Verified

Nature-style chemistry manuscript reviewer skill for testing synthesis, catalysis, chemical biology, molecular/materials chemistry and analytical claims against identity, purity, controls, selectivity, mechanism, scope, reproducibility and quantitative comparison.

# Nature Chemistry Reviewer Skill

![Version](https://img.shields.io/badge/version-2.2.0-blue)
![Package type](https://img.shields.io/badge/package-domain%20skill-4c1)
![Domain](https://img.shields.io/badge/domain-chemistry-brightgreen)
![License](https://img.shields.io/badge/license-MIT-yellow)

**Evidence-centered review for synthesis, characterization, catalysis, selectivity, analytical chemistry, mechanism, chemical biology, computation, and molecular claims.**

This package is one of the seven foundational domain reviewer skills in
[Nature Reviewer Skills](https://github.com/GeoGeekLab/nature-reviewer-skills).

> The objective is not language polishing. The objective is to determine whether the manuscript's strongest scientific claims are supported by the evidence actually presented.

## Scientific value

Chemistry manuscripts can fail when molecular identity, purity, controls, analytical assignments, catalytic metrics, reaction scope, or mechanistic interpretation do not support the headline claim. This skill audits the complete chain from chemical entity and measurement to mechanism, generality, and significance.

The skill is intended for pre-submission review, internal research-group red teaming, revision planning, reviewer-response preparation, and evidence-centered training for early-career researchers.

## Appropriate scope

Use this skill for:

- organic, inorganic, organometallic, supramolecular, and physical chemistry
- synthesis, reaction discovery, catalysis, selectivity, and scope studies
- analytical, spectroscopic, electrochemical, and mechanistic chemistry
- chemical biology, probes, biointerfaces, and molecular-function claims
- computational chemistry and experiment–theory interpretation
- chemistry at materials, energy, environmental, and biomedical interfaces

For interdisciplinary manuscripts, combine it with other domain skills or a relevant orchestrator rather than forcing all claims through one disciplinary lens.

## Core evidence gates

The gates are activated according to the manuscript's central claims; they are not applied as a mechanical checklist.

| Review area | What is stress-tested |
|---|---|
| **Identity and purity** | Structure assignment, composition, impurities, mixtures, stereochemistry, and orthogonal characterization |
| **Controls and analytical validity** | Blanks, standards, calibration, matrix effects, interferences, quantification, and assay validity |
| **Scope and selectivity** | Substrate selection, exclusions, yields, regio-/stereo-/chemo-selectivity, and practical limitations |
| **Catalysis and performance** | Turnover metrics, active species, normalization, stability, deactivation, mass transfer, and benchmark conditions |
| **Mechanism and causality** | Discriminating experiments, kinetics, isotope effects, intermediates, perturbations, and alternative pathways |
| **Computation and generalization** | Model assumptions, conformational and solvation effects, validation, uncertainty, and claim calibration |

The package contains **51 abstracted reviewer-reasoning patterns**. They support retrieval and review planning without reproducing raw referee reports.

## Expected review output

A standard run produces **2–4 complementary referee-style reports**, defaulting to three. Each report should:

1. identify the manuscript's central contribution and strongest claims;
2. distinguish direct evidence from derived products, models, correlations, mechanisms, and extrapolations;
3. anchor major concerns to figures, tables, methods, results, supplementary evidence, or explicit missing evidence;
4. explain why each concern matters to the central claim;
5. propose a proportionate resolution: additional analysis, stronger validation, a discriminating experiment, clearer uncertainty, or narrower wording;
6. separate major concerns from local reporting and presentation issues.

A major concern should follow this logic:

```text
claim under review
→ evidence or missing evidence
→ scientific risk
→ alternative explanation or failure mode
→ actionable revision path
```

## Use with an agent runtime

Clone the suite and install the shared runtime:

```bash
git clone https://github.com/GeoGeekLab/nature-reviewer-skills.git
cd nature-reviewer-skills
python -m pip install -e ".[documents]"
```

Point the agent runtime to:

```text
nature-chemistry-reviewer-skill/SKILL.md
```

For runtimes using `.agents/skills`, copy the complete package directory and keep `SKILL.md`, `reviewer_db/`, `references/`, `templates/`, and `scripts/` together.

Invoke the skill as:

```text
$nature-chemistry-reviewer
```

Example request:

```text
Use $nature-chemistry-reviewer to review the manuscript and supporting information. Test identity, purity, characterization, controls, analytical validity, reaction scope, selectivity, catalytic metrics, mechanism, computational assumptions, reproducibility, novelty, and claim calibration.
```

## Package contents

```text
README.md                         user-facing overview
SKILL.md                          agent instructions and review workflow
MANIFEST.json                     version, type, runtime, and pattern metadata
reviewer_db/patterns.jsonl        canonical reviewer-pattern database
reviewer_db/patterns.csv          tabular reviewer-pattern export
reviewer_db/summary.json          pattern and gate statistics
references/                       evidence protocol, domain gates, and evaluation contract
templates/review_report.md        report structure
scripts/                          validation, retrieval, extraction, and DOCX rendering wrappers
tests/                            package-level regression tests
checksums.sha256                  package integrity manifest
```

## Validation and reviewer-memory search

From the repository root:

```bash
python scripts/validate_all.py
python -m pytest
```

Validate this package directly:

```bash
nature-reviewer-validate "nature-chemistry-reviewer-skill"
```

Search its reviewer memory:

```bash
nature-reviewer-search \
  --root "nature-chemistry-reviewer-skill" \
  --query "describe the scientific concern to stress-test" \
  --limit 5
```

## v2.1 at a glance

Compared with the v1 generation, v2.1 provides:

- a shared, typed `nature_reviewer_core` runtime instead of duplicated package logic;
- field-weighted BM25 retrieval with phrase support, query expansion, confidence reporting, and diversity-aware selection;
- standardized manifests, package validation, checksums, tests, and benchmark contracts;
- safer manuscript extraction and report generation with explicit input and evidence boundaries;
- clearer multi-referee roles, evidence anchoring, severity calibration, and non-fabrication requirements.

These improvements strengthen consistency and auditability. They do not replace expert scientific judgment.

## Reliability boundary

This skill is a research-assistance and manuscript-quality-control tool. It does not:

- replace qualified domain experts, editors, or formal peer review;
- guarantee correctness, novelty, acceptance, or reproducibility;
- justify unsupported research-misconduct allegations;
- treat a model, retrieval, proxy, correlation, or benchmark as direct proof without validation.

The reviewer memory contains abstracted, non-verbatim reasoning patterns. Raw referee reports are not redistributed.

This project is not affiliated with Nature Portfolio or Springer Nature.

## License

Released under the [MIT License](LICENSE).
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 323kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 323kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 323kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall