Skip to content
Back to search

simplified-technical-english

Kill AI slop with the writing standard built for flight manuals. A Claude Code skill applying ASD-STE100 Simplified Technical English principles.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jsath--simplified-technical-english/badge.svg)](/listings/jsath--simplified-technical-english)

HTML

<a href="/listings/jsath--simplified-technical-english"><img src="/api/listings/jsath--simplified-technical-english/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/jsath/simplified-technical-english.git
cp -r simplified-technical-english/skills/technical-english ~/.claude/skills/

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 89 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Simplified Technical English ✈️
  2. A Claude Code skill that kills AI slop using the writing standard built for
  3. flight manuals.
  4. Aircraft maintenance manuals cannot afford ambiguity, so the aerospace
  5. industry built **ASD-STE100 Simplified Technical English**: every word has one
  6. meaning, instructions are 20 words or fewer, every instruction is a command.
  7. A mechanic in any country can read one and do the right thing.
  8. AI-generated text fails in the exact opposite way. Long sentences. Hedged
  9. claims. "Leverage" and "seamless" and "it's important to note". This skill
  10. applies the STE principles to any text and the slop dies mechanically:
  11. - **One word, one meaning** - no word a reader can take two ways
  12. - **Hard sentence limits** - 20 words per instruction, 25 per description, counted
  13. - **One instruction per sentence** - sequences become numbered steps
  14. - **Active voice, imperative commands** - "Remove the bolt", never "the bolt should be removed"
  15. - **A substitution table** - utilize→use, commence→start, facilitate→help
  16. - **An AI-slop blocklist** - delve, crucial, seamless, robust, and friends, deleted on sight
  17. ## Install
  18. ```bash
  19. git clone https://github.com/jsath/simplified-technical-english.git
  20. cp -r simplified-technical-english/skills/technical-english ~/.claude/skills/
  21. ```
  22. ## Use
  23. In Claude Code:
  24. ```
  25. /technical-english rewrite the README in this repo
  26. ```
  27. ```
  28. /technical-english audit: <paste any text>
  29. ```
  30. Or just ask naturally: "de-slop this", "make this readable", "apply STE to
  31. this doc". The skill triggers on its own.
  32. Three modes:
  33. - **Rewrite** (default) - full rules, outputs the rewrite plus a violation report
  34. - **Audit** - violation report only, nothing rewritten
  35. - **Light** - for marketing copy with a voice worth keeping, applies only the
  36. sentence limits, active voice, substitutions, and the slop blocklist
  37. ## Example
  38. **Before** (one 44-word sentence):
  39. > In order to facilitate the seamless integration of the authentication
  40. > module, it is important to note that developers should ensure that the
  41. > configuration file has been comprehensively updated prior to commencing the
  42. > deployment process, which can be accomplished via the CLI.
  43. **After** (longest sentence: 11 words):
  44. > Update the configuration file before you start the deployment. Use the CLI
  45. > to deploy. This connects the authentication module.
  46. Same facts. A third of the words. No ambiguity.
  47. ## What it will not do
  48. It does not delete facts to look concise. It does not touch code, commands,
  49. or quoted strings. It does not invent a value to complete a sentence, it
  50. marks the gap.
  51. ## Attribution
  52. Inspired by ASD-STE100 Simplified Technical English, maintained by the
  53. AeroSpace and Defence Industries Association of Europe. This is an
  54. independent skill applying its principles, not the official specification or
  55. its dictionary. The official spec is available free from
  56. [asd-ste100.org](https://www.asd-ste100.org).
  57. ## License
  58. MIT © Johann Sathianathen
  59. ---
  60. Built by [Johann Sathianathen](https://johann.fyi). I build AI systems like
  61. this every week and break them down inside
  62. [AI Operators](https://www.skool.com/ai-operators-5011/about). You do not
  63. need it to use this skill.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.