writing-shape

Convert raw markdown notes into a coherent article through iterative shaping.

2|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/miptah21/skills --skill writing-shape
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/miptah21/skills/tree/main/.agents/skills/writing-shape
Command: npx skills add https://github.com/miptah21/skills --skill writing-shape

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps convert scattered notes, fragments, or rough prose into a cohesive, reader-ready article by actively shaping structure, flow, and format decisions.

Core Features & Use Cases

  • Guided shaping session: Reads an input markdown pile end-to-end and produces a separate article document without editing the source.
  • Thesis-first openings: Drafts 2–3 candidate openings that imply different angles, then aligns the rest of the article to the chosen opening.
  • Paragraph-by-paragraph growth: Iteratively decides what comes next and argues for the best representation (prose, lists, tables, callouts, quotes, or code blocks) based on reader needs.
  • Preserves user edits: Re-reads the target article file before writing each new block so user modifications aren’t lost.
  • Gap detection: Identifies missing examples or content the pile doesn’t contain and requests the user to fill them or cuts weak sections.

Quick Start

Use writing-shape with your rough notes file, and ask the agent to shape it into a publishable article by selecting an opening and growing the piece block-by-block into a dedicated article document.

Frequently Asked Questions about writing-shape

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn messy markdown notes into a publishable article?

To turn messy markdown notes into a publishable article, use a thesis-driven shaping loop that reads raw fragments end-to-end, drafts candidate openings, and incrementally builds a coherent document block-by-block. The process preserves your source file without editing it.

Can I convert unstructured transcripts into a structured article without losing my manual edits?

Yes, you can convert unstructured transcripts into a structured article safely. The shaping process re-reads the target article file before appending each new block, ensuring your manual edits and modifications are preserved during paragraph-by-paragraph expansion.

What is the best way to structure content formatting decisions when drafting an article?

The best way to structure content formatting decisions is to explicitly negotiate them during the drafting loop. The process argues for the best representation—such as prose, lists, tables, callouts, quotes, or code blocks—based on reader needs to maintain argumentative continuity.

How do I identify missing content or gaps when expanding a rough draft?

To identify missing content when expanding a rough draft, the shaping process performs gap detection. It identifies missing examples or content your notes lack, then requests you to fill them or cuts weak sections to maintain the article's argumentative strength.

Does this article drafting method work with fragment lists and rough prose?

Yes, this article drafting method works with fragment lists, rough prose, and transcripts. It reads unstructured input fully, drafts two to three candidate openings implying different angles, and aligns the remaining article growth to your chosen opening.

When should I avoid using an iterative shaping loop for content structuring?

You should avoid using an iterative shaping loop for content structuring if your raw notes require no argumentative continuity or format negotiation. The process relies on incrementally deciding what comes next and expanding paragraph-by-paragraph, which is unnecessary for already polished text.