Documentation
Run the pipeline
The writing workflow lives in the host agent as slash skills. The usual entry
is /ps: it runs the full chain and exports when finished.
Full run: /ps
/ps <your idea in a sentence or two>Default stage order:
/ps-intake— clarify the brief/ps-draft— first draft/ps-staff-edit— structural edit/ps-sharpen— tighten claims and language/ps-humanize— final voice pass- Export to the project root (see Export)
Optional flags on /ps:
| Flag | Effect |
|---|---|
--seo | Insert /ps-seo between sharpen and humanize (discoverability packaging for web/blog). Ordering is fixed: SEO never runs after humanize. |
--review | Stop after each stage and wait for your go-ahead |
With no idea and no piece path, /ps prints a short plain-language
orientation instead of guessing.
Resume: if a piece already exists under .pysar/pieces/, /ps continues from
the stage already reached; it does not restart from intake just because you
invoked /ps.
Optional first step: /ps-onboard
Teaches Pysar your voice and style (~2 minutes). Skipable — Pysar works with a general-audience default if you skip it.
Stage skills (manual)
You can run stages one at a time:
| Skill | Role |
|---|---|
/ps-intake | Brief / intake bundle |
/ps-draft | Draft |
/ps-staff-edit | Staff edit |
/ps-sharpen | Sharpen |
/ps-seo | Optional SEO packaging |
/ps-humanize | Humanize |
/ps-research | Optional research (also invoked where intake/draft need it) |
/ps-factcheck | Optional fact-check |
/ps-voice / /ps-style | Voice and style helpers used with onboarding |
Piece files live under .pysar/pieces/<piece-id>/. Skills persist through
Pysar MCP tools — not by hand-editing those paths. Details:
MCP and skills.