writing-shape

Shapes raw markdown material into a structured article paragraph by paragraph.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Fatih0234/mattpocock-skills-pi --skill writing-shape-fatih0234
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/Fatih0234/mattpocock-skills-pi/tree/main/skills/in-progress/writing-shape
Command: npx skills add https://github.com/Fatih0234/mattpocock-skills-pi --skill writing-shape-fatih0234

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a pile of raw notes, fragments, or transcripts into a coherent article is hard: structure is unclear, concepts arrive out of order, and weak transitions slip through. This Skill runs a guided shaping session that commits to a structure and mines the raw material to fill it. ## Core Features & Use Cases - Concept Grounding: Tracks which concepts the reader knows and ensures every paragraph only builds on grounded ideas, introducing new ones deliberately. - Paragraph-by-Paragraph Drafting: Drafts candidate openings, then grows the article block by block, appending each agreed paragraph to the article file immediately. - Format Deliberation: Argues explicitly about prose vs. lists, tables, callouts, quotes, and code blocks so every format choice is defensible. - Use Case: You have a messy transcript from a brainstorming session. Point the Skill at the file, pick an opening from the candidates it drafts, and collaboratively shape it into a polished article while the raw file stays untouched. ## Quick Start Shape the raw material in notes.md into an article and save it to article.md.

Frequently Asked Questions about writing-shape

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn raw notes into a structured article?▼

Provide a markdown file of raw material and the Skill reads it end-to-end, drafts 2-3 candidate openings, then grows the article paragraph by paragraph with you. Each agreed block is appended to a separate article file as you go.

What is concept grounding in article writing?▼

Grounding means every concept must be known to the reader before a paragraph can rely on it, either as a prerequisite or introduced by an earlier block. The Skill keeps a running list of grounded concepts and flags when a move requires grounding something first.

Does the writing-shape skill edit my raw material file?▼

No, the raw material file is read-only to this Skill. It mines fragments from the pile and writes the output to a separate article file, re-reading that file from disk before every write to respect your edits.

What happens when the raw material is missing something the article needs?▼

The Skill names the gap explicitly, for example stating that an example is needed and the pile does not have one. You then supply the missing material or cut that section; it does not invent new content.

When should I not use a paragraph-by-paragraph shaping session?▼

Avoid it when you are still exploring ideas, since this Skill assumes exploration is done and the pile is fixed. It also does not handle publishing, platform-specific formatting, or adding frontmatter you did not request.