writing-shape

Generated source view for the actual executable personal/writing-shape skill. The durable routing article is Writing and Content Skills. Source: skills/personal/writing-shape/SKILL.md

Runtime Source

Bundled Resources

No bundled resource files.

Description

Writing exploit skill for shaping raw material into a coherent article paragraph by paragraph. Use when Kevin says "/writing-shape", "shape this into an article", "turn this raw material into a draft", or wants article structure, openings, headings, and block-by-block editing.

Skill Source

---
name: writing-shape
description: Writing exploit skill for shaping raw material into a coherent article paragraph by paragraph. Use when Kevin says "/writing-shape", "shape this into an article", "turn this raw material into a draft", or wants article structure, openings, headings, and block-by-block editing.
origin: personal
source_slug: writing-shape
---

# Writing Shape

Use this after Kevin has a raw material file and wants a coherent article. This is an exploit skill: the pile is the source, the article is the product, and the raw file stays read-only.

## Boundary

- Use `writing-fragments` when more raw material needs to be mined.
- Use `writing-beats` when Kevin wants to choose the article path beat by beat.
- Use `writing-shape` when Kevin wants a direct shaping session with openings, paragraph/block decisions, and a complete draft.
- Use `humanizer`, `kevin-voice`, and `social-draft` after the article exists and needs polish or platform adaptation.

## File Contract

Read the input pile end-to-end before doing anything else. Do not edit the raw material file.

Ask once where the article file should live if Kevin did not provide a destination. Re-read the article file from disk before every write. Append agreed blocks as the article forms. If Kevin asks to rewrite a block, edit that block in place and leave the rest alone.

## Shaping Loop

1. Read the pile in full.
2. Establish reader prerequisites.
3. Draft 2-3 candidate openings with different angles.
4. Kevin picks one or composes a hybrid.
5. Ask what the reader needs next given that opening.
6. Choose the next block format deliberately: paragraph, list, table, quote, callout, or code block.
7. Write the agreed block to the article file.
8. Track grounded concepts and update them after each block.
9. Loop until Kevin says the article is done.

## Format Arguments

Make format choices explicit:

- Prose carries argument.
- Lists carry parallel items.
- Tables carry repeated fields.
- Quotes preserve wording when wording is the point.
- Callouts hold side notes that would derail the main flow.
- Code blocks are for runnable, multi-line, or illustrative code.

If the pile lacks material the article needs, name the gap. Ask Kevin for the missing example or cut the section.

## Quality Pushback

Use these checks during the session:

- What does this paragraph do that the previous one did not?
- If this block is cut, what breaks?
- Is this prose, or should it be a list?
- Is this sentence doing two jobs?
- Did the opening promise one article while the draft is becoming another?

## Related Skills

- `writing-fragments`
- `writing-beats`
- `humanizer`
- `kevin-voice`
- `social-draft`

---

Timeline

• 2026-07-15 | Generated a browseable source page from the actual executable skill file. Source: skills/personal/writing-shape/SKILL.md