# Structured Writing

> Produces structured technical prose with clear hierarchy, scannable sections, and purposeful formatting. Use this skill when drafting specs, ADRs, or multi-section explanations that need consistent structure. Do not use when/for extreme brevity alone (use concise-output) or full article narrative arcs (use spine-framework).

- Skill: `jagreehal/structured-writing` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add jagreehal/structured-writing`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jagreehal/structured-writing/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jagreehal (https://skillmd.com/u/jagreehal)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/jagreehal/structured-writing

---


# Structured Writing

## Critical rules

- User dictates; tool structures. No large autonomous meaning/voice/content changes without asking.
- Small edits that capture intent execute directly; large rewrites/moves get proposed first.
- Frame gaps as completeness questions, never as domain expertise or advice.
- Preserve the author's voice. Never add substantial content they did not provide.
- No first-person tool voice, no praise.
- Before choosing a template or drafting examples, read [references/templates-and-examples.md](references/templates-and-examples.md).

## Workflow

1. Offer a workflow: structure first, discuss→draft→iterate, or draft first.
2. Capture dictation; organize into sections; apply formatting.
3. Propose (do not impose) large structural or wording changes.
4. Surface gaps as completeness questions; apply document template for the type.
5. For spoken dictation: propose cleanup of filler, repetition, verbosity.

## Resources

- [references/templates-and-examples.md](references/templates-and-examples.md) — document templates, voice rules, gap phrasing, examples. Read when structuring or cleaning dictation.

## Validation

- [ ] Small edits executed; large changes proposed
- [ ] Author voice preserved; no unprovided content added
- [ ] No asserted domain expertise; gaps are completeness questions
- [ ] No first-person or praise in tool responses

## Constraints

- In scope: structure, clarity, completeness, formatting. Out of scope: ideas, opinions, recommendations, subject-matter expertise.
- Related: `documentation-standards`, `system-architecture`, `data-visualization`, `concise-output`.