Skip to main content
skill CX Codex

writing-shape — Claude Code skill for shaping articles

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.

AGPL-3.0 ★ 88 updated 2026-11-17

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add alexj11324/Mikka --skill writing-shape -a claude-code
Open on GitHub

What writing-shape 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.

What it helps with

  • 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 for the agent

  • 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.

How to install writing-shape

1Skills CLI (Vercel)

npx skills add alexj11324/Mikka --skill writing-shape -a claude-code

2Manually: put the files in place

~/.claude/skills/writing-shape/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/writing-shape/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about writing-shape

How do I install writing-shape in Claude Code?

Run npx skills add alexj11324/Mikka --skill writing-shape -a claude-code. The skill file is at ~/.claude/skills/writing-shape/SKILL.md.

What does writing-shape do?

It guides a collaborative process for turning Markdown notes, fragments, or a transcript into a separate article. The author selects the opening and decides when to stop.

Does writing-shape edit the source notes?

No. It uses them as input and writes approved article blocks to a separate document.

Similar skills

All skills for Writing and docs →

From the same set47

The whole set →
mikka-action-coverage mikka-action-coverage is a Claude Code skill that audits whether business operations are reachable in the UI and whether controls produce saved changes. Run it when a control is missing, inert, or reports success without a lasting result. CX Codex +1 ★ 88repo stars mikka-ux-quality-audit mikka-ux-quality-audit is a Claude Code skill that executes UI and functional quality sweeps across Mikka. Evaluates permission parity, dead controls, and screen-reader semantics. CX Codex +1 ★ 88repo stars 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. CX Codex +1 ★ 88repo stars debug debug is a Claude Code skill that enforces hypothesis-driven debugging. It stops the agent from editing files until the root cause is framed, tested, and confirmed. CX Codex +1 ★ 88repo stars software-factory software-factory is a Claude Code skill that establishes a strict architectural vocabulary for agentic coding factories. Organizes services into slots and breaks workflows into isolated task runs. CX Codex +1 ★ 88repo stars node-ops node-ops is a Claude Code skill for operating Node.js apps in production. It covers deployment questions, process shutdown, health checks, and memory leaks. CX Codex +1 ★ 88repo stars incident incident is a Claude Code skill that guides engineers through production outages. Activates when systems fail, alert thresholds trigger, or during post-mortem reviews. CX Codex +1 ★ 88repo stars db-review db-review is a Claude Code skill that reviews database schemas, queries, and migrations. It activates for schema design, index choices, query tuning, and migration safety checks. CX Codex +1 ★ 88repo stars

Project sponsors

Companies that keep this analytics open