# writing-shape

writing-shape is a Claude Code skill that turns raw notes into an article through a step-by-step writing session. The author chooses the opening and builds the piece one block at a time.

- 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-shape/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-shape

## What it does

writing-shape reads a Markdown file from beginning to end, then helps create a separate article from its contents. The source file stays untouched. If no destination is given, the skill asks where to save the article and keeps that path for the session.

The agent first agrees with the author on what readers are expected to know. It then presents opening options with different angles. Once one is chosen, they work out what belongs next and whether it should be prose, a list, a table, or another format. Fragments can be reshaped or combined; when the material lacks an example the article needs, the agent calls out the gap.

Each approved block goes into the article file right away. Before writing, the agent rereads that file so edits made between turns are retained. The author decides when the article is finished.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/writing-shape/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-shape/SKILL.md

## When to use it
- turn notes or a transcript into an article
- choose an opening angle from raw material
- order paragraphs so each idea has its groundwork
- keep the source notes unchanged while drafting a separate document

## Example prompts
- Turn the notes in `notes.md` into an article and show me several possible openings first.
- Help decide what readers should already know, then build the article one paragraph at a time.
- Add each approved block to `article.md` and leave `notes.md` untouched.

## Similar
- [om-ux-shape](https://affpapa.org/en/nevibecode/skills/om-ux-shape.md) — skill · 3300 installs
- [dx-org-shape-manage](https://affpapa.org/en/nevibecode/skills/dx-org-shape-manage.md) — skill · 1200 installs
- [shape-your-agent](https://affpapa.org/en/nevibecode/skills/shape-your-agent.md) — skill · 1200 installs
- [shape](https://affpapa.org/en/nevibecode/skills/shape.md) — skill · 997 installs
- [writing-for-agents](https://affpapa.org/en/nevibecode/skills/writing-for-agents.md) — skill · 466719 installs
- [api-shape-explorer](https://affpapa.org/en/nevibecode/skills/api-shape-explorer.md) — skill · ★ 4719 repo stars

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
