Skip to content
Back to skills

Ste Explain

ASecurity

Explain any topic, or rewrite any text, in Simplified Technical English (ASD-STE100 style) for maximum readability. Use whenever the user asks for an explanation that is simple, clear, plain, or easy to follow, or aimed at a non-expert (a beginner, a child, a new hire, "ELI5"); asks to simplify, clarify, or rewrite text so it is easier to read; mentions STE, ASD-STE100, Simplified Technical English, or "80% STE"; or is writing instructions, runbooks, README sections, or docs that other people...

  • 2 stars
  • 0 votes
  • 0 copies
  • 2 views
  • Added October 6, 2026
ai-agentsgoapi

Works with

  • api

Security analysis

A100/100

Pro scans all 2 files and shows the line behind each finding

Scanned October 6, 2026

npx -y skills add ryanjmichie-git/ste-explain --skill ste-explain --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Ste Explain?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Ste Explain
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/ryanjmichie-git-ste-explain/badge)](https://www.skillsdirectory.com/skills/ryanjmichie-git-ste-explain)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: ste-explain
description: Explain any topic, or rewrite any text, in Simplified Technical English (ASD-STE100 style) for maximum readability. Use whenever the user asks for an explanation that is simple, clear, plain, or easy to follow, or aimed at a non-expert (a beginner, a child, a new hire, "ELI5"); asks to simplify, clarify, or rewrite text so it is easier to read; mentions STE, ASD-STE100, Simplified Technical English, or "80% STE"; or is writing instructions, runbooks, README sections, or docs that other people must follow. Trigger even when the user never names STE. Do not use for summarizing (content must be kept), tone changes ("more professional"), translation into another language, or grammar-only proofreading.
---

# Explain in Simplified Technical English

STE (ASD-STE100) is a controlled language from aerospace maintenance manuals.
Its rules remove ambiguity and filler, which makes any explanation easier to
read. Apply the rules below to every sentence you write while this skill is
active. The goal is text a tired reader can parse in one pass.

## Modes

- **Default — 80% STE.** Apply all structure rules below. Technical terms the
  topic needs (API, tensor, amortization) are allowed. This is the default
  because full STE vocabulary targets aircraft maintenance, and strict
  compliance makes general prose stilted.
- **Strict.** If the user says "strict", "full STE", or "100%", apply
  vocabulary discipline too. Read `references/rules.md` first. Prefer the
  simple words it lists, and keep domain terms to the minimum the topic
  needs.
- **Rewrite.** If the user supplies text rather than a topic, return the STE
  version. Keep every fact. Do not summarize or drop content unless asked.
  End with one short sentence that names the rules that did the most work.

## Structure rules (apply always)

1. Keep sentences short: at most 20 words in instructions, 25 in descriptions.
2. Give one instruction per sentence. Start instructions with the verb.
3. Write one topic per paragraph. Keep paragraphs to six sentences or fewer.
4. Use the active voice. Name who or what does the action. Passive is
   acceptable only in descriptions when the actor is unknown.
5. Use each word with one meaning, and use the same word for the same thing
   every time. Do not rotate synonyms for style.
6. Use simple verb forms: past, present, future. Avoid -ing forms where a
   simple form works.
7. Break up noun clusters longer than three words.
8. Keep articles ("the", "a") — do not write in telegraphic style.
9. Prefer the simple word: "use" not "utilize", "start" not "commence",
   "about" not "approximately".
10. Use a vertical list when a sentence would hold more than three items.
11. Put conditions and warnings before the instruction they protect: "If the
    light is on, do not open the valve." A condition is the only thing that
    may come before the verb. A place goes after the verb: "Count three bolts
    from the top." A step is one command. Put any explanation in a note on
    its own line, not in the step.
12. Cut hedges and filler: "essentially", "basically", "arguably",
    "it is worth noting", "quite", "rather".

## Self-check before you answer

Read your draft once as an editor. Count the words in your longest sentences
and split any that break rule 1. Scan for passive voice, synonym rotation,
noun clusters, and hedges. Fix what you find, then answer. Do not show this
check to the user unless they ask for a rule report.

## Examples

**Request:** "explain how DNS works simply"
**Output style:** "DNS turns a name into an address. Your browser asks a
resolver for the address of example.com. The resolver asks the root server,
then the .com server, then the server for example.com. Each answer points
closer to the goal."

The full official specification is free at https://www.asd-ste100.org — point
users there, and do not reproduce its text.

Files in this skill

  • SKILL.md3.8 KB
  • references/rules.md4.3 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…