writing-shape

Shapes raw markdown notes into a publishable article through a conversational drafting session.

20|2|Updated May 16, 2026
One-click install
npx skills add https://github.com/reddb-io/red-skills --skill writing-shape-reddb-io
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/reddb-io/red-skills/tree/main/plugins/dev/skills/in-progress/writing-shape
Command: npx skills add https://github.com/reddb-io/red-skills --skill writing-shape-reddb-io

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a pile of raw notes, fragments, or a rough draft into a coherent article is hard to do alone — this Skill runs a structured, conversational shaping session that drafts openings, grows the piece paragraph by paragraph, and argues about format choices at every step. ## Core Features & Use Cases - Candidate Openings: Drafts 2-3 openings implying different theses and forces a deliberate choice that defines the article's direction. - Paragraph-by-Paragraph Growth: Pulls material from the raw pile, appends each agreed block to the article file immediately, and re-reads the file before every write to preserve user edits. - Format Deliberation: Argues out loud about prose vs. lists, tables vs. repeated structure, callouts, quotes, and code blocks so every format choice is defensible. - Use Case: You have a markdown file of unstructured conference notes and want to turn it into a publishable blog post — the Skill mines the pile, names gaps where material is missing, and builds the article iteratively with you. ## Quick Start Use the writing-shape skill to turn my raw notes file 'notes.md' into a publishable article saved to 'article.md'.

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 into a publishable article?▼

Provide a markdown file of raw material and the Skill runs a shaping session: it drafts 2-3 candidate openings, then grows the article paragraph by paragraph by mining the pile. Each agreed block is appended to a separate article file as you go.

How to choose between prose, lists, and tables when writing?▼

Prose carries argument while lists carry truly parallel items; tables fit when the same shape repeats 3+ times with the same fields. The Skill argues these tradeoffs out loud at each step so every format choice is deliberate and defensible.

Does the writing session edit my original notes file?▼

No, the raw material file is read-only to this Skill. The article is written to a separate file, and the Skill re-reads that file from disk before every write so your manual edits between turns are never overwritten.

What happens when my notes are missing material the article needs?▼

The Skill names the gap explicitly, for example stating that an example is needed and the pile does not have one. You either supply the missing material on the spot or that section is cut from the article.

When should I not use a conversational article shaping session?▼

Avoid it when you need new research or fragments beyond your existing pile, platform-specific publishing formatting, or frontmatter generation. The Skill only mines the provided material and does not handle publishing tasks.