# Clean up a repo's docs

Recipe · Design recipes · RC10

Get a noisy first run of Vale (the prose checker) down to problems worth fixing.

## Steps

1. `/vale:triage`: decide per rule: fix, downgrade or switch off
2. `/vale:vocab`: teach it your product names
3. `/vale:fix`: fix the error-level alerts that remain
4. `/humanizer`: rewrite the pages that still read as machine-made

## As one prompt

```text
Clean up a repo's docs. Get a noisy first Vale run down to something worth fixing.
Run these in order, and check in with me between steps:
1. /vale:triage: decide per rule: fix, downgrade or switch off
2. /vale:vocab: teach it your product names
3. /vale:fix: fix the error-level alerts that remain
4. /humanizer: rewrite the pages that still read as machine-made
```

Source: https://atlasscope.dev/prompts/clean-up-a-repos-docs