← ClaudeAtlas

concise-writinglisted

Enforced concise style for everything the assistant writes: PR descriptions, commit messages, code comments, PR reviews and replies, tickets, chat messages, and docs. Simplified Technical English (adapted from ASD-STE100) plus hard per-artifact budgets, enforced by a blocking PreToolUse hook (scripts/concise_check.py). Use when writing or rewriting any of these artifacts, when a hook denial asks for a rewrite, or on requests like 'make this concise', 'STE rewrite', 'less verbose'.
dversoza/claude-skills · ★ 2 · DevOps & Infrastructure · score 63
Install: claude install-skill dversoza/claude-skills
# Concise Writing (STE + budgets) Verbose generated text is a review tax: reviewers skim PR descriptions, tickets, and comments, and padding hides the substance. This skill makes objectiveness and simplified technical English enforced, not advisory. A hook denial means the text is too long or off-style: shorten it. Never loosen the validator, never bypass with CONCISE_SKIP unless the user explicitly instructs it. ## Source and scope Adapted from the asd-ste100 skill (https://github.com/danyuchn/asd-ste100-skill), which encodes the rule categories of ASD-STE100 Issue 9 (Jan 2025): 53 writing rules across 9 sections, backed by a dictionary of ~900 approved words (one meaning, one part of speech each). The dictionary is not free to redistribute and is not reproduced here; request it at https://www.asd-ste100.org/STE_downloads.html. Apply the underlying principle instead: pick the plainest common word and use it the same way every time. Read before rewriting anything non-trivial: - `references/writing-rules.md` - the 9 rule sections summarized, with citations and official links. - `examples/before-after.md` - worked rewrites showing which rule each change applies, including the modality trap (see below). ## Mode STE defines two modes. Strict (every rule, for procedures, error messages, tool descriptions, safety text) and STE-flavored (structural rules only, for prose). For everyday engineering artifacts, always use STE-flavored: enforce the structural rules fully, treat one