prose-craftlisted
Install: claude install-skill birdseyeglobal/portage
# Prose Craft
Good writing is not the absence of bad patterns. The humanizer removes AI tells;
this skill teaches you to write well.
Before drafting, establish two things: voice (who you sound like) and styleguide
(how sentences are constructed). Then apply the word choice and construction
corrections below. The styleguide handles grammar and usage rules.
## Voice
Before writing, determine who this document sounds like it was written by, and
for whom. If project instructions or the user already establish voice, adopt it.
Otherwise, reason through the following layers internally before drafting.
### Resolution order
1. **Project instructions** — If CLAUDE.md, AGENTS.md, or brand voice documents
declare voice, tone, audience, or register conventions, adopt them. These
take precedence.
2. **Explicit user request** — If the user specified voice, audience, or tone
in this session, adopt it.
3. **Internal reasoning** — Work through the three layers below silently. State
your resulting voice choice briefly and proceed. The user can override.
### Layer 1 — What does this document do?
Genre is not a format — it is a social action. A design doc does not merely
describe a system; it builds consensus on an approach. A postmortem does not
merely list failures; it prevents recurrence. A tutorial does not merely
explain steps; it transfers a skill.
Before choosing tone or register, identify the action this document performs:
| Action | The document...