# Peer Review

> Prepara borradores de revisión por pares acotados a la evidencia y evaluaciones estructuradas: autorización, selección de guías de reporte, afirmación-evidencia, métodos, estadística, reproducibilidad, ética y citas.

Fuente: https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/peer-review
Markdown: https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/peer-review.md

Repositorio: https://github.com/K-Dense-AI/scientific-agent-skills
Autor: K-Dense-AI
Licencia: MIT
Actualizado: el mes pasado
Coste de contexto: 91 tok instalada, 2.9k tok al activarse, 47.1k tok con todos los archivos del bundle
Bundle: 24 archivos, 184 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add K-Dense-AI/scientific-agent-skills --skill peer-review --agent claude-code
# Cursor
npx -y skills add K-Dense-AI/scientific-agent-skills --skill peer-review --agent cursor
# Codex
npx -y skills add K-Dense-AI/scientific-agent-skills --skill peer-review --agent codex
# Gemini CLI
npx -y skills add K-Dense-AI/scientific-agent-skills --skill peer-review --agent gemini
# Windsurf
npx -y skills add K-Dense-AI/scientific-agent-skills --skill peer-review --agent windsurf
# Cline
npx -y skills add K-Dense-AI/scientific-agent-skills --skill peer-review --agent cline
```

## Qué hace

- Prepara borradores de revisión por pares y evaluaciones estructuradas de manuscritos acotados a la evidencia
- Exige confirmar autorización, conflictos y política de la revista antes de leer o analizar contenido no publicado
- Selecciona la guía de reporte adecuada, mapea afirmaciones contra evidencia y audita métodos, estadística y reproducibilidad
- Separa comentarios a los autores de las notas confidenciales al editor y nunca anuncia una decisión editorial
- Usa CLIs locales deterministas, sin red ni LLM externo, para validar intake, matriz de evidencia y citas

## Cuándo usarla

- Se pide revisar de forma autorizada un manuscrito, protocolo, preprint o propuesta de investigación
- Hay que elegir la guía de reporte adecuada para un tipo de estudio
- Se necesita comprobar la alineación entre afirmaciones y evidencia, o auditar métodos/estadística/reproducibilidad
- Hay que planificar una respuesta a revisores o redactar comentarios de revisión

## Cuándo no

- La autorización del propietario del material (editor, autor o revista) no está confirmada: no debe leerse ni citarse el manuscrito

## Qué la activa

- "Ayúdame a revisar este manuscrito para la revista X"
- "¿Qué guía de reporte debo usar para este ensayo clínico?"
- "Comprueba si estas afirmaciones están respaldadas por la evidencia del paper"
- "Redacta un borrador de comentarios de revisión para este manuscrito"

## Antes de instalar

- Necesita Python 3.11+ con librería estándar; los scripts son locales, no llaman a red ni a servicios externos, y deben usarse solo con autorización confirmada del editor o autor.
- Necesita en el PATH: python3

## Archivos

- SKILL.md — 11 KB
- assets/citation_references_template.csv — 196 B
- assets/claim_evidence_matrix_template.csv — 745 B
- assets/reporting_checklist_template.csv — 968 B
- assets/reporting_guidelines.json — 13 KB
- assets/review_intake_template.json — 1 KB
- assets/review_scaffold_template.md — 3 KB
- assets/source_ledger.csv — 9 KB
- assets/statistical_reproducibility_template.json — 7 KB
- assets/study_profile_template.json — 197 B
- references/common_issues.md — 14 KB
- references/ethical_review_practice.md — 11 KB
- references/reporting_standards.md — 14 KB
- references/security_validation.md — 3 KB
- references/statistical_reproducibility.md — 11 KB
- references/tool_reference.md — 8 KB
- scripts/_common.py — 14 KB
- scripts/audit_citations.py — 7 KB
- scripts/audit_statistics_reproducibility.py — 10 KB
- scripts/generate_review_scaffold.py — 3 KB
- scripts/lint_review.py — 9 KB
- scripts/select_reporting_guidelines.py — 13 KB
- scripts/validate_claim_evidence.py — 7 KB
- scripts/validate_review_intake.py — 14 KB

## SKILL.md

Reproducido tal cual desde K-Dense-AI/scientific-agent-skills bajo MIT. Esta sección es el documento original y está en inglés.

# Peer Review

Support an accountable human reviewer with a rigorous, fair, actionable assessment. Treat every unpublished submission and review as confidential.

## Mandatory safety boundary

Before reading or analyzing unpublished content:

1. Confirm the user is authorized by the publisher, editor, author, or other material owner.
2. Check the target venue’s review, confidentiality, co-review, retention, and AI/tool policies.
3. Record conflicts, competence limits, requested scope, and specialist-review needs.
4. Default to local-only processing.

If authorization is unclear, do not inspect or quote the manuscript. Ask for confirmation or use only the bundled local CLIs, whose reports do not echo manuscript text.

Never:

- Send unpublished manuscript, supplement, review, or editorial text to an external service without specific publisher/author authorization and venue permission
- Upload confidential content to a public model, search engine, citation service, grammar tool, plagiarism checker, or image service
- Reuse content for training, benchmarking, product improvement, or unrelated research
- Read broad environment state, `.env` files, API keys, or credentials
- Call a network, LLM, or image API from bundled tools
- Invoke another skill or a PDF/image pipeline automatically
- Impersonate an assigned reviewer, editor, journal, funder, or author
- Fabricate manuscript details, review findings, citations, analyses, experiments, reproduction, or an editorial outcome
- Announce a decision that belongs to an editor or panel

Delete local copies and derivatives when policy requires; otherwise retain only what the controlling policy authorizes. Record deletion or retention without copying confidential content into the record.

Read `references/ethical_review_practice.md` before handling confidential material.

## Human accountability

Label generated text as a working draft. The accountable human must:

- Read the complete authorized submission and relevant supplements
- Verify every factual statement, calculation, citation, and manuscript location
- Resolve conflicts and disclose assistance as required
- Rewrite comments in their own expert judgment
- Submit through the authorized channel

Automated coverage, consistency, or lint results are not peer review and do not establish manuscript merit.

## Intake gate

Copy and complete `assets/review_intake_template.json`, then run:

```bash
python3 scripts/validate_review_intake.py completed-intake.json
```

Proceed only when status is `READY_FOR_LOCAL_REVIEW`.

The validator blocks:

- Undocumented authorization
- Missing human accountability
- Unassessed or unresolved conflicts
- Unknown review model or unchecked venue policy
- Unauthorized AI assistance
- External service use
- Data reuse
- Missing deletion/retention planning

It validates declarations, not their truth.

## Review workflow

### 1. Establish scope and available evidence

Record:

- Submission type and stage
- Review question and requested focus
- Target venue and review model
- Materials actually available: manuscript, supplements, protocol, registration, analysis plan, data/code statement, prior decision, or response letter
- Competence areas and limits
- Missing material that prevents assessment

Do not infer absent content. Use “not reported” or “not available for review.”

### 2. Orient without deciding

Create a short neutral map:

- Research question
- Population or system
- Design and unit
- Intervention, exposure, test, or model
- Comparator/reference
- Outcomes and timing
- Principal claims

Do not write an acceptance/rejection recommendation. Identify what evidence would be needed to evaluate each claim.

### 3. Select reporting guidance

Copy `assets/study_profile_template.json` and run:

```bash
python3 scripts/select_reporting_guidelines.py local-profile.json
```

For checklist coverage:

```bash
python3 scripts/select_reporting_guidelines.py \
  local-profile.json \
  --coverage local-coverage.csv
```

Use the current base guideline, explanation/elaboration, applicable extensions, and target venue policy. See `references/reporting_standards.md`.

**Critical distinction:** reporting completeness is not design quality, risk of bias, validity, or merit. Never convert missing items into an automatic score or publication judgment.

### 4. Map claims to evidence

Prioritize central, causal, mechanistic, safety, diagnostic, prediction, and generalization claims.

For each claim, record:

- Location and claim ID
- Supporting result, figure, table, analysis, or citation IDs
- Direction, magnitude, population, outcome, timepoint, and uncertainty alignment
- Limitation or alternative explanation
- Bounded requested action

Run:

```bash
python3 scripts/validate_claim_evidence.py local-claim-matrix.csv
```

Start from `assets/claim_evidence_matrix_template.csv`. The report emits IDs and counts, not claim text.

### 5. Review methods and statistics

Assess in this order:

1. Question and target quantity
2. Design and unit of inference
3. Sampling, allocation, controls, masking, and timing
4. Sample-size or precision rationale
5. Inclusion, exclusion, attrition, and missingness
6. Analysis–design alignment and assumptions
7. Multiplicity and prespecification
8. Effect estimates, uncertainty, denominators, and harms
9. Interpretation, causality, and generalizability

Use `references/common_issues.md` and `references/statistical_reproducibility.md`.

For a structured local audit:

```bash
python3 scripts/audit_statistics_reproducibility.py \
  local-statistics-reproducibility.json
```

Start from `assets/statistical_reproducibility_template.json`. Request specialist review when a central method exceeds competence; do not hide uncertainty behind a generic critique.

### 6. Review reproducibility and transparency

Check, as applicable:

- Protocol, registration, amendments, and analysis-plan consistency
- Data provenance, exclusions, transformations, and accession IDs
- Software, package, model, and parameter versions
- Code, environment, seeds, run instructions, and tests
- Data, code, materials, and model availability or justified restrictions
- Domain metadata standards

Do not claim reproduction unless authorized inputs were actually run with documented commands, environment, and outputs.

### 7. Review ethics and integrity

Check applicable approvals, consent, welfare, privacy, community governance, funding, sponsor role, conflicts, authorship/contribution, registration, biosafety, and dual-use concerns.

Describe observable evidence and uncertainty. Do not accuse authors or investigate them. Route credible concerns through the confidential editor channel under venue policy.

### 8. Review figures, tables, and citations

For figures and tables, assess:

- Consistency with text and supplements
- Denominators, units, axes, scales, uncertainty, and legends
- Accessible encoding and sufficient context
- Image acquisition/processing disclosure and source-data policy

This skill has no image-generation or PDF-conversion workflow. Use only user-authorized local artifacts and tools.

For Pandoc-style citations such as `[@ref-id]`:

```bash
python3 scripts/audit_citations.py local-manuscript.md local-references.csv
```

Start from `assets/citation_references_template.csv`. This checks key consistency and identifier format only; it does not verify that a source exists or supports a claim.

### 9. Draft actionable comments

Generate a private scaffold only after intake passes:

```bash
python3 scripts/generate_review_scaffold.py \
  completed-intake.json \
  -o private-review.md
```

Every major/minor comment should include:

- **Location**
- **Observation**
- **Evidence or criterion**
- **Why it matters**
- **Requested action**

Prioritize:

- Claim–evidence alignment
- Methods and statistical validity
- Reproducibility and transparency
- Ethics and participant/animal protection
- Reporting needed for appraisal
- Figures, tables, limitations, and citations

Requests for new work must be necessary to support a central claim and proportionate to scope. Offer narrowing, clarification, sensitivity analysis, correction, or limitation language when that is sufficient.

### 10. Keep channels separate

**Comments to authors** contain the scientific review, strengths, major/minor comments, and limitations.

**Confidential comments to editor** contain only policy-appropriate conflicts, competence limits, assistance disclosure, specialist requests, or substantiated integrity/process concerns that require a separate route.

Do not place ordinary criticism only in confidential notes. Do not reveal reviewer identity under an anonymized process.

### 11. Lint and finalize

```bash
python3 scripts/lint_review.py private-review.md
```

The linter checks channel separation, unresolved placeholders, a narrow abusive-language lexicon, role/decision phrases, and required actionability fields. It emits line numbers and rule IDs, not review text. Human tone and scientific review remain mandatory.

Before handoff:

- Verify all locations and evidence.
- Remove unsupported or speculative criticism.
- Confirm professional, non-abusive language.
- State review limits and specialist needs.
- Disclose permitted assistance.
- Remove all placeholders.
- Ensure no invented citation, experiment, reanalysis, or outcome.
- Follow the documented deletion/retention rule.

## Local tool index

- `scripts/validate_review_intake.py` — scope, authorization, conflicts, policy, handling
- `scripts/select_reporting_guidelines.py` — dated selector and non-scoring coverage audit
- `scripts/validate_claim_evidence.py` — claim/evidence alignment matrix
- `scripts/audit_statistics_reproducibility.py` — methods/statistics/reproducibility checklist
- `scripts/audit_citations.py` — local citation/reference consistency
- `scripts/generate_review_scaffold.py` — separated private Markdown scaffold
- `scripts/lint_review.py` — tone, channel, and actionability lint

Full schemas and exit codes: `references/tool_reference.md`.

## References and assets

- `references/ethical_review_practice.md` — COPE/ICMJE duties, confidentiality, AI, channels
- `references/reporting_standards.md` — current major guidelines and verified domain standards
- `references/statistical_reproducibility.md` — methods, statistics, and reproducibility review
- `references/common_issues.md` — contextual issue patterns and constructive responses
- `references/security_validation.md` — baseline remediation and local scan results
- `assets/source_ledger.csv` — authoritative sources verified 2026-07-23
- `assets/reporting_guidelines.json` — local selector catalog
- `assets/review_scaffold_template.md` — private structured draft

The source ledger is dated. Recheck live primary sources and the target venue policy for a later review, without exposing confidential manuscript text in search queries.

## Dónde encaja

- Categoría: [Investigación](https://skillsagentes.com/categorias/investigacion.md) — Investigación estructurada, búsqueda de fuentes y síntesis.
- Creador: [K-Dense-AI](https://skillsagentes.com/creators/k-dense-ai.md) — 163 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Citation Management](https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/citation-management.md): Gestión integral de citas académicas: busca en OpenAlex, PubMed y Google Scholar, extrae metadatos precisos, valida citas y genera entradas BibTeX correctamente formateadas.
- [Scientific Slides](https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/scientific-slides.md): Crea decks de diapositivas y presentaciones para charlas de investigación: PowerPoint, presentaciones de conferencia, seminarios, defensas de tesis. Da estructura, plantillas, guía de tiempos y validación visual.
- [Literature Review](https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/literature-review.md): Realiza revisiones bibliográficas sistemáticas y completas usando varias bases académicas (PubMed, arXiv, bioRxiv, Semantic Scholar). Genera markdown y PDF con citas verificadas en varios estilos (APA, Nature, Vancouver).
- [Infographics](https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/infographics.md): Crea infografías profesionales con Nano Banana Pro AI y refinamiento iterativo inteligente. Usa Gemini 3.6 Flash para revisar la calidad e integra investigación con Perplexity Sonar. Soporta 10 tipos, 8 estilos y paletas para daltonismo.
- [Latex Posters](https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/latex-posters.md): Crea pósteres de investigación profesionales en LaTeX con beamerposter, tikzposter o baposter, para conferencias y comunicación científica: layout, colores, columnas múltiples e integración de figuras.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)