authoring-pipeline
Produce long-form work systematically — approved outlines, review passes, versioned builds, clean publishing.
SKILL.mdskills/authoring-pipeline/SKILL.md
GitHubAuthoring Pipeline
Books, courses, and long documents are builds: outline as contract, units with a point, review passes with records, and reproducible output.
When to use
- Books, course modules, guides, strategy documents (the OCS-book / academy-module pattern).
- Converting research notes into publishable work.
- Any document that will have editions.
Method
- Outline as contract: chapters/modules → claims or learning outcomes; TOC approved BEFORE drafting; scope fences (what the work won't cover).
- Drafting loop: small units; each unit has one point (courses: one testable outcome); examples before abstractions; running style sheet + glossary for consistency.
- Review passes (recorded): structure pass → technical/accuracy pass (domain expert) → style/read-aloud pass → facts/attribution pass; comments triaged, not blind-applied.
- Versioning: sources in git (markdown); research kept separate from prose; editions tagged; changelog per edition — no silent edition changes.
- Builds: deterministic pipeline (md → HTML/ebook/PDF), pinned templates; preview builds for reviewers; artifacts hashed + signed (
secure-build-pattern). - Publishing: distribution channels defined; book metadata (ISBN/description/cover) or course platform setup (entitlements per
payments-and-billing); launch checklist; sample/errata pages. - Feedback loop: reader/learner feedback → corrections list → next edition; errata visible; analytics on drop-off points for courses (
product-analytics).
Quality gates
- Outline approved before drafting; units map to outcomes/claims.
- Review passes recorded (who, when, what changed).
- Build reproducible; artifacts signed; previews distributed.
- Errata/feedback channel live.
Red lines
- No publishing without an accuracy pass; no silent edits across editions; quotes and attributions verified.
Related
technical-writing · research-tooling · release-management (editions as releases).