writers-loop

Writer's Loop

English | 简体中文 | 日本語 | Español

AI writing that learns from your style, approvals, and edits. 让 AI 写作根据你的风格、认可与修改持续改进。

Writer's Loop is a portable writing skill for AI agents. It turns writing into a reviewable loop — frame, plan, draft, critique, revise — and learns only from style samples you provide or approve and decisions you actually review.

Use it when one-shot prompting is too fuzzy: coding plans, reports, proposals, product specs, documentation, essays, speeches, fiction, style distillation, and translation.

---

One-Line Agent Setup

If you use Claude Code, Codex, Cursor, Gemini CLI, OpenCode, or another local agent, give it this setup prompt:

Help me install Writer's Loop from https://github.com/xxsang/writers-loop, then use $writers-loop for my writing task without saving preferences unless I explicitly opt in.

For manual installation, see docs/installation.md. If your agent supports repository plugins, start with the public GitHub URL: https://github.com/xxsang/writers-loop.

---

The Problem With One-Shot AI Writing

Most writing prompts collapse planning, drafting, editing, and preference learning into one pass. The agent guesses what you want, rewrites without asking, and forgets your decisions the moment the conversation ends.

Problem	Writer's Loop response
One-shot drafts guess too much	Frame the task and plan before drafting
Rewrites can erase intent	Propose changes before revising
AI memory can become unreliable	Learn only from reviewed decisions
Style copying can leak private facts	Separate style traits from source content

Writer's Loop keeps the stages separate:

Stage	What happens
Frame	Understand the artifact, audience, goal, and constraints
Ask	Ask only questions that would materially change the result
Plan	Propose a structured plan and wait for approval
Draft	Write once the plan is locked
Critique	Evaluate the draft before touching it
Propose	Name targeted changes with reason, scope, and risk
Decide	You accept, reject, or adjust — the agent does not guess
Revise	Rewrite only what was approved
Learn	Record only reviewed decisions as reusable preferences

Core rule:

Learn from user decisions, not from raw AI drafts.

flowchart LR
  A["Style samples you provide or approve"] --> D["Reviewed signals"]
  B["Approved plans"] --> D
  C["Accepted edits"] --> D
  X["Raw AI drafts"] -. "not learned from" .-> Z["Discarded"]
  D --> E["Reusable preferences"]
  E --> F["Better future drafts"]

---

Try It In 30 Seconds

Use $writers-loop for this:
[describe the writing task]

Audience: [who will read it]
Goal: [what it should achieve]

Ask only if blocked. Otherwise make a short plan, draft, and brief critique.
Do not save preferences unless I ask.

For more ready-to-copy prompts, see docs/prompt-templates.md.

---

What You Get

A structured loop that keeps planning, drafting, and editing separate — so the output is steerable and reviewed preferences can persist across sessions after explicit opt-in. Includes artifact-specific guidance for technical plans, reports, proposals, docs, essays, speeches, and fiction; style distillation from your own samples; translation that preserves voice and exact technical tokens; and optional project-local memory that writes only where you approve it.

---

Install And Agent Support

Writer's Loop is GitHub-only and public. If your agent supports repository plugins, install from:

https://github.com/xxsang/writers-loop

For local skill-folder installs, clone the repository, then install with the path or plugin flow that matches your agent.

git clone https://github.com/xxsang/writers-loop.git