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:

  1. /ps-intake — clarify the brief
  2. /ps-draft — first draft
  3. /ps-staff-edit — structural edit
  4. /ps-sharpen — tighten claims and language
  5. /ps-humanize — final voice pass
  6. Export to the project root (see Export)

Optional flags on /ps:

FlagEffect
--seoInsert /ps-seo between sharpen and humanize (discoverability packaging for web/blog). Ordering is fixed: SEO never runs after humanize.
--reviewStop 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:

SkillRole
/ps-intakeBrief / intake bundle
/ps-draftDraft
/ps-staff-editStaff edit
/ps-sharpenSharpen
/ps-seoOptional SEO packaging
/ps-humanizeHumanize
/ps-researchOptional research (also invoked where intake/draft need it)
/ps-factcheckOptional fact-check
/ps-voice / /ps-styleVoice 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.