writing-shape

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

1|Updated Jul 5, 2026
One-click install
npx skills add https://github.com/yersonargotev/packy --skill writing-shape-yersonargotev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/yersonargotev/packy/tree/main/bundle/skills/in-progress/writing-shape
Command: npx skills add https://github.com/yersonargotev/packy --skill writing-shape-yersonargotev

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, paragraph by paragraph. ## Core Features & Use Cases - Concept grounding discipline: Tracks which concepts the reader already knows and forces every new idea to be grounded before later paragraphs can rely on it. - Candidate openings: Drafts 2-3 alternative openings with different theses so the user picks the article's angle before drafting continues. - Deliberate format choices: Argues out loud about prose vs. lists, tables, callouts, quotes, and code blocks so every block earns its form. - Use Case: You have a messy markdown file of interview notes and fragments. The Skill reads it end-to-end, helps you settle prerequisites and an opening, then appends each agreed paragraph to a separate article file until the piece is done. ## Quick Start Ask the assistant to use the writing-shape skill to shape your raw notes file into an article saved at a path you specify.

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 with different theses, then grows the article paragraph by paragraph. Each agreed block is appended to a separate article file as you go.

How does the skill decide what order paragraphs should go in?▼

It uses concept grounding: every concept must be a stated prerequisite or introduced by an earlier block before later paragraphs can rely on it. When the next move needs an ungrounded concept, grounding it becomes the next step.

Does the skill 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 it never overwrites your edits.

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

The Skill names the gap explicitly, for example asking you to supply a missing example or agreeing to cut the section. It does not invent new fragments that are not in the pile.

When should I not use this writing approach?▼

Avoid it when you are still exploring ideas rather than committing to a structure, since this is the exploit phase. It also does not handle publishing, platform-specific formatting, or adding frontmatter you did not request.