writing-shape

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

Updated Aug 11, 2026
One-click install
npx skills add https://github.com/Kunj-Sharma03/agent-contextify --skill writing-shape-kunj-sharma03
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/Kunj-Sharma03/agent-contextify/tree/main/skills-main/skills/in-progress/writing-shape
Command: npx skills add https://github.com/Kunj-Sharma03/agent-contextify --skill writing-shape-kunj-sharma03

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a messy pile of 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. ## Core Features & Use Cases - Concept Grounding: Tracks which concepts the reader knows, ensuring every paragraph only leans on ideas already introduced or established as prerequisites. - Paragraph-by-Paragraph Drafting: Drafts 2-3 candidate openings, then grows the article block by block, appending each agreed section 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 transcript of a brainstorming session and want to turn it into a blog post. The Skill reads the file, proposes openings, and builds the article with you one paragraph at a time without touching the original notes. ## Quick Start Ask the assistant to 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 run a shaping session. The process reads the pile, drafts 2-3 candidate openings for you to choose from, then grows the article paragraph by paragraph, appending each agreed block to a separate article file.

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 upfront or introduced by an earlier block. The session keeps a running list of grounded concepts and flags gaps before making a move.

Does the writing process modify my original notes file?

No, the raw material file is read-only during the session. The article is written to a separate file, and the file is re-read from disk before every write so your manual edits between turns are never overwritten.

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

The gap is named explicitly, for example when an example is needed but the pile has none. You either supply the missing material on the spot or the affected section is cut, since mining new fragments outside the pile is out of scope.

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

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 callouts are reserved for asides that would derail the main argument inline.