writing-shape

Shape raw markdown notes into structured articles through conversation.

Updated Jun 12, 2026
One-click install
npx skills add https://github.com/Kushal9889/claude-plugins --skill writing-shape-kushal9889
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/Kushal9889/claude-plugins/tree/main/mattpocock-skills/skills/in-progress/writing-shape
Command: npx skills add https://github.com/Kushal9889/claude-plugins --skill writing-shape-kushal9889

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill turns disorganized notes or rough drafts into coherent, publishable articles through a conversational shaping process.

Core Features & Use Cases

  • Conversational Shaping: Collaboratively shape articles paragraph by paragraph.
  • Format Arguments: Guide on choosing the best format for each piece (lists, tables, callouts, quotes).
  • Loop until completion: Iteratively refine the article until the user is satisfied.
  • Use Case: Ideal for writers who have a pile of notes or a rough draft and need help structuring and refining their work.

Quick Start

Pass a markdown file of raw material to the writing-shape skill and engage in a shaping session to create a publishable article.

Frequently Asked Questions about writing-shape

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

FAQPage Schema
How do I turn disorganized notes into a structured article?

You can turn disorganized notes into a structured article by passing raw markdown material to a conversational shaping interface that iteratively refines the text paragraph by paragraph until publishable.

What is conversational shaping for article development?

Conversational shaping is an editorial workflow process where you collaboratively format and refine rough drafts into coherent articles through iterative dialogue, receiving guidance on choosing lists, tables, callouts, and quotes.

How do I choose the best markdown format for my article sections?

To choose the best markdown format for article sections, engage in a conversational shaping session that provides specific format arguments, guiding you to select between lists, tables, callouts, or quotes for each paragraph.

Can I refine a rough draft iteratively until it is publishable?

Yes, you can iteratively refine a rough draft until it is publishable by looping through conversational guidance, shaping the content paragraph by paragraph until you are completely satisfied with the final structure.

Do I need formatted markdown before starting the editorial workflow?

Yes, you need raw markdown material to start the editorial workflow, as the conversational shaping process takes your unstructured notes or rough drafts as input to begin formatting and structuring the article.

What is the best way to structure a pile of unstructured notes?

The best way to structure unstructured notes is using a conversational shaping process that breaks down the raw markdown material, applies format guidance, and loops iteratively to build a coherent, publishable article.