writing-shape

Shape raw markdown notes into a publishable article draft.

5|Updated May 21, 2026
One-click install
npx skills add https://github.com/TrebuchetDynamics/pi-package-goal --skill writing-shape-trebuchetdynamics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/TrebuchetDynamics/pi-package-goal/tree/main/skills/writing-shape
Command: npx skills add https://github.com/TrebuchetDynamics/pi-package-goal --skill writing-shape-trebuchetdynamics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

writing-shape helps you transform scattered notes, fragments, transcripts, or messy prose into a coherent, publishable article with a clear thesis and reader-first structure.

Core Features & Use Cases

  • Build a publishable draft from a read-only pile: treats the input markdown as raw material and produces a separate article document without editing the original.
  • Choose and lock in openings that define the whole piece: drafts multiple candidate openings, forces a selection, and uses that choice to drive the rest of the structure.
  • Grow paragraph-by-paragraph with deliberate format decisions: decides whether each beat should be prose, list, table, callout, quote, or code block based on what the reader needs next.
  • Preserve user edits during the session: re-reads the article file from disk before writing so user changes aren’t overwritten.
  • Guardrails against weak transitions: pushes back on paragraphs that don’t earn their place and keeps the promised opening aligned with the evolving argument.

Quick Start

Use writing-shape on your input markdown by asking it to shape the attached pile into an article and to save the result to a new file path you provide.

Frequently Asked Questions about writing-shape

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

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

A markdown editing session shapes scattered fragments by reading the input pile, drafting candidate openings for selection, and appending agreed blocks to a separate article file without overwriting your original notes or manual edits.

What is the best way to structure a thesis from messy prose fragments?

Structuring a thesis from fragments involves drafting two to three candidate openings, forcing a selection to drive the argument, and growing the text beat-by-beat with format decisions like prose, lists, or callouts to serve the reader's needs.

Can I preserve my manual edits during an article drafting session?

An article drafting session preserves manual edits by re-reading the article file from disk before appending new blocks, ensuring user changes made between steps are never overwritten during the conversational workflow.

How do I choose the right formatting for each paragraph in an article?

Choosing paragraph formatting involves deciding whether each beat should be prose, list, table, callout, quote, or code block based on what the reader needs next, ensuring deliberate format decisions drive the article's structure.

What happens to weak transitions when restructuring markdown into an article?

When restructuring markdown, guardrails against weak transitions push back on paragraphs that do not earn their place, keeping the promised opening aligned with the evolving argument throughout the drafting session.