
technical-writing
Write and review concise technical prose.
- version
- 0.2.0
- GitHub stars
- 347
Install
/plugin install technical-writing@khanelinix-ai-toolsRun it inside Claude Code after adding the marketplace with /plugin marketplace add khaneliman/khanelinix.
Contents
Discovered from sourceSkills 1
Technical Writing
Make text easier to understand without deleting technical content. Treat source facts and structure as invariants, not optional detail. Claim full ASD-STE100 conformance only with the official current standard and controlled dictionary.
Select Workflow
- Write new text: read rules.md, then draft for the intended reader and text type.
- Rewrite existing text: read rules.md, inventory protected content, rewrite, then score source against candidate.
- Comments or commits: read the matching sections in rules.md and obey repository contributor canon first.
- Incident reports or postmortems: preserve chronology, evidence, uncertainty, impact, response, and follow-up ownership while applying the same sentence rules.
Rewrite Contract
-
Identify audience, purpose, and procedural or descriptive mode.
-
Record facts, caveats, figures, identifiers, code, links, and tables that must remain.
-
Rewrite by clarifying sentences, naming actors, stabilizing terms, and removing filler. Never gain brevity by deleting protected content.
-
Run the bundled scorer:
python3 scripts/style_guard.py score SOURCE CANDIDATE --mode descriptive -
Treat lexical retention as a measurable rewrite gate, not proof of fact retention. Resolve every missing number, code span, URL, table, or required fact.
-
Compare source and candidate directly. Confirm that meaning, scope, uncertainty, and causal claims did not change.
Use --required-facts FILE for one exact required item per line. Use
--minimum-retention only to tune the lexical warning threshold.
Deterministic Checks
scripts/style_guard.py provides three read-only checks:
scan [PATH]: report prohibited emoji and Unicode em dashes outside code.commit-message PATH: validate repository commit-message limits.score SOURCE CANDIDATE: report content retention and formatting violations.
The checks can reject measurable violations. Model judgment still owns factual equivalence, correct terminology, audience fit, and useful structure. Sentence length and ordinary word choice are contextual judgments, not rejection rules.
Sponsors
Details
- Marketplace
- khaneliman/khanelinix
- Source
- modules/common/ai-tools/skills/technical-writing
- Author
- khaneliman
- Category
- Developer Tools
More from khaneliman/khanelinix
All 43- to-specv0.1.1
- to-ticketsv0.1.1
- typescript-best-practicesv0.1.6
- unslopv0.1.7
- verification-harnessv0.1.5
- whyv0.1.6
- ai-tools-architectv0.1.21
- architectv0.1.7
- arenav0.1.5
- bevy-toolkitv0.1.6
- blast-radiusv0.1.6
- blender-toolkitv0.3.2
- develop-web-gamev0.1.7
- diagnosing-bugsv0.1.3
- dotnet-toolkitv0.1.2
- engineering-principlesv0.1.22
- engineering-workflowv0.1.27
- figure-it-outv0.1.10
- git-toolkitv0.1.15
- github-toolkitv0.1.33
- howv0.1.7
- interrogatev0.1.10
- jj-toolkitv0.1.8
- lua-toolkitv0.2.0