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
npx skills add alexj11324/Mikka --skill writing-shape -a claude-codeWhat 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.mdinto 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.mdand leavenotes.mduntouched.
How to install writing-shape
1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill writing-shape -a claude-code2Manually: put the files in place
~/.claude/skills/writing-shape/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/writing-shape/
1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill writing-shape -a codex2Manually: put the files in place
.agents/skills/writing-shape/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill writing-shape -a cursor2Manually: put the files in place
.cursor/skills/writing-shape/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install alexj11324/Mikka .claude/skills/writing-shape2Manually: put the files in place
.github/skills/writing-shape/SKILL.md1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill writing-shape -a gemini-cli2Platform CLI
gemini skills install https://github.com/alexj11324/Mikka --path .claude/skills/writing-shapeManually: put the files in place
.devin/skills/writing-shape/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.