@spboucher/citation-check
Checks that every in-text citation in a Markdown or LaTeX manuscript has a bibliography entry, and the reverse.
- Latest version
- v1.0.1
- Licence
- MIT
- Updated
- 2 h ago
Peer-review protocol for LaTeX and Markdown manuscripts: deterministic audit script, five review roles, adversarial verification of findings, anchored rubric, referee report and decision letter templates.
Installing only copies or configures. Nothing is executed for you. The Skills CLI verifies the checksum before writing files.
Referee-style reading backed by the audit (Claude Code)
The skill runs its audit script on a test manuscript with planted defects, then reports the most serious problems with file and line. Real session, Claude Code 2.1.322 with Fable 5.2, with version 1.0.0 installed from this registry; inputs are test fixtures.
Use the manuscript-peer-review skill on paper.tex: run its audit script, then give me, as a referee would, the 5 most serious problems with file:line and the hygiene score. Do not edit anything. At most 14 lines.Referee-style reading backed by the audit (Codex)
The skill runs its audit script on a test manuscript with planted defects, then reports the most serious problems with file and line. Real session, Codex CLI 0.167.1 with GPT-6.1-Sol, with version 1.0.0 installed from this registry; inputs are test fixtures.
Use the manuscript-peer-review skill on paper.tex: run its audit script, then give me, as a referee would, the 5 most serious problems with file:line and the hygiene score. Do not edit anything. At most 14 lines.Screenshots supplied by the publisher. The registry serves them from the release archive and does not verify what they show.
An Agent Skill for reviewing a scholarly manuscript (LaTeX or Markdown) with a fixed protocol: a deterministic audit first, then five independent role reviews, adversarial verification of every finding, an anchored scoring rubric and an author-facing report.
The protocol exists to prevent the usual failures of machine-assisted review: findings that quote text which is not in the manuscript, references described without being opened, "wrong" where "not shown" was meant, and a long undifferentiated list in place of the two or three comments a decision turns on.
| Path | Purpose |
|---|---|
SKILL.md | The rules, the eight stages, the finding format, the limits |
references/roles.md | What each of the five roles reads for, and how to delegate them |
references/procedure.md | Each stage in detail, including verification and revision checks |
references/rubric.md | Seven dimensions, anchored levels, weights, caps, how to report scores |
references/templates.md | Intake note, referee report, decision letter, replication checklist, ledger, response table |
references/finding-codes.md | The 67 codes of the audit script and what to check before reporting each |
scripts/manuscript.mjs | Command-line audit tool, JSON or text output |
scripts/lib/ | The audit engine (shared with the manuscript-audit-mcp server) |
No dependencies beyond Node.js 20+. No network access, no API key, no LaTeX installation.
skills install @spboucher/manuscript-peer-review --client claude-code # or codex, cursor, generic-agent-skills
node scripts/manuscript.mjs audit paper.tex --text # every check
node scripts/manuscript.mjs audit paper.tex --root .. --min-severity warning
node scripts/manuscript.mjs citations paper.md --bib refs.bib
node scripts/manuscript.mjs scaffold paper.tex > report.md # report skeleton
node scripts/manuscript.mjs compare v1/paper.tex v2/paper.tex # revision check
node scripts/manuscript.mjs codes # all finding codes
Exit code 0 when no finding reaches the --fail-on level (default error), 2 when one does,
1 on a usage or read error. Files are read only from --root (default: the directory of the
manuscript), symbolic links included.
node --test skill-tests/ in the source repository: the skill follows the Agent Skills
specification, every referenced file exists, the engine is byte-identical to the MCP package
(whose own suite checks each audit against manuscripts with planted defects), the engine imports
nothing outside Node.js, and the command-line tool is exercised on the same fixtures (output,
exit codes, root confinement).
The protocol itself (roles, rubric, templates) is a method, not a measured instrument: no claim is made that its scores are calibrated against editorial outcomes.
MIT.
Select a file to preview it. Files are shown as plain text and never executed.
No advisory findings from static-1.0.0 on Nov 10, 2026. 9 informational notes.
Static checks are advisory. They never certify that a package is safe. Compatibility entries are publisher claims unless marked verified.
| Version | Published | Size | SHA-256 | State |
|---|---|---|---|---|
| 1.0.1latest | Nov 10, 2026 | 608 kB | 53816acf4153… | published |
| 1.0.0 | Nov 10, 2026 | 58 kB | 22e3044059e0… | published |
Adds screenshots of real Claude Code and Codex sessions (examples/). No code change.
Checks that every in-text citation in a Markdown or LaTeX manuscript has a bibliography entry, and the reverse.
Minimal example skill: greets the user and explains how Agent Skills are structured.
Build, audit and grade Excel model workbooks: layout standard, dependency-free command-line auditor (errors, hard-coded numbers, broken patterns, circular references, controls, stale values) and rubric-based grading aid.