paper-audit

What the source does

• FilesystemDeclared1 observation
• NetworkDeclared5 observations
• ShellNone observedNo commands run in the source
• DependenciesPinnedNothing floats
• SecretsNone foundNo keys in source

Five audit layers

Gates applied: no behavioural pass, no license.

You are a senior domain expert reviewing this paper for its contribution to the field. You evaluate whether the paper accurately represents existing knowledge, positions itself correctly within the li

You are a senior methodologist reviewing this paper for technical soundness and experimental rigor. You focus exclusively on whether the research design, statistical methods, and experimental setup ca

Audit 0.4.1 · source sha da871dac3b12 · 26 Oct 2026Report an issue or request a re-scan

• Publisherbahayonghang GitHub userOwner of the repository this skill is read from
• Source folderbahayonghang/academic-writing-skills/academic-writing-skills/paper-auditThe exact folder we audited
• LicenceNot declaredAs the repository states it
• Commit pinned for this verdictda871dac3b12A new audit runs when the source changes
• Repository statusNot archivedPushed today
• Sandboxed runNot runSkills are read, not executed; layer L4 is skipped

Its description: Reviewer-style audit and submission gate for academic papers in .tex, .typ, or .pdf. Use for peer-review critique, readiness/gate decisions, blocker triage, revision roadmaps, journal-style reports, re-audits, and…

---
name: paper-audit
description: Reviewer-style audit and submission gate for academic papers in .tex, .typ, or .pdf. Use for peer-review critique, readiness/gate decisions, blocker triage, revision roadmaps, journal-style reports, re-audits, and under-claim / self-weakening prose signals. Do not use for source editing, sentence polishing, bibliography search, or compile repair.
when_to_use: >-
  Trigger on "review my paper", "act as a reviewer", "simulate peer review", "audit this paper",
  "审稿", "投稿门控", "投稿前体检", "把把关", "看看能不能投", "出审稿意见",
  "is this ready to submit", or requests for major/minor issues and revision priorities.
metadata:
  category: academic-writing
  tags: [audit, deep-review, paper, pdf, latex, typst, chinese, english, reviewer, gate, re-audit]
  version: "6.0.0"
  last_updated: "2026-09-13"
argument-hint: "[paper.tex|paper.typ|paper.pdf] [--mode quick-audit|deep-review|gate|re-audit|polish] [--report-style deep-review|peer-review] [--focus full|editor|theory|literature|methodology|logic] [--venue VENUE] [--lang en|zh] [--previous-report PATH] [--literature-search] [--tavily-key KEY] [--s2-key KEY] [--scholar-eval] [--regression] [--overwrite-workspace] [--format md|json]"
allowed-tools: Read, Glob, Grep, Bash(uv *), Task
---

# Paper Audit Skill v6.0

`paper-audit` is **deep-review-first**: behave like a serious reviewer — find
technical, methodological, claim-level, and cross-section issues; keep
script-backed findings separate from reviewer judgment; return a structured
issue bundle plus a revision roadmap. Use it for audit and review, not as the
first tool for source editing, sentence rewriting, or build fixing.

A script-backed `PRESUBMISSION` layer handles final-week mechanical checks
(em dashes, AI-tone term frequency, abstract completeness, LaTeX
citation/label/equation hygiene, paragraph-shape weak signals, concrete
captions). It plugs into existing modes and is not a separate public mode;
see `references/PRESUBMISSION_GUIDE.md`.

**Requirements**: `.tex`/`.typ` audit needs only the Python standard library.
**PDF mode needs `pip install pymupdf`** (the `enhanced` extraction path also
needs `pymupdf4llm`); both are optional and lazily imported — a `.pdf` input
without them fails with a clear install hint.

**Install layout**: Full `.tex`/`.typ` script-backed checks resolve sibling
writing skills from the parent of this skill directory (`latex-paper-en/scripts`,
`latex-thesis-zh/scripts`, `typst-paper/scripts`). Recommended: keep all six
skill directories as siblings (`cover-letter`, `paper-audit`, `latex-paper-en`,
`latex-thesis-zh`, `typst-paper`, `bib-search-citation`). A single `paper-audit`
copy is **limited coverage**: missing sibling scripts are skipped and the
existing exit/gate behavior is unchanged (recorded standalone boundary:
missing=8, exit 0). Do not copy sibling scripts into `paper-audit/`.

## What This Skill Produces

- `quick-audit`: fast submission-readiness screen with script-backed findings, incl. `PRESUBMISSION`
- `deep-review`: reviewer-style structured issue bundle with major/moderate/minor findings
- `gate`: PASS/FAIL calibrated for submission blockers; `PRESUBMISSION` Major/Minor stay advisory
- `re-audit`: compare current issue bundle against a previous audit, incl. mechanical regressions
- `polish`: precheck-only handoff into a polishing workflow

The primary product is no longer just a score: the `deep-review` workspace
root contains exactly four reader-facing files — `review_report.md`,
`revision_suggestions.md`, and their HTML twins — with everything else under
`artifacts/`. Full artifact map and the `--lang en|zh` report-language rules:
`references/output-layout.md`.

## Do Not Use

- direct source surgery on `.tex` / `.typ`
- compilation debugging as the main task
- free-form literature survey writing
- paragraph-level related-work rewriting
- cosmetic grammar cleanup without an audit goal
- cover letter generation / optimization / claim alignment — route to `cover-letter`

## Critical Rules

- Don't rewrite the paper source — `paper-audit` is a reviewer, not an editor; switch skills explicitly if the user wants prose changes, so review evidence stays separable from edits.
- Don't fabricate references, baselines, or reviewer evidence — invented citations and made-up reviewer voices undermine every other finding in the bundle.
- Distinguish `[Script]` from `[LLM]` findings — script-backed items have a deterministic anchor the user can rerun, while LLM findings need a quote or section to be falsifiable.
- Anchor every reviewer finding to a quote, section, or exact textual location — unanchored complaints become impossible to audit on a re-pass.
- Be conservative with OCR noise, formatting quirks, and copy-editing trivia — flagging cosmetic noise inflates the report and buries the real issues.
- Read like a careful reader before flagging — understand the author's intended meaning first so the issue captures a real misread, not a strawman.
- For literature findings, judge whether the gap is evidence-backed and fairly positioned, and don't rewrite the prose inside `paper-audit` — keep prose rewrites in the format-specific writing skills.
- For method-interface review in `section_methods`, load its focus block in `references/SUBAGENT_TEMPLATES.md`; that block points to the authoritative method contract. Phase 0 adds the Methods-section logic pass only for English `.tex` and for `.typ` inputs; Chinese thesis method narration remains an explicit `latex-thesis-zh` `--method-narrative --section` workflow outside the automatic audit chain.
- For cross-subsection handoff review, load the `subsection_context_polish` focus block
  and `references/SUBSECTION_CONTEXT_PROTOCOL.md`. The lane is available to polish
  orchestration and to deep-review `full`/`logic` focus only; its neighboring window
  components are evidence, not additional rewrite targets.
- For `PRESUBMISSION`, map CRITICAL / MAJOR / MINOR to Critical / Major / Minor script seve

Excerpt, first 6,000 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.

uv run python -B "$SKILL_DIR/scripts/audit.py" <paper> --mode quick-audit ...
uv run python -B "$SKILL_DIR/scripts/audit.py" <paper> --mode deep-review ...
uv run python -B "$SKILL_DIR/scripts/audit.py" <paper> --mode gate ...
uv run python -B "$SKILL_DIR/scripts/audit.py" <paper> --mode re-audit --previous-report <path> ...
uv run python -B "$SKILL_DIR/scripts/diff_review_issues.py" <old_final_issues.json> <new_final_issues.json>
uv run python -B "$SKILL_DIR/scripts/audit.py" <paper> --mode polish ...

git clone https://github.com/bahayonghang/academic-writing-skills
git -C academic-writing-skills checkout da871dac3b12

Works in

1. 2026-10-26
   ✓SAFE B 89 / 100

   first audit · source da871dac3b12

Questions about paper-audit

• github.com/bahayonghang/academic-writing-skills/tree/main/academ — the audited source at commit da871dac3b12 and every finding aboveObserved · 26 Oct 2026

Spotted something wrong? Report a correction · Methodology