writing-shape

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

Updated Jul 30, 2026
One-click install
npx skills add https://github.com/j172/bid --skill writing-shape-j172
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/j172/bid/tree/main/agent/skills/writing-shape
Command: npx skills add https://github.com/j172/bid --skill writing-shape-j172

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 - Structured shaping loop: Read the input pile, settle reader prerequisites, draft 2-3 candidate openings, then grow the article paragraph by paragraph with the user. - Concept grounding discipline: Tracks which concepts are grounded (prerequisite or introduced) so no block leans on ideas the reader has not met yet. - Deliberate format choices: Argues out loud about prose vs. list, callout vs. inline, table vs. repeated structure, quote vs. paraphrase, and code block vs. inline code. - 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 polished article appended block by block to a separate output file. ## Quick Start Shape the raw material in notes.md into an article and save it to article.md, starting by proposing a few candidate openings.

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, proposes 2-3 candidate openings, then grows the article paragraph by paragraph with you. Each agreed block is appended immediately to a separate article file.

What is concept grounding in article writing?

Grounding means every concept must be known to the reader before a block 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 gaps before making a move.

Does the 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 shaped output to a separate article document, re-reading that file before every write to avoid overwriting your edits.

When should I use a list versus prose in an article?

Prose carries argument while lists carry parallel items. If items are not truly parallel, prose is better; if they are, a list is faster to scan. The Skill weighs this tradeoff out loud for each block.

What happens if my raw material is missing something the article needs?

The Skill names the gap explicitly, for example asking you to supply a missing example or agreeing to cut the section. It does not invent new material that is not in the pile.