paper-audit — Claude Code skill: paper audits
A reviewer-style skill for checking academic papers before submission, with blocker triage and revision plans for .tex, .typ, and .pdf.
npx skills add bahayonghang/academic-writing-skills --skill paper-audit -a claude-codeWhat paper-audit does
paper-audit reviews an academic paper as a demanding peer reviewer. It checks technical and methodological issues, links between sections, claim support, and submission readiness. Available workflows cover a quick audit, deep review, a submission gate, re-audit, and a precheck handoff for polishing.
The skill keeps script-backed findings separate from reviewer judgement and anchors each issue to a quote, section, or exact text location. Its output includes a structured issue bundle and a revision roadmap. .tex and .typ checks use the Python standard library; PDF input needs pymupdf, while the enhanced extraction path also uses pymupdf4llm. PDF review fails without pymupdf.
Full .tex and .typ coverage can call sibling writing skills from the parent directory. When those directories are missing, some script checks are skipped, so a standalone copy has limited coverage.
What it helps with
- check whether a paper is ready for submission
- triage major and minor review findings
- locate gaps in methodology and reasoning
- turn audit results into a revision roadmap
- compare a new audit with an earlier report
Example prompts for the agent
- Run a deep review of
paper.texand write a reviewer-style report. - Use gate mode to assess whether
paper.pdfis ready for submission. - Re-audit
paper.typagainstprevious-report.mdand identify regressions.
How to install paper-audit
1Skills CLI (Vercel)
npx skills add bahayonghang/academic-writing-skills --skill paper-audit -a claude-code2Manually: put the files in place
~/.claude/skills/paper-audit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/paper-audit/
1Skills CLI (Vercel)
npx skills add bahayonghang/academic-writing-skills --skill paper-audit -a codex2Manually: put the files in place
.agents/skills/paper-audit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add bahayonghang/academic-writing-skills --skill paper-audit -a cursor2Manually: put the files in place
.cursor/skills/paper-audit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install bahayonghang/academic-writing-skills paper-audit2Manually: put the files in place
.github/skills/paper-audit/SKILL.md1Skills CLI (Vercel)
npx skills add bahayonghang/academic-writing-skills --skill paper-audit -a gemini-cli2Platform CLI
gemini skills install https://github.com/bahayonghang/academic-writing-skills --path academic-writing-skills/paper-auditManually: put the files in place
.devin/skills/paper-audit/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add bahayonghang/academic-writing-skills --skill paper-audit -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about paper-audit
How do I install paper-audit in Claude Code?
Run npx skills add bahayonghang/academic-writing-skills --skill paper-audit -a claude-code, then check ~/.claude/skills/paper-audit/SKILL.md.
What does paper-audit do?
It reviews papers like a peer reviewer, covering technical, methodological, logical, and claim-level issues. The result is a structured set of findings with priorities and a revision roadmap.
What is required to audit a PDF?
Install pymupdf with pip install pymupdf before using PDF mode. The enhanced extraction path also uses pymupdf4llm; .tex and .typ audits use the Python standard library.
