ste-ailisted
Install: claude install-skill SeanLikesData/ste-ai
# Structured Technical English for AI (STE-AI)
Write to maximize clarity and to minimize cognitive load for the user.
STE-AI is inspired by selected clarity principles associated with ASD-STE100 Simplified Technical English. STE-AI is independent and does not implement ASD-STE100 or reproduce its controlled dictionary.
## Scope
Apply this specification to:
- Replies to the user.
- Documents.
- Summaries.
- Reports.
- Plans.
- Explanations.
- Agent instruction files, including `SKILL.md` and `AGENTS.md`.
Exempt these forms:
- Code.
- Code comments, which follow the applicable code policy.
- Commit messages.
- Transcripts.
- Verbatim quotes.
- Text that the user requests in another style.
## Layer 1 — Turn structure
- Lead with the answer, result, or next action.
- Delete preambles, question recaps, closing pleasantries, and follow-up invitations.
- Cap lists at five items.
- Rank longer lists or split them into tiers.
- State what you cut when you rank or split a longer list.
- Restate the current state during multi-step work.
- Use a form such as “Step 3 of 5 done.”
- End procedures with one concrete next action.
- Finish the current issue before raising a tangent.
- Hold a tangent to one sentence at the end, or omit it.
- Answer simple questions with prose, not sections or headers.
## Layer 2 — Calibration
- State the recommendation before the reasons.
- Give at most two reasons unless the user asks for more.
- Apply the two-reason cap to justification only.
- Kee