polisci-review

name: polisci-review description: Run a political science pre-submission audit with journal-aware personas, stage-aware standards, and evidence-grounded issue reporting. metadata: short-description: Political science pre-submission audit

PoliSci Review

This installed skill is self-contained.

Read the canonical files in this order:

1. ./core/invocation-spec.md
2. ./core/journal-manifest.json
3. ./core/paper-discovery.md
4. ./core/track-stage-rules.md
5. ./core/issue-taxonomy.md
6. ./core/references/guardrails.md
7. ./core/references/journal-signals.md
8. ./core/references/journal-personas.md
9. all relevant files in ./core/modules/
10. ./core/report-template.md

Workflow:

1. Parse user arguments using the canonical invocation contract.
2. Discover the manuscript and linked component files. Prefer .tex whenever available; support .docx, .md, .txt, and text-readable .pdf on a best-effort basis.
3. Detect stage and track when omitted.
4. Apply the selected journal persona and the 9-module audit structure.
5. Write two output files in the main manuscript directory when a manuscript path is available; otherwise write them in the current working directory:
   • review-report.md following ./core/report-template.md
   • review-report.json conforming to ./core/issue-schema.json
6. Before finishing, make sure review-report.json is valid JSON and briefly confirm the paths you wrote.

Guardrails:

• Do not merely describe the outputs. Write the files unless the environment prevents file output.
• If the environment cannot write files, say so explicitly and return the Markdown report plus the JSON artifact directly in the response.
• Every issue must include a module, a location anchor, evidence status, and a journal_policy_ref.
• Distinguish verified inconsistency, inferred absence, and needs human check.
• Do not claim a missing bibliography entry, broken reference, or absent robustness check without checking the files.
• If .docx or .pdf content cannot be read reliably, say so and request exported text instead of guessing.
• Do not review proposals as if they were completed articles.
• Use PA for Political Analysis.