skills.rest
babually
babuallyCOMMUNITY
Explore all skills by this author →
GitHub

writing-shape

Transform raw markdown notes into a structured article through iterative drafting.

1|Updated Jun 27, 2026
Search Tags:#writing#markdown#editing#revision#article drafting#content shaping
One-click install
npx skills add https://github.com/babually/bongo-template --skill writing-shape-babually
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/babually/bongo-template/tree/main/.agents/skills/writing-shape
Command: npx skills add https://github.com/babually/bongo-template --skill writing-shape-babually

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps transform raw markdown notes, fragments, transcripts, or rough drafts into a coherent article without overwriting the original material. It is useful when you have useful content but need help deciding the argument, structure, and order of ideas.

Core Features & Use Cases

  • Candidate openings: Drafts 2–3 different openings so the user can choose the strongest angle.
  • Paragraph-by-paragraph shaping: Grows the article one beat at a time, asking what the reader needs next and pushing back when a transition is weak.
  • Format decisions: Deliberates between prose, lists, tables, callouts, quotes, and code blocks based on what best serves the argument.
  • Example use case: A user has a messy markdown dump from research notes and wants it turned into a publishable article while preserving their original source file.

Quick Start

Use the writing-shape skill to read this markdown draft and help me turn it into a publishable article, starting by proposing three candidate openings.

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 structured article?▼

This skill transforms raw markdown notes into a structured article by reading your source content, proposing multiple candidate openings, and iteratively shaping paragraphs while deciding on formats like prose, lists, or tables.

What is the best way to draft an article from messy research fragments?▼

The best way to draft an article from messy fragments is through paragraph-by-paragraph shaping, which grows the content one beat at a time and pushes back when transitions are weak.

Can I shape transcripts and rough drafts without overwriting the original markdown file?▼

Yes, you can shape transcripts and rough drafts without overwriting the original file, as this process requires preserving the source content while producing a separate, newly structured article document.

How do I choose the right format when converting raw notes into an article?▼

Choosing the right format when converting raw notes involves deliberating between prose, lists, tables, callouts, quotes, and code blocks based on what best serves the argument and the reader's needs.

Does article drafting work with unshaped markdown dumps from research notes?▼

Yes, article drafting works with unshaped markdown dumps from research notes, applying iterative revision to transform fragment collections and transcripts into a publishable article with deliberate structure.

Related Skills

Explore More Content & Communication Skills→
kartikkabadikartikkabadi

writing-shape

Shapes raw markdown material into a coherent article via conversational drafting and iterative editing.

Community
Advanced
xianmingyaoxianmingyao
1

social-media-publish

Automates publishing formatted drafts to WeChat Official Accounts, Baijiahao, and Xiaohongshu via browser automation.

Community
Intermediate
miptah21miptah21
2

writing-shape

Convert raw markdown notes into a coherent article through iterative shaping.

Community
Intermediate
az9713az9713

writing-shape

Transform rough notes into a structured article through an interactive shaping workflow.

Community
Advanced