writing-shape

Shapes raw markdown material into a structured article through iterative paragraph drafting.

2|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/IsKenKenYa/skills --skill writing-shape-iskenkenya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-shape
Source: https://github.com/IsKenKenYa/skills/tree/main/skills/in-progress/writing-shape
Command: npx skills add https://github.com/IsKenKenYa/skills --skill writing-shape-iskenkenya

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 drafts drift from their opening thesis. This Skill runs a guided 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 block to only lean on grounded ideas, introducing or prerequisite-ing the rest. - Candidate openings: Drafts 2-3 alternative openings implying different theses, so the article's angle is chosen deliberately before drafting continues. - Deliberate format choices: Argues out loud about prose vs. list, table vs. repeated structure, quote vs. paraphrase, and callout usage for every block. - Incremental file writing: Appends each agreed block to the article file immediately, re-reading from disk before every write to respect user edits. - Use Case: You have a messy transcript from a brainstorming session. Point the Skill at the file, pick an opening, and collaboratively grow it into a polished article while the raw material stays read-only. ## Quick Start Ask the assistant to run a writing-shape session on your raw notes file and save the resulting article to 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 run a shaping session. The process drafts 2-3 candidate openings, lets you pick a thesis, then grows the article paragraph by paragraph by pulling and reworking fragments from your notes.

What input formats does this writing workflow accept?

It accepts any markdown file of raw material: tidy fragment lists, walls of unstructured prose, or transcripts. The format does not matter because the file is read end-to-end first and treated as a quarry to mine, not a script to follow.

Does the shaping process modify my original notes file?

No, the raw material file is strictly read-only. The article is written to a separate file, with each agreed block appended immediately so you can watch it take shape and edit between turns.

What happens when my raw material is missing something the article needs?

The gap is named explicitly rather than papered over. You are asked to supply the missing material, such as an example, or the section depending on it is cut.

When should I not use this shaping approach?

Avoid it when you are still exploring ideas or collecting material, since this is the exploit phase that assumes the pile is fixed. It also does not handle publishing, platform-specific formatting, or adding frontmatter.