# writing-beats

writing-beats is a Claude Code skill that shapes a raw-material file into an article, one selected beat at a time. The user chooses the opening and each next direction.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 88 repo stars
- Author: alexj11324
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/alexj11324/Mikka/tree/HEAD/.claude/skills/writing-beats/SKILL.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/writing-beats

## What it does

writing-beats turns source notes into a sequence of article beats. The agent first establishes what the intended audience already understands, then offers opening options and previews where each path could lead. The user picks one; the agent writes only that beat to the article file.

After each addition, the agent reads the file again and suggests next beats that fit the concepts already introduced. Each option names the concepts it would establish. If no save location was given, the agent asks once. Before every write, it rereads the file so user edits remain intact.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill writing-beats -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/writing-beats/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/writing-beats/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill writing-beats -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/writing-beats/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill writing-beats -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/writing-beats/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install alexj11324/Mikka .claude/skills/writing-beats
```

2. **Manually: put the files in place**
- File: `.github/skills/writing-beats/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill writing-beats -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/alexj11324/Mikka --path .claude/skills/writing-beats
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/writing-beats/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/alexj11324/Mikka/tree/HEAD/.claude/skills/writing-beats/SKILL.md

## When to use it
- turn a file of raw notes into an article
- introduce concepts before later passages rely on them
- choose between possible directions for an article
- write an article incrementally while keeping file edits

## Example prompts
- Turn this Markdown file of notes into an article, offering opening and continuation options.
- Help structure the article around its concepts: establish what the audience knows, then write one beat at a time.
- Continue the article from its file: reread the current text and suggest reachable next beats.

## Similar
- [UI Beats](https://affpapa.org/en/nevibecode/mcp/ui-beats.md) — MCP server · ★ 235 repo stars
- [writing-for-agents](https://affpapa.org/en/nevibecode/skills/writing-for-agents.md) — skill · 466719 installs
- [writing-skills](https://affpapa.org/en/nevibecode/skills/writing-skills.md) — skill · 217894 installs
- [writing-guidelines](https://affpapa.org/en/nevibecode/skills/writing-guidelines.md) — skill · 133400 installs
- [better-writing](https://affpapa.org/en/nevibecode/skills/better-writing.md) — skill · 38200 installs
- [technical-writing](https://affpapa.org/en/nevibecode/skills/technical-writing.md) — skill · 27800 installs

From the same set: [alexj11324/mikka](https://affpapa.org/en/nevibecode/by/alexj11324/mikka.md) — 47 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
