Common Edit
This is the basic, universal edit tier (an apply skill: it may modify the target documents). It applies the common documentation guidelines to almost any durable Markdown document, workflow, or repo, whether or not it is a Practical Prose artifact.
Before acting, read the bundled
common-doc-guidelines.md in full.
The reference is part of this skill; the pprose CLI is not required.
For focused removal of AI-writing tells use pprose-de-slop; for a deeper
language-and-formatting pass (the Expression and Form dimensions, including the de-slop
audit) use pprose-copy-edit; for a full all-dimension editorial pass use
pprose-full-edit. Each tier is a superset of the one before, with pprose-de-slop
folded in from copy-edit up.
Inputs
- Paths to one or more Markdown documents.
- Optional scope note from the user, such as “format only” or “make all obvious fixes.”
Steps
- Read
references/common-doc-guidelines.mdcompletely before editing. - Inspect the target against organization, structure, writing style, Markdown formatting, links, headings, lists, frontmatter, and footer rules.
- Apply fixes directly to the document. This is a correction pass, not a rewrite: fix objective errors such as grammar, typos, punctuation, casing, Markdown mechanics, and broken links in place, and keep the author’s wording, sentence structure, section order, and headings unless a rule is unambiguously violated.