yoker-writing-assistant

A writing assistant that coaches and develops — but never writes for you.

This is a Yoker showcase package. It demonstrates the yoker-as-runtime mode: Yoker is the entry point, and this package provides the main agent and skills for an interactive writing coaching session. The agent interviews, challenges, reviews, and flags — but every word of prose is written by the author.

This is one of two Yoker 1.0 pet-store showcase packages. Its sister project yoker-assistant demonstrates yoker-as-SDK: Python owns the process and calls Yoker as a library. This one demonstrates yoker-as-runtime: Yoker is the entry point and the package runs under it as a plugin.

Contents

• Installation
  • Prerequisites
  • Install the package
  • Backend setup
  • Optional: researcher integration
  • Verify the install
• Quickstart
  • Launch the assistant
  • A first session: reviewing a draft
  • On-demand single checks
  • Interview mode
  • Next
• Tutorial — How yoker-writing-assistant Was Built
  • 1. Why this exists
  • 2. The non-negotiable rule
  • 3. The thin orchestrator
  • 4. The eight skills
  • 5. The plugin architecture
  • 6. The CLI wrapper
  • 7. The optional researcher integration
  • 8. The modes of operation
  • 9. What’s out of scope
• Architecture
  • The delegation model
  • The plugin mechanics
  • The tool set
  • Error handling
• Skills Reference
  • writing-review
  • writing-continuity
  • writing-voice
  • writing-mistakes
  • writing-idioms
  • writing-split
  • writing-order
  • copy-writer
• Configuration
  • Yoker runtime — ~/.yoker.toml
  • Optional: researcher integration
  • The voice profile — ~/VOICE.md
• API Reference
  • yoker_writing_assistant.__YOKER_MANIFEST__
  • yoker_writing_assistant.cli.main()
  • yoker_writing_assistant.__version__
  • CLI usage
  • Agent and skill definitions
  • Loading this plugin from another Yoker project
• Dogfooding: The Writing Assistant Reviews Itself
  • Review Report: README.md
  • What This Demonstrates
• Changelog
  • 0.1.3 (2026-08-31)
  • 0.1.2 (2025-07-17)
  • 0.1.0 (2025-07-17)

Indices and Tables

• Index

• Module Index

• Search Page