# okf-writer

The okf-writer Claude Code subagent drafts concepts from source records under a run’s rules. It handles one part of a bulk produced with okf-produce.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 105 repo stars
- Author: wmahfoudh
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/wmahfoudh/okf/tree/HEAD/skills-pi/okf-produce/agents/okf-writer.md
- Updated: 2026-10-31
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/okf-writer

## What it does

okf-writer drafts concepts for a single part of an `okf-produce` run, using its rules and source records. The rules fix the structure; the agent chooses the wording. Each concept gets `generated` and `sources` fields, and claims carry footnotes with their source IDs.

The writing standard lives in `WRITING.md` beside the `SKILL.md` file for `okf-produce`. When a concept’s sources stay unchanged, the agent preserves its text and `generated` entry. Its reply contains only the paths of concepts it created or edited.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/okf-writer.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/okf-writer.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/okf-writer.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/wmahfoudh/okf/tree/HEAD/skills-pi/okf-produce/agents/okf-writer.md

## When to use it
- draft concepts for one part of a run from its sources
- attach source IDs as footnotes to claims
- preserve a concept when its sources have not changed
- return paths of edited concepts without extra text

## Example prompts
- Write concepts for this part of the run using its rules and source records.
- Add footnotes that identify the source ID for each claim.
- Return only the paths of concepts you created or changed.

## Similar
- [carousel-writer-sms](https://affpapa.org/en/nevibecode/skills/carousel-writer-sms.md) — skill · 2600 installs
- [hebrew-content-writer](https://affpapa.org/en/nevibecode/skills/hebrew-content-writer.md) — skill · 490 installs
- [social-writer](https://affpapa.org/en/nevibecode/skills/social-writer.md) — skill · 270 installs
- [technical-writer](https://affpapa.org/en/nevibecode/skills/curiositech-technical-writer.md) — skill · 221 installs
- [mermaid-graph-writer](https://affpapa.org/en/nevibecode/skills/mermaid-graph-writer.md) — skill · 154 installs
- [seo-content-writer](https://affpapa.org/en/nevibecode/agents/seo-content-writer.md) — subagent · ★ 42780 repo stars

From the same set: [wmahfoudh/okf](https://affpapa.org/en/nevibecode/by/wmahfoudh/okf.md) — 8 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
