writing-shape

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

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/MSC72m/DevForge --skill writing-shape-msc72m
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/MSC72m/DevForge/tree/main/skills/writing-shape
Command: npx skills add https://github.com/MSC72m/DevForge --skill writing-shape-msc72m

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 an interactive shaping session that commits to a structure and mines the raw material to fill it, producing a polished article document. ## Core Features & Use Cases - Concept Grounding: Tracks which ideas the reader already knows and forces every new concept to be introduced before later paragraphs can rely on it. - Paragraph-by-Paragraph Drafting: Drafts candidate openings, then grows the article one block at a time, appending each agreed block to the article file immediately. - Deliberate Format Choices: Argues explicitly about prose vs. lists, tables vs. repeated structure, quotes vs. paraphrase, and callouts vs. inline text. - Use Case: You have a messy transcript from a brainstorming session. Point the Skill at the file, pick an opening angle, and collaboratively build a publishable article while the raw material stays untouched. ## Quick Start Use the writing-shape skill to shape my raw notes in ideas.md into an article saved 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 run a shaping session. The Skill reads the pile in full, drafts 2-3 candidate openings with different angles, then grows the article paragraph by paragraph, appending each agreed block to a separate article file.

How to keep article concepts in a logical order for readers?▼

Use concept grounding: settle which ideas the reader knows as prerequisites, then ensure every block introduces new concepts before later blocks lean on them. The Skill maintains a running list of grounded concepts and flags ungrounded ones before each move.

Does the shaping process modify my original notes file?▼

No, the raw material file is read-only to this Skill. It treats the input as a quarry to mine, reworking fragments into the article, while all output is appended to a separate article document you specify.

What happens when my raw material is missing content 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 on the spot or cut that section; it never invents content not in the pile.

When should I use prose versus lists or tables in an article?▼

Prose carries argument while lists carry truly parallel items; a table fits when the same shape repeats three or more times with the same fields. The Skill weighs these tradeoffs out loud with you for every block rather than choosing silently.