# Proofread Markdown

> Proofread Markdown is an Agent Skill for documents published in the cfug/flutter.cn repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Proofreads Markdown files against Google guidelines.

- Skill name: `proofread-markdown`
- Category: [Documents](https://www.openparable.com/skill/documents/1)
- Source: https://github.com/cfug/flutter.cn/blob/HEAD/.agents/skills/proofread_markdown/SKILL.md
- Repository: cfug/flutter.cn (567 GitHub stars when collected)

## SKILL.md

# Proofreading Markdown

## Overview

Help us transform technical text into clear, concise,
and machine-readable Markdown. We follow the
Google Developer Documentation Style Guide.

## Workflow

### 1. Check line length

- [ ] Wrap lines semantically and keep them generally under 80 characters using
      [scripts/wrap_lines.dart](scripts/wrap_lines.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

### 2. Fix voice and tone

- [ ] Use active voice.
- [ ] Use present tense.
- [ ] Use second person ("you"). No "we" or "I".

### 3. Check word choice

- [ ] Replace forbidden terms: "e.g.", "i.e.", "etc.", "should", "would",
      "could", "via", "may".
- [ ] Use Oxford comma and American spelling.

### 4. 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.

### 5. Check style of lists

- [ ] Numbered lists MUST use `1.` for every item to allow easy reordering.
- [ ] How-to sections must have active voice in headings.
      - No: "## Project Configuration"
      - Yes: "## Configure the project"
      
### 6. Use less words in sections with steps

- [ ] Ask the user if they would like the steps to be more concise. 
      If yes, update the steps to be brief. Keep it short, simple, and
      accurate.

---

Source: https://www.openparable.com/skill/documents/proofread-markdown (OpenParable). Cite the canonical URL above.