writing-shape

Shapes raw markdown material into a structured article through paragraph-by-paragraph drafting.

Updated Sep 20, 2024
One-click install
npx skills add https://github.com/AnasIsmai1/dotfiles --skill writing-shape-anasismai1
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/AnasIsmai1/dotfiles/tree/main/agents/.agents/skills/writing-shape
Command: npx skills add https://github.com/AnasIsmai1/dotfiles --skill writing-shape-anasismai1

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 knows, ensuring every paragraph only leans on ideas already introduced or established as prerequisites. - Paragraph-by-Paragraph Drafting: Drafts 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. lists, tables vs. repeated structure, quotes vs. paraphrase, and callouts vs. inline text. - Use Case: You have a messy markdown file of interview notes and fragments. The Skill reads it end-to-end, proposes three candidate openings, then builds the article with you paragraph by paragraph, naming gaps where the pile lacks needed material. ## Quick Start Use the writing-shape skill to shape my raw notes in 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 the Skill reads it end-to-end, drafts 2-3 candidate openings with different angles, then grows the article paragraph by paragraph. Each agreed block is appended to a separate article file as you go.

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 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 pile as a quarry to mine, splitting, merging, or paraphrasing fragments into a separate article document that you choose the path for.

When should I use prose versus a list 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 rather than deciding silently.

What happens when my notes are missing material 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 or the section is cut, since mining for new content outside the pile is out of scope.