writing-shape

Transform markdown notes into a publishable article through iterative drafting.

13|3|Updated May 12, 2026
One-click install
npx skills add https://github.com/kevinnft/ai-agent-skills --skill writing-shape-kevinnft
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/kevinnft/ai-agent-skills/tree/main/skills/mattpocock/in-progress/writing-shape
Command: npx skills add https://github.com/kevinnft/ai-agent-skills --skill writing-shape-kevinnft

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The user has a markdown file of raw material (notes, fragments, or a rough draft). This Skill reads the pile end-to-end and treats it as the input material for a shaping session that produces a separate article document, preserving the original pile as read-only.

Core Features & Use Cases

  • Conversational, stepwise drafting: proposes 2–3 openings and grows the article paragraph by paragraph with user guidance.
  • Flexible formatting decisions: selects prose, lists, tables, callouts, quotes, or code blocks based on what best serves the argument.
  • Keeps the source material intact: never edits the input pile; writes only to the target article file as directed.

Quick Start

Ask for the save path (if not provided) and begin shaping the input pile 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 markdown notes into a publishable article?

To turn raw markdown notes into a publishable article, the Skill reads your fragmented notes end-to-end and uses a stepwise shaping loop to draft openings and grow the content paragraph by paragraph into a new article file. It preserves your original pile as read-only while appending guided writing beats to the target document.

What is the best way to draft an article from a rough outline step by step?

The best way to draft an article from a rough outline is through an iterative shaping process that proposes multiple openings and decides on subsequent beats sequentially. The Skill re-reads the source material before each append operation, ensuring the growing draft remains aligned with your original fragments and formatting requirements.

Can I convert a markdown draft into an article without altering my original notes?

Yes, you can convert a markdown draft without altering original notes because the Skill treats your input pile as a read-only source. It writes exclusively to a separate target article file, safely preserving your initial fragments, outlines, and rough drafts throughout the entire editing process.

How does the writing process handle different formatting options like tables and callouts?

The writing process handles formatting options like tables, callouts, lists, and code blocks by selecting the layout that best serves the argument at each stage. During the stepwise drafting loop, the Skill dynamically chooses prose or structural markdown elements to enhance the publishable article's readability.

What do I need to start shaping my fragmented notes into a complete document?

To start shaping fragmented notes into a complete document, you need a markdown file containing your raw material and a save path for the target article. The Skill will read this input pile and immediately begin proposing conversational openings to initiate the paragraph-by-paragraph drafting sequence.

Why use a conversational drafting loop instead of generating the entire article at once?

A conversational drafting loop is used instead of generating the entire article at once to maintain narrative control and structural coherence. By proposing openings and deciding subsequent beats iteratively, the process re-reads the source material before every write, ensuring the publishable article accurately reflects your raw notes.