К основному содержанию
плагин CX Codex

writers-loop — плагин для Claude Code: что делает и как установить

Плагин writers-loop ведёт написание текста по шагам: рамка задачи, план, черновик, критика, правка по подтверждённым пунктам. Предпочтения запоминает только с вашего согласия.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install writers-loop@awesome-codex-plugins
Открыть на GitHub

Что делает writers-loop

Плагин разбивает работу над текстом на отдельные этапы: сначала рамка задачи с аудиторией, целью и ограничениями, потом план, черновик и критика. Агент задаёт вопросы, только если ответ реально меняет результат. Готовый текст он не переписывает молча: сперва называет конкретные правки с причиной, областью и риском, затем ждёт, пока вы их примете или отклоните.

Внутри лежит скилл skills/writers-loop с подсказками под технические планы, отчёты, предложения, документацию, эссе, речи и прозу. Есть выделение стиля по вашим образцам и перевод с сохранением голоса и точных технических токенов. Для редакторов, которые не умеют запускать скиллы, приложены шаблоны: Obsidian, Logseq, Notion, Feishu/Lark Docs.

Память локальная и включается по согласию. Без явного подтверждения всё, что агент заметил о вашей манере, живёт только в текущей сессии. Учится он на просмотренных решениях — одобренных планах и принятых правках, а собственные черновики в набор для обучения не попадают. Для обычной работы npm-пакет ставить не нужно.

Какие задачи решает

  • собрать технический план так, чтобы агент не додумывал за вас
  • получить критику черновика до того, как в него внесли правки
  • перенести свою манеру на новый текст по образцам
  • перевести документ, сохранив термины и интонацию
  • вести работу над текстом в Obsidian или Notion по готовому шаблону

Примеры запросов агенту

  • Используй $writers-loop: нужен план миграции на новый API, аудитория — команда бэкенда. Сначала короткий план, потом черновик, предпочтения не сохраняй.
  • Пройди по $writers-loop и предложи правки к README.md с причиной и областью, меняй только то, что я подтвержу.
  • Сними стиль с sample.md через $writers-loop и перепиши вступление в той же манере.

Как установить writers-loop

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install writers-loop@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о writers-loop

Как установить writers-loop в Claude Code?

Через маркетплейс, двумя командами по порядку: /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем /plugin install writers-loop@awesome-codex-plugins.

Что делает writers-loop?

Разводит планирование, черновик и правку по отдельным шагам и просит подтверждения перед изменениями. Ещё умеет выделять стиль по образцам и переводить с сохранением терминов.

Сохраняет ли плагин мои предпочтения?

Только после того, как вы явно включили память. Иначе замеченное о стиле остаётся в текущей сессии, а в обучение идут лишь просмотренные вами решения.

Исходный текст

writers-loop · MIT
# Writer's Loop

English | [简体中文](README_zh.md) | [日本語](README_ja.md) | [Español](README_es.md)

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

[![Validate](https://github.com/xxsang/writers-loop/actions/workflows/validate.yml/badge.svg)](https://github.com/xxsang/writers-loop/actions/workflows/validate.yml)
[![HOL Guard](https://img.shields.io/endpoint?url=https%3A%2F%2Fhol.org%2Fapi%2Fregistry%2Fbadges%2Fplugin%3Fslug%3Dwriter-s-loop-contributors%252Fwriters-loop%26metric%3Dtrust)](https://hol.org/registry/plugins/writer-s-loop-contributors%2Fwriters-loop)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![No npm install](https://img.shields.io/badge/npm%20install-not%20required-brightgreen)](package.json)
[![Memory](https://img.shields.io/badge/memory-local%20opt--in-blue)](PRIVACY.md)

<p align="center">
  <img src="assets/writers-loop-overview.svg" alt="Writer's Loop overview" width="720">
</p>

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:

```text
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](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:

```text
Learn from user decisions, not from raw AI drafts.
```

```mermaid
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

```text
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](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:

```text
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.

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

| Agent | Fast path |
| --- | --- |
| **Claude Code** | Copy `skills/writers-loop` into `~/.claude/skills/`, or use `.claude-plugin/plugin.json` |
| **OpenAI Codex CLI** | Use the plugin flow with the GitHub URL if available, or copy `skills/writers-loop` into `~/.codex/skills/` |
| **OpenAI Codex App** | Use the plugin flow with the GitHub URL if available, or copy `skills/writers-loop` into `~/.codex/skills/` and refresh skill discovery |
| **Cursor** | Use `.cursor-plugin/plugin.json`, or copy the skill folder |
| **Gemini CLI** | Run `gemini extensions install https://github.com/xxsang/writers-loop` |
| **GitHub Copilot CLI** | Point Copilot-enabled workflows at `AGENTS.md` |
| **OpenCode** | Follow `.opencode/INSTALL.md` |
| **ChatGPT / hosted agents** | Paste or attach `skills/writers-loop/SKILL.md` into project instructions |

For full per-agent steps, see [docs/installation.md](docs/installation.md).

No npm install required for normal use. `package.json` is `private: true`; Node
scripts are for validation, evals, and optional local storage tooling only.

---

## Writing Tool Templates

Writer's Loop also ships templates for writing surfaces that do not run skills
natively. These are linked from the full [writing tool integration guide](docs/writing-tools.md).

| Tool | Easy path |
| --- | --- |
| **Obsidian** | Copy `integrations/obsidian/templates/` into your vault's template folder |
| **Logseq** | Copy `integrations/logseq/templates/writers-loop.md` into a template page |
| **Notion** | Paste `integrations/notion/writers-loop-page-template.md` into a page |
| **Feishu / Lark Docs** | Paste or create `integrations/feishu/writers-loop-doc-template.md` |
| **ChatGPT / Claude Projects** | Paste the project instructions and attach the listed Writer's Loop references |

Obsidian quick setup:

```bash
VAULT="$HOME/Documents/Obsidian/MyVault"
mkdir -p "$VAULT/Templates/Writers Loop"
cp integrations/obsidian/templates/*.md "$VAULT/Templates/Writers Loop/"
```

Then enable Obsidian's **Templates** core plugin and set the template folder to
`Templates/Writers Loop`.

---

## Local Memory Is Opt-In

Writer's Loop works without memory. Preference learning is session-only by default.

If you opt in, tools write only inside the selected project:

```text
.writers-loop/
├── journal.jsonl
├── prefs.md
└── styles/
    └── my-style.md
```

- `.writers-loop/` is never created unless you ask.
- Never commit it to public repositories.
- Only reviewed style packs are saved in `.writers-loop/styles/` — not raw source samples.

See [docs/local-preference-storage.md](docs/local-preference-storage.md) for
`style:save` and other commands, and [PRIVACY.md](PRIVACY.md) for the full policy.

---

## When Not To Use It

For tiny one-off copy edits, a simple prompt is usually enough. Writer's Loop
is for writing that benefits from structure, review, or reusable decisions.

Using an LLM for writing may also reduce the pleasure of writing — it can
compress the uncertainty, wandering, discovery, and ownership that make writing
satisfying. Use Writer's Loop as a scaffold, sparring partner, editor, or
translator. Keep the parts of writing you value doing yourself.

---

## Docs

| Need | Read |
| --- | --- |
| Quick example | [docs/demo-transcript.md](docs/demo-transcript.md) |
| Full method | [docs/writers-loop-complete-guide.md](docs/writers-loop-complete-guide.md) |
| Copyable prompts | [docs/prompt-templates.md](docs/prompt-templates.md) |
| Writing tool integrations | [docs/writing-tools.md](docs/writing-tools.md) |
| Using A Learned Style | [docs/prompt-templates.md#using-a-learned-style](docs/prompt-templates.md#using-a-learned-style) |
| Installation | [docs/installation.md](docs/installation.md) |
| Local preference storage | [docs/local-preference-storage.md](docs/local-preference-storage.md) |
| Privacy policy | [PRIVACY.md](PRIVACY.md) |
| Release checklist | [RELEASE.md](RELEASE.md) |

---

## Repository Layout

<details>
<summary>Show file tree</summary>

```text
skills/writers-loop/SKILL.md               Core skill instructions
skills/writers-loop/references/            Progressive-disclosure references
skills/writers-loop/scripts/journal.mjs    Optional local preference journal
skills/writers-loop/scripts/style-pack.mjs Optional local style-pack storage
docs/                                      User-facing guides and prompt templates
.codex-plugin/plugin.json                  Codex plugin metadata
.claude-plugin/plugin.json                 Claude plugin metadata
.cursor-plugin/plugin.json                 Cursor plugin metadata
gemini-extension.json                      Gemini extension metadata
.opencode/                                 OpenCode install metadata
tools/                                     Maintainer validation and eval scripts
```

</details>

---

## Validate

```bash
npm test
```

No install step required. Uses only Node.js built-in modules.

---

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md). Keep the skill portable, concise, and
useful across agents.

## License

MIT License. See [LICENSE](LICENSE).

Copyright (c) 2026 Writer's Loop contributors.

© Writer's Loop contributors · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Тексты и документация» →
voice-analysis jwynia Скилл voice-analysis разбирает тексты автора по восьми фазам и собирает voice guide, по которому ИИ пишет в его манере. CX Codex +1 455установок personal-chinese-writing-style sugarforever Скилл personal-chinese-writing-style держит китайский текст в одной типографике: кавычки, тире и многоточие по вашим правилам, без латинских запятых и точек между иероглифами. CX Codex +1 408установок flow-next-prose Gordon Mickel Скилл flow-next-prose для Claude и Codex: перед большим ответом агент читает контракт docs/prose.md и пишет под его правилами 1–10, а не правит готовый текст. CX Codex +1 ★ 730звёзд репо etincel-nonfiction AIStoryHub MCP-сервер etincel-nonfiction, который находит шаблонные обороты ИИ в тексте и обучает Claude писать в вашем стиле на основе ваших черновиков. CX Codex +1 ★ 10звёзд репо writing-style-and-tone social-media-skills Скилл writing-style-and-tone для Claude Code редактирует черновики: убирает машинный тон, задаёт ритм и конкретику, меняет тон под ситуацию. Запускается после вычитки, когда текст написан, но читать его тяжело. CX Codex +1 1 200установок uk-business-english jezweb Скилл uk-business-english для Claude Code задаёт агенту британский деловой стиль письма: орфография EN-GB, сдержанный тон, подходящие приветствия и подписи при переписке с британской аудиторией. CX Codex +1 1 100установок

Из того же набора391

Весь набор →
codex-zcode-bridge Плагин codex-zcode-bridge для Claude Code и Codex передаёт задачу из Codex локальному ZCode и возвращает ход работы для проверки изменений и сверки результата с критериями приёмки. CX Codex ★ 1 596звёзд репо zagrosi-forge Плагин zagrosi-forge для Claude Code делит большой бриф на спецификации, строит план по секциям и пишет код по TDD с записями о проверках. Разбивает задачи, которые не помещаются в один заход. CX Codex ★ 1 596звёзд репо yylo Плагин yylo для Claude Code и Codex изолирует задачи агентов в отдельных git worktree и распределяет работу между субагентами Codex и Pi, фиксируя изменения квитанциями. CX Codex ★ 1 596звёзд репо wtfm wtfm — плагин для Claude Code и Codex, который пишет справочные статьи по коду проекта и добавляет скриншоты его интерфейса. Запросите руководство обычным языком, например о приглашении коллеги. CX Codex ★ 1 596звёзд репо workflow-kit Плагин workflow-kit ведёт продукт от формулировки видения до готового пакета артефактов. Каждую задачу выполняет рабочий агент, а валидирует обязательный независимый ревьюер. CX Codex ★ 1 596звёзд репо wingman Плагин wingman хранит знания о проекте в репозитории, проверяет контракты данных и помогает найти существующие функции. Он пригодится перед правками и при подключении реальных данных. CX Codex ★ 1 596звёзд репо waggle Плагин waggle для Claude Code и Codex хранит решения, ограничения проекта и причины в локальном графе, чтобы агент мог использовать их в следующих сессиях. CX Codex ★ 1 596звёзд репо vibestretch Плагин vibestretch напоминает размяться или отдохнуть от экрана, пока агент выполняет долгую задачу. Сигнал зависит от времени ожидания, а не от расписания. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой