writing-shape

Shape a Markdown input file into a structured article through an interactive session.

118|12|Updated May 5, 2026
One-click install
npx skills add https://github.com/alecs5am/ralphy --skill writing-shape-alecs5am
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/alecs5am/ralphy/tree/main/notes/skills/writing-shape
Command: npx skills add https://github.com/alecs5am/ralphy --skill writing-shape-alecs5am

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables you to transform a raw Markdown pile of notes, fragments, or rough drafts into a polished article through an interactive shaping session. It preserves the original input by treating it as read-only and iteratively builds the final piece with user-approved openings and paragraph structure.

Core Features & Use Cases

  • Conversational shaping loop: read the input pile, draft multiple openings, and let the user pick or hybridize.
  • Paragraph-by-paragraph growth: decide next beats (paragraph, list, table, callout, or quote) and append to the article in real time.
  • Editing discipline: never modify the raw material; the final article is produced to a separate file, with path saved upon request.
  • Use Case: ideal for turning notes, meeting transcripts, or draft outlines into publishable blog posts or reports.

Quick Start

Provide the path to the input Markdown file and tell me where to save the final 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 structured article?

Converting markdown notes into a structured article involves an interactive shaping session that reads your input pile, drafts multiple openings, and grows paragraphs paragraph-by-paragraph into a final file.

What is the best way to draft an article from rough fragments without losing original notes?

Drafting an article from rough fragments without losing originals uses a read-only input approach, saving the shaped article to a separate user-specified path to ensure original notes remain unmodified.

Can I choose specific content formats like lists or callouts when shaping a draft?

During the interactive shaping session, you can choose specific formats including lists, tables, callouts, and quotes, deciding the next paragraph beat and appending it to the article in real time.

How does editing work if I manually edit the markdown article during the shaping process?

If you manually edit the markdown article during the shaping process, the skill re-reads the article file before writing new content, ensuring your manual edits are preserved before appending new formatted paragraphs.

Do I need to format my meeting transcripts before using them to generate a report?

You do not need to format meeting transcripts before generating a report because the skill reads the raw markdown input pile in full and structures it through the conversational drafting loop.