Agent skill

Proofread

by flonat in flonat/flonat-research

Proofread a LaTeX academic paper across eleven language, notation, citation, and consistency categories.

MITAuto-check passedWriting & Content

Install Proofread

skills CLI
$ npx skills add flonat/flonat-research --skill proofread -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install flonat/flonat-research proofread --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/flonat/flonat-research.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/proofread .claude/skills/proofread && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
proofread
GitHub stars
145
Token cost
~2.1k tokens
SKILL.md length
697 words
Files
3 (incl. references)
Skills in repo
83
Repo updated
First seen
Licence
MIT

At a glance

Proofread a LaTeX academic paper across eleven language, notation, citation, and consistency categories.

  • Works in 4 steps: Locate files: Find all .tex files in the… → Read the document: Read all .tex source… → Run 11 check categories (below) → …
  • The requested task is bounded proofreading rather than substantive rewriting
  • SKILL.md covers Output Path, When to Use, When NOT to Use and Workflow, plus 8 more sections
  • Calls bash

What it does

Proofread is an agent skill from flonat/flonat-research. Proofread a LaTeX academic paper across eleven language, notation, citation, and consistency categories. Use when the requested task is bounded proofreading rather than substantive rewriting, clarity stress-testing, or venue compliance.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/check-categories.md` and `references/quality-rubric.md`).

It sits in Writing & Content, covering Copy editing and proofreading and LaTeX. It works with LaTeX. The repository describes itself as: Shareable Claude Code + Codex infrastructure for PhD researchers — skills, agents, hooks, and rules for academic workflows. The licence is MIT.

When your agent uses it

  • The requested task is bounded proofreading rather than substantive rewriting
  • Clarity stress-testing
  • Venue compliance

Example prompts

  • “/proofread”

Requirements

  • Pre-approved tools (allowed-tools): Read, Glob, Grep

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Locate files: Find all .tex files in the project (and .log files for LaTeX diagnostics)
  2. Read the document: Read all .tex source files in order
  3. Run 11 check categories (below)
  4. Produce report: Write reviews//proofread/.md under the project directory (where is the paper slug, e.g., paper-jtp; create the directory…

What it can do on your machine

Read from SKILL.md and the folder at commit da27600. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Glob
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • bash

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Proofread loads about 2.1k tokens when it runs, and up to ~5.7k if it reads all its reference files. Until then it costs about 62 tokens; SKILL.md has 697 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from flonat/flonat-research at commit da27600, republished under its MIT licence (© flonat). 697 words, ~2,101 tokens.

Download SKILL.mdSave it as .claude/skills/proofread/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
proofread
description
Proofread a LaTeX academic paper across eleven language, notation, citation, and consistency categories. Use when the requested task is bounded proofreading rather than substantive rewriting, clarity stress-testing, or venue compliance.
allowed-tools
Read, Glob, Grep
argument-hint
[project-path or tex-file]
skill-dependencies
devils-advocate

Academic Proofreading

Report-only skill. Never edit source files — produce reviews/<scope>/proofread/<YYYY-MM-DD-HHMM>.md only (where <scope> is the paper slug, e.g. paper-jtp).

Output Path

Per rules/review-artefact-routing.md (auto-loads in research projects (path-scoped to paper-*/ and paper/)):

  • Source slug: proofread
  • Write reports to: reviews/<scope>/proofread/YYYY-MM-DD.md inside the project, where <scope> is the paper slug (e.g., paper-jtp). Path is relative to the research project root, not the Task-Management repo.
  • Never at project root (./CRITIC-REPORT.md-style filenames are forbidden — pre-rule layout).
  • Idempotency: if today's file exists, append a same-day descriptor ({date}-revision.md, {date}-r2.md, {date}-pre-submission.md) — never overwrite.
  • Index update: if reviews/INDEX.md exists, write a one-line entry under "Latest per source" pointing at the new file. Otherwise review-recap will rebuild the index next time it runs.
  • Infrastructure repos (Task-Management, atlas-workspace, etc.): this section does not apply — the path-scoped rule won't load there.

When to Use

  • Before sending a draft to supervisors
  • Before submission to a journal/conference
  • After major revisions to check consistency
  • When you want a fresh-eyes check on writing quality

When NOT to Use

  • Formal audits — use the Referee 2 agent for systematic verification
  • Argument quality — use devils-advocate for logical scrutiny
  • Citation completeness — use an installed bibliography validator or direct cite-key cross-referencing (this skill flags only obvious citation-format issues)

Workflow

  1. Locate files: Find all .tex files in the project (and .log files for LaTeX diagnostics)
  2. Read the document: Read all .tex source files in order
  3. Run 11 check categories (below)
  4. Produce report: Write reviews/<scope>/proofread/<YYYY-MM-DD-HHMM>.md under the project directory (where <scope> is the paper slug, e.g., paper-jtp; create the directory if it does not exist: mkdir -p reviews/<scope>/proofread/). Do NOT overwrite previous reports — each review is timestamped to the minute. Canonical convention: the installed shared resource shared/review-state-schema.md.

Check Categories

Eleven categories, run in order. Full catalogue — every bullet, threshold, and worked example — in references/check-categories.md:

#Category#Category
1Grammar & Spelling7TikZ Diagram Review
2Notation Consistency8Numeric Text↔Table Cross-Check
3Citation Format9Causal Language Audit
4Academic Tone10Equation Completeness
5LaTeX-Specific Issues11aAnonymity (double-blind venues only)
6Citation Voice Balance11Preprint Staleness

Severity Levels

LevelDefinitionExample
CriticalWill be noticed by reviewers, may cause rejectionBroken references, major grammar errors, inconsistent core notation, text↔table number mismatch, causal overclaiming with weak design
MajorNoticeable quality issueInconsistent citation style, tone issues, overfull hbox > 10pt, undefined variable in equation, stale preprint, ambiguous "significant"
MinorPolish issueOccasional British/American mix, minor spacing, missing equation number for referenced equation
Show full SKILL.md (293 more words)Show less

Quality Scoring

Apply numeric quality scoring using the shared framework and skill-specific rubric:

Start at 100, deduct per issue found, apply verdict. Insert the Score Block into the report after the summary table.

Recurring Pattern Grouping

When the same issue appears 3+ times, group it as a single pattern finding instead of listing each instance separately. This prevents reports bloated with 50 individual items when the real message is "you have 3 recurring problems."

Format:

### M3: Hedge phrase "interestingly" (8 instances)
- **Category:** Academic tone
- **Locations:** lines 42, 67, 103, 145, 189, 203, 267, 301
- **Problem:** Filler hedge phrase adds no content
- **Fix:** Delete all 8 instances

One deduction for the pattern (not 8 separate deductions). Escalation still applies: 5+ instances of the same minor issue → one Major deduction.

Report Format

markdown
# Proofread Report

**Document:** [filename]
**Date:** YYYY-MM-DD
**Pages:** [approximate]

## Summary

| Category | Critical | Major | Minor |
|----------|----------|-------|-------|
| Grammar & spelling | 0 | 0 | 0 |
| Notation consistency | 0 | 0 | 0 |
| Citation format | 0 | 0 | 0 |
| Academic tone | 0 | 0 | 0 |
| LaTeX-specific | 0 | 0 | 0 |
| Citation voice balance | 0 | 0 | 0 |
| TikZ diagrams | 0 | 0 | 0 |
| Numeric cross-check | 0 | 0 | 0 |
| Causal language | 0 | 0 | 0 |
| Equation completeness | 0 | 0 | 0 |
| Preprint staleness | 0 | 0 | 0 |
| **Total** | **0** | **0** | **0** |

## Critical Issues

[List each with file, line/section, and specific issue]

## Major Issues

[List each with file, line/section, and specific issue]

## Minor Issues

[List each with file, line/section, and specific issue]

## Quality Score

| Metric | Value |
|--------|-------|
| **Score** | XX / 100 |
| **Verdict** | Ship / Ship with notes / Revise / Revise (major) / Blocked |

### Deductions

| # | Issue | Tier | Deduction | Category |
|---|-------|------|-----------|----------|
| 1 | [description] | [tier] | -X | [category] |
| | **Total deductions** | | **-XX** | |

## Recommendations

[Optional: overall observations about the writing — prioritise fixes by deduction size]

Council Mode (Optional)

For high-stakes pre-submission checks, run in council mode — 3 LLM providers independently run the 7 check categories, cross-review, and a chairman synthesises one PROOFREAD-REPORT.md. Trigger: "council proofread" / "thorough proofread". Full orchestration + invocation: ../shared/council-protocol.md.

Value: Diminishing returns for pure formatting — most valuable combined with citation-voice-balance and notation-consistency checks, where different models have genuinely different pattern recognition.

Log to REVIEW-STATE.md (final step)

After writing the proofread report, append a row to the project's REVIEW-STATE.md:

bash
bash <skills-root>/_shared/review-state-log.sh \
  --check proofread \
  --paper "<paper-{venue} dir>" \
  --verdict "<PASS|ISSUES FOUND>" \
  --open-issues "<total-issues-across-categories>/<total-issues-across-categories>" \
  --report "reviews/<scope>/proofread/<YYYY-MM-DD-HHMM>.md" \
  --notes "<one-line: e.g. '3 critical, 12 minor; mostly notation §3'>" \
  [--trigger "pre-submission-report|review-cluster"]
  • Verdict: PASS if no issues found across any category; ISSUES FOUND otherwise.
  • Open issues: total count across all 7 (or 11) check categories at run time.
  • Trigger: pass orchestrator name only if invoked via pre-submission-report or review-cluster. Otherwise omit.

Schema: the installed shared resource shared/review-state-schema.md.

Source format. Paper prose stays one line per paragraph; normalize edited files with .scripts/latex_paragraph_format.py --apply and recompile. Canonical: rules/latex-source-format.md.

Cross-References

  • Installed bibliography validator — For thorough bibliography cross-referencing and metadata checks
  • latex — For compilation and error resolution (run before proofreading to ensure the document compiles cleanly)
  • Referee 2 agent — For formal code + paper auditing
  • devils-advocate — For argument quality and logical scrutiny

© flonat, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/proofread of flonat/flonat-research.

  • SKILL.md
  • references/check-categories.md
  • references/quality-rubric.md

Open the folder on GitHubat commit da27600

Compare with similar skills

Proofread next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Proofread compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Proofread this skillflonat/flonat-research145—~2.1kAutomated safety check: PassMIT
Nature-Style Academic PolishingYuan1z0825/nature-skills46k—~1.5kAutomated safety check: PassApache-2.0
BeamerNoi1r/beamer-skill363—~13kAutomated safety check: NotesMIT
Pre Submission ReviewerHKUSTDial/Supervisor-Skills8.4k—~3.2kAutomated safety check: PassCC-BY-4.0
Research Paper Writing CoachXiaomiMiMo/MiMo-Code14k—~1.7kAutomated safety check: PassMIT
Paper Polishbrycewang-stanford/Auto-Empirical-Research-Skills4.5k—~7.3kAutomated safety check: NotesCustom licence

Similar skills

  • Nature-Style Academic Polishing

    Yuan1z0825/nature-skills

    Polishes, translates or tightens existing academic prose and fixes manuscript LaTeX layout while keeping facts, terminology and evidence boundaries intact.

    46k GitHub stars~1.5k tokensUpdated today
    Writing & ContentAuto-check passed
  • Beamer

    Noi1r/beamer-skill

    Beamer LaTeX slide workflow: create, compile, review, and polish academic presentations.

    363 GitHub stars~13k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check: notes
  • Pre Submission Reviewer

    HKUSTDial/Supervisor-Skills

    Runs a pre-submission review of a technical paper across five dimensions: macro logic, writing details, English grammar, LaTeX formatting, and figure quality.

    8.4k GitHub stars~3.2k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Research Paper Writing Coach

    XiaomiMiMo/MiMo-Code

    Drafts, rewrites and reviews academic papers in ML, CV and NLP style, section by section, and compiles LaTeX sources to PDF.

    14k GitHub stars~1.7k tokensUpdated 4 days ago
    Research & ScienceAuto-check passed
  • Paper Polish

    brycewang-stanford/Auto-Empirical-Research-Skills

    Proofread and verify academic papers in LaTeX. An agent skill from brycewang-stanford/Auto-Empirical-Research-Skills.

    4.5k GitHub stars~7.3k tokensUpdated 2 days ago
    Documents & OfficeAuto-check: notes
  • Nature Polishing

    aiskillstore/marketplace

    Polish, restructure, or translate academic prose into Nature-leaning English using writing-strategy principles, curated Nature/Nature Communications article patterns, and phrase-level support from…

    430 GitHub starsUsed in 1 repo~1.3k tokens
    Research & ScienceAuto-check passed

More from flonat/flonat-research

All 83 skills in this repo
  • Latex Posters

    flonat/flonat-research

    Create a large-format academic poster in LaTeX using beamerposter, tikzposter, or baposter.

    145 GitHub stars~1.5k tokensUpdated 8 days ago
    Auto-check: notes
  • Skill Creator

    flonat/flonat-research

    Create, revise, and evaluate reusable AI workflow skills, including trigger-quality tests.

    145 GitHub stars~4.4k tokensUpdated 8 days ago
    Auto-check passed
  • DOCX

    flonat/flonat-research

    Create, read, edit, or convert Microsoft Word documents while preserving professional document structure.

    145 GitHub stars~1.2k tokensUpdated 8 days ago
    Auto-check passed
  • PDF

    flonat/flonat-research

    Read, create, combine, split, rotate, OCR, watermark, secure, or extract content from PDF files.

    145 GitHub stars~488 tokensUpdated 8 days ago
    Auto-check passed
  • Init Project Orchestration

    flonat/flonat-research

    Create or migrate project-level agents, repeatable project workflows, and planning state from one client-neutral contract, then render repository-scoped adapters for both Claude Code and Codex.

    145 GitHub stars~1.6k tokensUpdated 8 days ago
    Auto-check passed
  • Pre Commit Audit

    flonat/flonat-research

    Deliver a fast pre-commit safety scan: file size, anonymity (author / affiliation strings in tex/bib), hardcoded secrets, and invisible-Unicode carriers.

    145 GitHub stars~2.8k tokensUpdated 8 days ago
    Auto-check: notes

Works with

Questions about Proofread

What does Proofread do?

Proofread a LaTeX academic paper across eleven language, notation, citation, and consistency categories. Proofread is an agent skill from flonat/flonat-research. Proofread a LaTeX academic paper across eleven language, notation, citation, and consistency categories.

When should I use Proofread?

Proofread fits situations like: the requested task is bounded proofreading rather than substantive rewriting; clarity stress-testing; venue compliance.

How do I install Proofread in Claude Code?

Run `npx skills add flonat/flonat-research --skill proofread -a claude-code`. Or copy the skill folder (skills/proofread in flonat/flonat-research) into .claude/skills/proofread in your project. Claude Code loads it when a task matches its description.

How do I install Proofread in Codex?

Run `npx skills add flonat/flonat-research --skill proofread -a codex`. Or copy the skill folder (skills/proofread in flonat/flonat-research) into .agents/skills/proofread in your project. Codex loads it when a task matches its description.

Can I use Proofread in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add flonat/flonat-research --skill proofread -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/proofread, .gemini/skills/proofread, .github/skills/proofread and .opencode/skills/proofread in your project.

What does Proofread need to run?

Going by SKILL.md and its folder, Proofread needs the command-line tools its instructions call (bash). Its frontmatter pre-approves these tools: Read, Glob, Grep.

Does Proofread access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Proofread safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Proofread use?

Proofread is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Proofread use?

About 2.1k tokens (SKILL.md is roughly 8.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.6k tokens, read only when the agent opens those files.

What are the alternatives to Proofread?

Skills that share tags, products or a category with Proofread: Nature-Style Academic Polishing (Yuan1z0825/nature-skills, 46k stars), Beamer (Noi1r/beamer-skill, 363 stars), Pre Submission Reviewer (HKUSTDial/Supervisor-Skills, 8.4k stars) and Research Paper Writing Coach (XiaomiMiMo/MiMo-Code, 14k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Proofread?

flonat (a GitHub user) maintains it in flonat/flonat-research, which has 145 GitHub stars. The repository holds 83 skills in this directory. The repository was last updated on September 29, 2026.

Source: flonat/flonat-research on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.