writing-shape

Shapes raw markdown material into a structured article paragraph by paragraph.

10|3|Updated Jul 18, 2019
One-click install
npx skills add https://github.com/tanqimin/MyFavsORM --skill writing-shape-tanqimin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/tanqimin/MyFavsORM/tree/main/.agents/skills/writing-shape
Command: npx skills add https://github.com/tanqimin/MyFavsORM --skill writing-shape-tanqimin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a pile of raw notes, fragments, or transcripts into a coherent article is hard: structure is unclear, concepts arrive out of order, and weak transitions slip through. This Skill runs an interactive shaping session that commits to a structure and mines the raw material to fill it. ## Core Features & Use Cases - Concept Grounding: Tracks which concepts the reader already knows and forces every new idea to be introduced before later paragraphs can rely on it. - Paragraph-by-Paragraph Drafting: Drafts 2-3 candidate openings, then grows the article block by block, appending each agreed paragraph to the article file immediately. - Deliberate Format Choices: Argues explicitly about prose vs. list, table vs. repeated structure, quote vs. paraphrase, and callout vs. inline for every block. - Use Case: You have a messy transcript from a brainstorming session. Provide it as the raw material file, pick an opening angle, and collaboratively build a polished article while the Skill names gaps where the pile lacks needed material. ## Quick Start Shape the raw material in notes.md into an article and save it to article.md, starting by proposing a few 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 raw notes into a structured article?

Provide the raw material as a markdown file and run a shaping session. The process reads the pile in full, settles reader prerequisites, drafts candidate openings, then grows the article paragraph by paragraph, appending each agreed block to the article file.

What is concept grounding in article writing?

Grounding means every concept must be known to the reader before a paragraph can rely on it, either as a prerequisite established up front or introduced by an earlier block. A running list of grounded concepts prevents paragraphs from leaning on ideas the reader has not met.

Does this writing process edit my original notes file?

No. The raw material file is read-only during the session. Fragments are pulled, reworked, split, or merged into a separate article document, and gaps in the pile are named explicitly rather than filled by inventing material.

When should content be a list instead of prose?

Use a list when items are truly parallel, since lists scan faster; use prose when the content carries an argument. The same logic applies to tables for repeated structures, callouts for asides, and code blocks for multi-line examples.

What are the limitations of this article shaping approach?

It does not mine for new material beyond the provided pile, does not edit the raw file, and does not handle publishing or platform-specific formatting. Missing content must be supplied by the user or the affected section is cut.