writing-shape

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

2|Updated May 12, 2026
One-click install
npx skills add https://github.com/tajo9128/BioDockify-Pharma-AI --skill writing-shape-tajo9128
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/tajo9128/BioDockify-Pharma-AI/tree/main/.agents/skills/writing-shape
Command: npx skills add https://github.com/tajo9128/BioDockify-Pharma-AI --skill writing-shape-tajo9128

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 block to build only on grounded ideas, preventing confusing leaps. - Paragraph-by-Paragraph Drafting: Drafts candidate openings, then grows the article one block at a time, appending each agreed block to the article file immediately. - Deliberate Format Choices: Argues explicitly about prose vs. list, table vs. repeated structure, quote vs. paraphrase, and callout usage for every block. - Use Case: You have a messy markdown file of research fragments. The Skill reads it end-to-end, proposes 2-3 openings, and collaboratively builds a polished article in a separate file without touching the raw material. ## Quick Start Use the writing-shape skill to turn my raw notes file notes.md into a structured 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 structured article?

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

What is concept grounding in article writing?

Grounding means every concept must be known to the reader before a block can rely on it, either as a prerequisite established upfront or introduced by an earlier block. The Skill keeps a running list of grounded concepts and flags gaps before drafting.

Does the writing-shape skill edit my raw material file?

No, the raw material file is read-only to this Skill. It mines fragments from the pile and writes the shaped output to a separate article document, leaving the source untouched.

When should I use prose versus a list or table in an article?

Prose carries argument while lists carry parallel items; use a table when the same shape repeats three or more times with identical fields. The Skill debates these format tradeoffs explicitly for each block rather than choosing silently.

What are the limitations of the writing-shape skill?

It cannot mine new material beyond the provided pile, edit the source file, or handle publishing and platform-specific formatting. If the pile lacks needed content, it names the gap and asks you to supply it or cut the section.