Read-only proofreading pass over lecture .tex or .qmd files.

MITAuto-check passedWriting & Content

Install Proofread

skills CLI
$ npx skills add pedrohcgs/claude-code-my-workflow --skill proofread -a claude-code

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

GitHub CLI
$ gh skill install pedrohcgs/claude-code-my-workflow 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/pedrohcgs/claude-code-my-workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/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
1.6k
Token cost
~505 tokens
SKILL.md length
186 words
Files
1
Skills in repo
59
Repo updated
First seen
Licence
MIT

At a glance

Read-only proofreading pass over lecture .tex or .qmd files.

  • Works in 6 steps: Identify files to review → For each file, launch the proofreader… → Produce a detailed report for each file… → …
  • User says proofread
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Check for typos

What it does

Proofread is an agent skill from pedrohcgs/claude-code-my-workflow. Read-only proofreading pass over lecture .tex or .qmd files. Checks grammar, typos, overflow, terminology consistency, and academic writing quality; produces a report without editing. Use when user says "proofread", "check for typos", "look for grammar issues", "copy-edit this", "any writing errors?", or before a lecture release.

Its SKILL.md is about 510 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Copy editing and proofreading and LaTeX. The repository describes itself as: A ready-to-fork Claude Code template for academics using LaTeX/Beamer + R. Multi-agent review, quality gates, adversarial QA, and replication protocols. The licence is MIT.

When your agent uses it

  • User says proofread
  • Check for typos
  • Look for grammar issues
  • Any writing errors?

Example prompts

  • “proofread”
  • “check for typos”
  • “look for grammar issues”
  • “/proofread”

Requirements

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

Workflow steps

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

  1. Identify files to review
  2. For each file, launch the proofreader agent that checks for
  3. Produce a detailed report for each file listing every finding with
  4. Save each report to quality_reports/
  5. Leave source files unchanged — fixes are applied after the user reviews the report.
  6. Present summary to the user

What it can do on your machine

Read from SKILL.md and the folder at commit ae72617. 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
    • Grep
    • Glob
    • Write
    • Agent
    • Task

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    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 505 tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 186 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~86
When it runs · the whole SKILL.md, loaded when a task matches
~505

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 pedrohcgs/claude-code-my-workflow at commit ae72617, republished under its MIT licence (© pedrohcgs). 186 words, ~505 tokens.

Download SKILL.mdSave it as .claude/skills/proofread/SKILL.md (or your agent's skills folder).
name
proofread
description
Read-only proofreading pass over lecture `.tex` or `.qmd` files. Checks grammar, typos, overflow, terminology consistency, and academic writing quality; produces a report without editing. Use when user says "proofread", "check for typos", "look for grammar issues", "copy-edit this", "any writing errors?", or before a lecture release.
allowed-tools
Read, Grep, Glob, Write, Agent, Task
argument-hint
[filename or 'all']
disallowed-tools
Edit, MultiEdit

Proofread Lecture Files

Run the proofreading protocol on lecture files. This produces a report of all issues found WITHOUT editing any source files.

Steps

  1. Identify files to review:

    • If $ARGUMENTS is a specific filename: review that file only
    • If $ARGUMENTS is "all": review all lecture files in Slides/ and Quarto/
  2. For each file, launch the proofreader agent that checks for:

    GRAMMAR: Subject-verb agreement, articles (a/an/the), prepositions, tense consistency TYPOS: Misspellings, search-and-replace artifacts, duplicated words OVERFLOW: Overfull hbox (LaTeX), content exceeding slide boundaries (Quarto) CONSISTENCY: Citation format, notation, terminology ACADEMIC QUALITY: Informal language, missing words, awkward constructions

  3. Produce a detailed report for each file listing every finding with:

    • Location (line number or slide title)
    • Current text (what's wrong)
    • Proposed fix (what it should be)
    • Category and severity
  4. Save each report to quality_reports/:

    • For .tex files: quality_reports/FILENAME_report.md
    • For .qmd files: quality_reports/FILENAME_qmd_report.md
  5. Leave source files unchanged — fixes are applied after the user reviews the report. Only produce the report. Fixes are applied separately after user review.

  6. Present summary to the user:

    • Total issues found per file
    • Breakdown by category
    • Most critical issues highlighted

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

Files

Just SKILL.md in .claude/skills/proofread of pedrohcgs/claude-code-my-workflow.

Open the folder on GitHubat commit ae72617

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 skillpedrohcgs/claude-code-my-workflow1.6k—~505Automated safety check: PassMIT
Nature-Style Academic PolishingYuan1z0825/nature-skills46k—~1.5kAutomated safety check: PassApache-2.0
Proofreadflonat/flonat-research145—~2.1kAutomated safety check: PassMIT
Proofreadbrycewang-stanford/Auto-Empirical-Research-Skills4.5k—~1.5kAutomated safety check: PassCustom licence
Brief Compliance Checkflonat/flonat-research145—~1.7kAutomated safety check: PassMIT
BeamerNoi1r/beamer-skill364—~13kAutomated safety check: NotesMIT

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 yesterday
    Writing & ContentAuto-check passed
  • Proofread

    flonat/flonat-research

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

    145 GitHub stars~2.1k tokensUpdated 8 days ago
    Writing & ContentAuto-check passed
  • Proofread

    brycewang-stanford/Auto-Empirical-Research-Skills

    Proofread the sewage-house-prices manuscript. An agent skill from brycewang-stanford/Auto-Empirical-Research-Skills.

    4.5k GitHub stars~1.5k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Brief Compliance Check

    flonat/flonat-research

    Check a LaTeX coursework submission against the requirements in a supplied PDF assessment brief.

    145 GitHub stars~1.7k tokensUpdated 8 days ago
    Documents & OfficeAuto-check passed
  • Beamer

    Noi1r/beamer-skill

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

    364 GitHub stars~13k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check: notes
  • Research Paper Writing

    SNL-UCSB/paper-writing-skill

    Guides research paper writing with a five-stage pipeline, editorial and voice rules from a systems lab, and per-paper context, from brainstorming to compression.

    234 GitHub stars~8.4k tokensUpdated 2 mo ago
    Research & ScienceAuto-check passed

More from pedrohcgs/claude-code-my-workflow

All 59 skills in this repo
  • Devils Advocate

    pedrohcgs/claude-code-my-workflow

    Adversarial 5-7 question challenge to a deck's pedagogical choices — ordering, prerequisites, cognitive load, motivation.

    1.6k GitHub starsUsed in 2 repos~641 tokens
    Auto-check passed
  • Vaccinate

    pedrohcgs/claude-code-my-workflow

    Qualify a check before it is allowed to clear anything — prove it can detect the failure it is meant to catch.

    1.6k GitHub stars~2.1k tokensUpdated 10 days ago
    Auto-check: notes
  • Compile Latex

    pedrohcgs/claude-code-my-workflow

    Compile a Beamer LaTeX slide deck with XeLaTeX (3 passes + bibtex).

    1.6k GitHub starsUsed in 1 repo~492 tokens
    Auto-check: notes
  • Context Status

    pedrohcgs/claude-code-my-workflow

    Show current context status and session health. An agent skill from pedrohcgs/claude-code-my-workflow.

    1.6k GitHub starsUsed in 1 repo~613 tokens
    Auto-check: notes
  • Disclosure Check

    pedrohcgs/claude-code-my-workflow

    Pre-screen analysis outputs (tables, figures, logs) built on restricted or confidential data for statistical-disclosure-limitation problems before any release.

    1.6k GitHub starsUsed in 1 repo~2.6k tokens
    Auto-check: notes
  • Stata Replication

    pedrohcgs/claude-code-my-workflow

    End-to-end Stata replication pipeline — scaffolds numbered .do files in scripts/stata/, executes them via the stata-mcp MCP server, captures logs and outputs to output/, and produces…

    1.6k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check: notes

Questions about Proofread

What does Proofread do?

Read-only proofreading pass over lecture .tex or .qmd files. Proofread is an agent skill from pedrohcgs/claude-code-my-workflow.qmd files.

When should I use Proofread?

Proofread fits situations like: user says proofread; check for typos; look for grammar issues; any writing errors?.

How do I install Proofread in Claude Code?

Run `npx skills add pedrohcgs/claude-code-my-workflow --skill proofread -a claude-code`. Or copy the skill folder (.claude/skills/proofread in pedrohcgs/claude-code-my-workflow) 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 pedrohcgs/claude-code-my-workflow --skill proofread -a codex`. Or copy the skill folder (.claude/skills/proofread in pedrohcgs/claude-code-my-workflow) 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 pedrohcgs/claude-code-my-workflow --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?

SKILL.md names no scripts, command-line tools or credentials: Proofread is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Grep, Glob, Write, Agent, Task.

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 505 tokens (SKILL.md is roughly 2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

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), Proofread (flonat/flonat-research, 145 stars), Proofread (brycewang-stanford/Auto-Empirical-Research-Skills, 4.5k stars) and Brief Compliance Check (flonat/flonat-research, 145 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Proofread?

pedrohcgs (a GitHub user) maintains it in pedrohcgs/claude-code-my-workflow, which has 1,645 GitHub stars. The repository holds 59 skills in this directory. The repository was last updated on September 27, 2026.

Source: pedrohcgs/claude-code-my-workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.