# proofread-markdown

> Claude/Codex skill by [@flutter](https://omgskills.com/library/flutter/index.md) · 3.1k stars · Updated 2026-08-25

Proofreads Markdown files against Google guidelines.

Tags: dart, flutter, website

## Install

```sh
git clone https://github.com/flutter/website /tmp/website && ln -s /tmp/website/.agents/skills/proofread_markdown ~/.claude/skills/proofread-markdown
```

## From README

Proofreading Markdown Overview Help us transform technical text into clear, concise, and machine-readable Markdown. We follow the Google Developer Documentation Style Guide. Workflow Check line length \[ \] Wrap lines semantically and keep them generally under 80 characters using scripts/wraplines.dart \[ \] Never touch the front matter. Do not modify the content between the first two --- lines at the top of the file. \[ \] Verify that the file was wrapped correctly, preserving headings and code blocks Fix voice and tone \[ \] Use active voice. \[ \] Use present tense. \[ \] Use second person ("you"). No "we" or "I". Check word choice \[ \] Replace forbidden terms: "e.g.", "i.e.", "etc.", "should", "would", "could", "via", "may". \[ \] Use Oxford comma and American spelling. Check style of headings \[ \] Use Sentence case for headings. If you change a heading, add an id after the heading like this: "\#\# Configure the project {: \#project-configuration }" \[ \] Put a blank line after all headings.

## Links

- HTML page: https://omgskills.com/skills/flutter/website/proofread-markdown/
- GitHub: https://github.com/flutter/website
- Author: [@flutter](https://omgskills.com/library/flutter/index.md)

## More from this repo

- [update-llms-text](https://omgskills.com/skills/flutter/website/update-llms-text/index.md) — Used to update and maintain the llms.txt file.
   - [@flutter](https://omgskills.com/library/flutter/index.md) · 3.1k stars
- [validate-pr](https://omgskills.com/skills/flutter/website/validate-pr/index.md) — Stages the Flutter site locally.
   - [@flutter](https://omgskills.com/library/flutter/index.md) · 3.1k stars

## More skills by this author

- [find-release](https://omgskills.com/skills/flutter/flutter/find-release/index.md) — A skill to find the lowest Dart and Flutter release containing a given commit.
   - [@flutter](https://omgskills.com/library/flutter/index.md) · 179k stars