pprose-common-edit

name	pprose-common-edit
description	Apply the common Markdown documentation guidelines to any document; modifies the doc. The basic, universal edit tier. Use when asked to tidy, clean up, conform, fix formatting/structure, or add the footer.

Run pprose as pprose <command> if on PATH, else uvx pprose@0.1.0 <command> (zero-install via uv). Run pprose --help for every command, pprose skill --list for the other Practical Prose skills, and pprose shortcut --list / pprose guidelines --list / pprose runbook --list for on-demand playbooks, style guides, and procedures.

Common Edit

This is the basic, universal edit tier (an apply skill: it may modify the target document). It applies only the common documentation guidelines (read them with pprose guidelines common-doc-guidelines) — organization, structure, writing style, Markdown formatting, links, headings, lists, frontmatter, and footer — so it is safe for almost any Markdown document, workflow, or repo, whether or not it is a Practical Prose artifact.

For a deeper language-and-formatting pass (the Expression and Form dimensions) use pprose-copy-edit; for a full all-dimension editorial pass use pprose-full-edit. Each tier is a superset of the one before.

Inputs

• Path to one Markdown document.
• Optional scope note from the user, such as “format only” or “make all obvious fixes.”

Steps

1. Run pprose guidelines common-doc-guidelines and read it.
2. Inspect the target against organization, structure, writing style, Markdown formatting, links, headings, lists, frontmatter, and footer rules.
3. Apply fixes directly to the document while preserving its intended content and voice.
4. Ensure the required guideline footer is present when the document is part of this repo’s durable documentation.
5. Re-read the diff and check that no edit changed factual meaning.

Output

Report the changed file, the main issue classes fixed, and any rule you intentionally left alone.