Translate articles
Quick, normal and refined modes, so even long articles come out reading like well-written prose.
Good for: People who often read articles in other languages, or need to translate their own writing
When all you have is a pile of loose ideas, it works through them with you, paragraph by paragraph, until they're an article.
Good for: People who want to write something long but have messy notes
Before you start: Save your notes as a text file (.md or .txt) first. The author is still refining it, so how it works may change.
Read this first: Call it by name: type /writing-shape ($writing-shape in Codex)
Just say the “You say to AI” line, with your own details swapped in.
You say to AI
/writing-shape My notes are in notes.md. I want to write an article about my first year learning to cook. Save it to article.md.
What AI does
What you get
An article written from the angle you picked, with your original notes file left untouched.
You say to AI
/writing-shape Here's a transcript of a recorded chat with my grandma. Help me turn it into a memoir piece.
What AI does
What you get
A memoir piece saved as it's written, so you can watch it take shape paragraph by paragraph.
Want the original instructions? SKILL.md on mattpocock/skills
Which AI tool do you use?
1. Open the Terminal app on your computer, paste the line below and press Enter
npx skills add mattpocock/ skills @writing-shape -gWith no tool name, the command looks for the AI tools on your computer and asks where to install. If it says npx is missing or too old, install the latest Node.js (22 or newer) first.
Don't feel like opening a terminal?
Tools like Claude Code, Codex, Cursor and Trae can run commands themselves. Send them this:
npx skills add mattpocock/ skills @writing-shape -g2. Reopen your AI tool
New Skills only get picked up after a restart.
3. Just say what you want
Say it the way the examples do. To call it by name, say “Use writing-shape to help me…”.
Quick, normal and refined modes, so even long articles come out reading like well-written prose.
Good for: People who often read articles in other languages, or need to translate their own writing
When you don't know how to write it yet, it keeps asking you questions and saves the good lines to a file.
Good for: People who want to write something but can't see the structure yet
Edits your copy with a seven-pass check and picks out phrasing that screams "AI wrote this."
Good for: People who've written an intro or announcement and want it to sound more natural