GeoGeekLab/nature-reviewer-skills / nature-materials-science-reviewer-skill
nature-materials-science-reviewer
VerifiedNature-style materials science manuscript reviewer skill for testing materials design, synthesis, processing, structure-property, mechanism, stability, scalability, computational prediction and application claims against materials evidence chains.
| File | Kind | Size |
|---|---|---|
| LICENSE | other | 1.1 KB |
| MANIFEST.json | config | 366 B |
| README.md | markdown | 7.5 KB |
| SKILL.md | skill md | 14.3 KB |
| checksums.sha256 | other | 1.7 KB |
| docs/SECURITY.md | markdown | 114 B |
| examples/evaluation_prediction.json | config | 260 B |
| references/claim_evidence_protocol.md | markdown | 550 B |
| references/domain_gate.md | markdown | 164 B |
| references/evaluation_contract.md | markdown | 306 B |
| requirements-dev.txt | markdown | 24 B |
| reviewer_db/patterns.csv | other | 69.3 KB |
| reviewer_db/patterns.jsonl | other | 164.1 KB |
| reviewer_db/summary.json | config | 969 B |
| scripts/extract_text_with_anchors.py | script | 1.2 KB |
| scripts/render_review_docx.py | script | 971 B |
| scripts/reviewer_db.py | script | 1.6 KB |
| scripts/validate_package.py | script | 928 B |
| templates/review_report.md | markdown | 953 B |
| tests/test_package.py | script | 640 B |
README.md
View on GitHub# Nature Materials Science Reviewer Skill




**Evidence-centered review for materials synthesis, processing, identity, structure–property relations, performance, mechanism, stability, computation, scalability, and applications.**
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
Materials claims depend on a long evidence chain: synthesis and processing, material identity, representative structure, valid property measurement, mechanism, fair benchmarking, stability, and application boundaries. This skill tests every link and distinguishes intrinsic material behavior from device, protocol, or system effects.
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:
- structural, functional, soft, porous, polymeric, composite, nano-, bio-, and quantum materials
- synthesis, processing, fabrication, interfaces, defects, phases, and microstructure
- spectroscopy, microscopy, diffraction, tomography, scattering, and operando studies
- electrochemical, mechanical, optical, thermal, magnetic, adsorption, and transport properties
- DFT, molecular simulation, materials informatics, screening, and generative design
- energy, catalysis, separation, sensing, electronics, photonics, and biointerface applications
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 |
|---|---|
| **Synthesis and reproducibility** | Process windows, yields, batch consistency, sample history, fabrication, and failure modes |
| **Identity and structure** | Composition, phase, purity, defects, interfaces, morphology, assignment, and representative sampling |
| **Property measurement** | Protocol, calibration, normalization, geometry, sample preparation, uncertainty, and intrinsic versus system effects |
| **Controls and benchmarks** | Reference materials, state of the art, comparable conditions, architecture, loading, and reporting fairness |
| **Mechanism** | Convergent characterization, perturbations, operando evidence, alternative explanations, and structure–property causality |
| **Stability and application** | Degradation, cycling, environment, scale-up, processability, toxicity, cost, and real-use relevance |
The package contains **95 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-materials-science-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-materials-science-reviewer
```
Example request:
```text
Use $nature-materials-science-reviewer to review the manuscript and supplement. Test synthesis reproducibility, material identity, structure and spatial evidence, property metrics, controls, benchmark fairness, mechanism, stability, computational assumptions, scalability, and application claims.
```
## 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-materials-science-reviewer-skill"
```
Search its reviewer memory:
```bash
nature-reviewer-search \
--root "nature-materials-science-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).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |