writing-shape

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

3|1|Updated May 29, 2026
One-click install
npx skills add https://github.com/mambo-wang/CodingHub --skill writing-shape-mambo-wang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/mambo-wang/CodingHub/tree/main/.codebuddy/skills/writing-shape
Command: npx skills add https://github.com/mambo-wang/CodingHub --skill writing-shape-mambo-wang

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 disciplined 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 already knows and forces every new idea to be introduced before later paragraphs can rely on it. - Paragraph-by-Paragraph Drafting: Drafts 2-3 candidate openings, then grows the article block by block, appending each agreed paragraph to the article file immediately. - Deliberate Format Choices: Argues explicitly about prose vs. list, table vs. repeated structure, quote vs. paraphrase, and callout usage for every block. - Use Case: You have a messy markdown file of interview notes and fragments. The Skill reads it end-to-end, helps you pick an opening angle, then builds the article incrementally while flagging gaps where the pile lacks needed material. ## Quick Start Use the writing-shape skill to turn my raw notes file notes.md into a structured 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 the Skill reads it end-to-end, drafts 2-3 candidate openings, then grows the article paragraph by paragraph. Each agreed block is appended to a separate article file immediately so you can watch it take shape.

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 established up front 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 skill edit my raw material 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, and writes output only to a separate article file you specify.

What happens when my notes are missing material the article needs?▼

The Skill names the gap explicitly, telling you the pile lacks something the article needs, such as an example. You then supply the missing material or agree to cut that section.

When should I use prose versus a list or table?▼

Prose carries argument while lists carry parallel items; if items are not truly parallel, prose is better. Tables fit when the same shape repeats three or more times with the same fields, and the Skill argues these tradeoffs out loud for each block.