investor-writing-stylelisted
Install: claude install-skill smorrel1/claude-code-skills
# Investor-document style
## The brief
Read `references/style-brief.md` in full before editing. It is about 500 lines,
19 sections, and it is the actual standard the work is judged against, not a
summary of one. Do not work from this page alone.
## Workflow
1. Read the whole document first. Never revise sentence by sentence on the way through.
2. Make three passes, in the order section 17 sets out: meaning and organisation,
then prose, then how an investor unfamiliar with the company could misread it.
3. Check the acceptance checklist in section 19 before delivering.
4. Run an AI-mannerism / em-dash checker on the document before delivering. The
brief bans em dashes, so that check is the proof. Run it on the document,
never on `references/style-brief.md`: the brief quotes the phrases it bans, so
a checker fails it by design.
## What the brief will not tell you
- **Versioning.** Cut a new version rather than overwriting: `YYYYMMDD-name-vX.Y.ext`,
dated the day the version was cut. Move superseded files into `archive/` in the
same folder at the same time.
- **Never regenerate over a hand-edited file.** Read the current version first and
build on it. Hand edits carry judgement about claims, and rebuilding from an
earlier draft silently drops them.
- **Facts come from the source corpus, not from inference.** Numbers, trial status,
regulatory status and cap-table terms are written down somewhere. Read the
source. Where a fact cannot be found, raise it