writing-with-agents

10 Skills · 31 References · 4 Workflows

---

Why This Exists

Most AI writing tools mix brainstorming, structuring, and editing into a single prompt. The result is flat, mediocre output that sounds like everything else. Betty Flowers identified in 1981 that writing requires four distinct cognitive modes, each demanding a different kind of thinking. Mixing them produces internal conflict: your inner critic shuts down your inner generator before it can produce anything worth editing.

This plugin gives each mode its own skill, workflow, and quality gates. The AI and human trade leadership at every phase: AI generates raw volume when quantity matters, human decides structure when judgment matters.

---

What This Is

A Claude Code plugin that separates the writing process into five phases, each with a defined lead and support role:

Phase	Lead	Support	Deliverable
Madman	AI generates	Human seeds with experience	Raw material dump
Whirlybird	AI generates options	Human selects and combines	Chosen mindmap diagram
Architect	Human decides	AI formulates	Structured blueprint
Carpenter	AI builds	Human spot-checks	Complete draft
Judge	AI detects	Human decides	Polished final piece

This is the collaborative oscillation model: not AI-only automation, not human-only writing. Each phase leverages what each party does best.

---

Installation

Option 1: Claude Code plugin marketplace (native)

Inside Claude Code, add this repo as a plugin marketplace and install the plugin:

/plugin marketplace add Jeffallan/writing-with-agents
/plugin install writing-with-agents@Jeffallan/writing-with-agents

If you're already in a session, run /reload-plugins to activate.

Option 2: skills.sh via npx

npx skills add Jeffallan/writing-with-agents

Add -g to install globally across all projects.

Full documentation: jeffallan.github.io/writing-with-agents

---

Quick Start

Write a Single Article

/writing-with-agents:flowers-cycle "API-first identity verification for fintech"

This runs the full Flowers cycle: Madman, Whirlybird, Architect, Carpenter, Judge, Quality Rubric.

With SEO Optimization

/writing-with-agents:flowers-cycle "API-first identity verification" --seo

Plan a Multi-Article Strategy

/writing-with-agents:content-strategy /path/to/research/notes

Capture a Research Source

/writing-with-agents:capture /path/to/note.md https://example.com/article

Configure Session Defaults

/writing-with-agents:writing-setup

---

Skills

Inner Loop (Single Article)

Skill	Domain	What It Does
madman	generation	Generates 3-5x raw material from human-seeded topics across 8 dimensions. Quantity over quality.
whirlybird	structure	Produces nonlinear Mermaid mindmaps. Human selects and combines branches into a working outline.
architect	structure	Builds a throughline and section blueprint from the chosen outline. Human leads structural decisions.
carpenter	craft	Constructs full prose from the blueprint. Human spot-checks voice, tone, and accuracy.
judge	quality	Runs 5 editing passes (AI voice, Strunk & White, readability, consistency, SEO). Human approves changes before any edits.
quality-rubric	quality	Scores across 10 dimensions (1-5 scale). Routes any dimension below 4 back to the responsible phase for targeted rework.

Cross-Cutting

Skill	Domain	What It Does
seo-writer	seo	Integrates during Architect (keyword mapping), Carpenter (natural placement), and Judge (validation). Not a post-draft bolt-on.

Outer Loop (Multi-Article)