skills.rest
NauelG
NauelGCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

writing-shape

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

28|1|Updated Mar 15, 2026
Search Tags:#writing#markdown#editing#copywriting#content structure#article#drafting
One-click install
npx skills add https://github.com/NauelG/astro-blocks --skill writing-shape-nauelg
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/NauelG/astro-blocks/tree/main/.agents/skills/writing-shape
Command: npx skills add https://github.com/NauelG/astro-blocks --skill writing-shape-nauelg

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, paragraph by paragraph. ## Core Features & Use Cases - Concept grounding tracking: Maintains a running list of grounded concepts so every paragraph only leans on ideas the reader already knows, flagging gaps before they lose the reader. - Candidate openings: Drafts 2-3 alternative openings implying different theses, forcing an explicit choice that defines what the rest of the article must do. - Deliberate format decisions: Argues out loud about prose vs. list, table vs. repeated structure, quote vs. paraphrase, and callout vs. inline for each block. - Incremental file writes: Appends each agreed block to the article file immediately, re-reading from disk before every write to respect user edits. - Use Case: You have a messy transcript from a brainstorming session. Provide it as the raw material file, pick an opening from the candidates, and iteratively build a polished article while the Skill mines the transcript for supporting fragments. ## Quick Start Use the writing-shape skill to turn my raw notes file notes.md into an article saved at 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 that drafts candidate openings, then grows the article paragraph by paragraph. Each block is mined from the pile, reworked to fit, and appended to a separate article file as you agree on it.

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 any move that requires an ungrounded idea.

Does the skill edit my raw material file?▼

No, the raw material file is read-only to this Skill. It is treated as a quarry to mine for fragments, while the article is written to a separate output file that you specify.

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

Use prose when carrying an argument and lists when items are truly parallel and benefit from fast scanning. The Skill weighs this tradeoff explicitly for each block, along with table vs. repeated structure and quote vs. paraphrase decisions.

What happens if my 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 contain one. You then supply the missing material on the spot or cut that section, since mining new fragments outside the pile is out of scope.

Related Skills

Explore More Content & Communication Skills→
babuallybabually
1

writing-fragments

Collect raw writing fragments via interview and append them to a markdown document.

Community
Intermediate
brainbrewlabsbrainbrewlabs
7

publishing

Format and distribute finalized content to publishing platforms with scheduling and verification.

Official
Intermediate
Norman-Norman-NormanNorman-Norman-Norman
7

editor

Analyze documentation text for grammar, style, and factual accuracy.

Official
Basic
kevinnftkevinnft
13

writing-shape

Transform markdown notes into a publishable article through iterative drafting.

Community
Advanced