Skip to content
Mingworks
EN · Language: English
Back to Skills
WritingInstall and go267.5K installs

Shape notes into an article

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)

What you can do once it's installed

Just say the “You say to AI” line, with your own details swapped in.

Turn notes into an article

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

  1. 1.Reads your notes from start to finish
  2. 2.Checks with you what readers already know
  3. 3.Offers 2 or 3 openings from different angles for you to pick from
  4. 4.Writes one paragraph at a time, talking each one through with you first

What you get

An article written from the angle you picked, with your original notes file left untouched.

Turn a conversation into an essay

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

  1. 1.Reads the whole transcript
  2. 2.Settles on where the piece should begin
  3. 3.Adds each finished paragraph to the article file as it goes

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

How to install

Which AI tool do you use?

  1. 1. Open the Terminal app on your computer, paste the line below and press Enter

    npx skills add mattpocock/skills@writing-shape -g

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

    First time using the terminal?
    • How to open it: on a Mac, press ⌘ + Space and search “Terminal”. On Windows, search “PowerShell” in the Start menu. In Cursor, Trae or VS Code, use the menu Terminal → New Terminal.
    • Windows says “running scripts is disabled”: change npx at the start of the command to npx.cmd and try again.
    • If a list pops up: move with the arrow keys, press Space to tick the tools you want, then press Enter.
    • How to tell it worked: you'll see a success message. Reopen your AI tool and ask “What Skills do you have now?” to check.

    Don't feel like opening a terminal?

    Tools like Claude Code, Codex, Cursor and Trae can run commands themselves. Send them this:

    Please run this command in my terminal and tell me how it went: npx skills add mattpocock/skills@writing-shape -g
  2. 2. Reopen your AI tool

    New Skills only get picked up after a restart.

  3. 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…”.

  • WritingInstall and go

    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

    See how to use it
  • WritingInstall and go

    Collect writing fragments first

    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

    267.3K installsSee how to use it
  • WritingInstall and go

    Edit out the AI feel

    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

    116.3K installsSee how to use it