writing-shape

Transform unstructured raw markdown notes into coherent publishable articles.

88|9|Updated Jul 16, 2020
One-click install
npx skills add https://github.com/docs-plus/docs.plus --skill writing-shape-docs-plus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/docs-plus/docs.plus/tree/main/.agents/skills/writing-shape
Command: npx skills add https://github.com/docs-plus/docs.plus --skill writing-shape-docs-plus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the frustration of having unstructured raw markdown notes, fragments, or rough drafts that you can't easily turn into coherent, publishable articles, saving you hours of manual reorganization and rewriting.

Core Features & Use Cases

  • Iterative Conversational Shaping: Guides you through a collaborative, iterative session to refine your article's angle, structure, and argument flow.
  • Deliberate Format Optimization: Weighs tradeoffs between prose, lists, tables, callouts, quotes, and code blocks to select the optimal format for each section.
  • Use Case: If you have a pile of unorganized research notes, meeting transcripts, or a messy rough draft for a blog post or documentation, use this Skill to transform it into a polished, cohesive article without starting from scratch.

Quick Start

Share your raw markdown notes file with the Skill and follow its conversational prompts to shape it into a polished, 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, you can use an iterative conversational shaping process that refines your unstructured fragments and rough drafts into a cohesive final structure without requiring a complete rewrite.

Can I preserve my manual edits while shaping rough drafts?

Yes, you can preserve your manual edits during the content shaping process. The iterative collaborative drafting workflow deliberately safeguards your existing markdown text while reorganizing the overall article structure.

What is the best way to structure messy research notes for a blog post?

The best way to structure messy research notes is through deliberate format optimization, which evaluates tradeoffs between prose, lists, tables, callouts, quotes, and code blocks to select the ideal layout for each section of your article.

Does collaborative writing work for reorganizing meeting transcripts into documentation?

Collaborative writing works effectively for reorganizing meeting transcripts into documentation by guiding users through an iterative session to refine the angle, structure, and argument flow of the raw unorganized text.

Why should I use conversational prompts for content editing instead of rewriting from scratch?

You should use conversational prompts for content editing because it saves hours of manual reorganization by transforming unstructured markdown drafts into polished articles collaboratively, eliminating the frustration and effort of starting from scratch.

When do I need format optimization for markdown content writing?

You need format optimization for markdown content writing when you have unstructured fragments requiring deliberate selection between prose, lists, tables, callouts, quotes, and code blocks to ensure the final article is polished and readable.