writing-shape

Shape raw markdown notes into a polished article through guided drafting sessions.

Updated May 7, 2026
One-click install
npx skills add https://github.com/hgxszhj/mattpocock_skills --skill writing-shape-hgxszhj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/hgxszhj/mattpocock_skills/tree/main/skills/in-progress/writing-shape
Command: npx skills add https://github.com/hgxszhj/mattpocock_skills --skill writing-shape-hgxszhj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Take a markdown file of raw material and shape it into an article through a conversational session — drafting candidate openings, growing the piece paragraph by paragraph, arguing about format (lists, tables, callouts, quotes) at each step. Use when you have a pile of notes, fragments, or a rough draft and want help turning it into something publishable.

Core Features & Use Cases

  • Draft 2–3 candidate openings and select or hybrid them to define the article's thesis.
  • Grow paragraph by paragraph, choosing the next beat and the appropriate format (prose, list, table, callout, or quote) to fit the argument.
  • Append to a separate article document incrementally, preserving the original material as read-only input.
  • Collaborate through a grilling-style session that pushes for clear reasoning, strong transitions, and precise structure.

Quick Start

Provide a raw markdown file as input and start a shaping session to turn it into 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 raw notes and fragments into a publishable article?

To turn raw notes into a publishable article, you provide a markdown file of fragments and engage in a guided shaping session that drafts candidate openings, grows the text paragraph by paragraph, and selects appropriate formatting like prose, lists, or tables.

What is the best way to draft an article from a rough markdown pile incrementally?

Drafting an article incrementally from a markdown pile involves appending shaped paragraphs to a separate document while preserving the original input as read-only, enforcing explicit decisions on structure and format at each step of the writing process.

Can I use conversational drafting to structure my rough drafts into formatted articles?

Yes, conversational drafting structures rough drafts by using a grilling-style session that argues about formatting at each step, pushes for clear reasoning and strong transitions, and allows you to select or hybridize candidate openings to define the thesis.

Does this article shaping process preserve my original notes and fragments?

Yes, the article shaping process preserves your original notes by treating the source markdown file as read-only input and appending the incrementally grown article paragraphs to a completely separate document.

How do I choose the right format for each paragraph when writing an article from notes?

To choose the right format for each paragraph, the shaping session guides you to fit the argument by selecting between prose, lists, tables, callouts, or quotes as you grow the piece paragraph by paragraph.