ASD-STE100 Writer Skill
A skill that rewrites technical text in ASD-STE100 Simplified English: short sentences, active voice, warnings before the step.
- 103 ★ on the repository
- Last commit
Minimal access
Why this level
- The skill has no full ASD dictionary, so the result must not be presented as certified text.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/asd-ste100-writer-skillDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skill has no full ASD dictionary, so the result must not be presented as certified text.
This is third-party code. Review the repository files before installing.
What it does
The `ste100-writer` skill writes and rewrites technical documents in ASD-STE100 Simplified Technical English. The agent identifies the text type (procedure or description), applies the rules and checks against a checklist. A procedural sentence has at most 20 words, a descriptive one at most 25, one instruction goes in one sentence and verbs use the imperative and active voice. A warning stands before the step it applies to. On request the skill shows a before and after table. It has no full ASD dictionary: only the rules and a small list of word swaps such as `perform` to `do`. If a word is not on the list, the agent says it must be checked against the official dictionary.
Who it is for. Technical writers and engineers who prepare maintenance instructions and procedures in English for readers whose first language is not English.
Good fit when
- A maintenance procedure is written in long sentences and should read step by step.
- An AI-generated README is rewritten without marketing words and with short sentences.
- Warnings and cautions in a manual move before the steps they apply to.
- The text goes to machine translation and unambiguous wording improves its accuracy.
Not a fit when
- The text must be certified against the full ASD dictionary: the skill does not contain it.
- The document is not in English: the rules apply only to English.
- Short uniform sentences hurt marketing or fiction copy.
Example request
Rewrite this maintenance procedure in ASD-STE100, keeping all technical data and all safety data.Limitations
The skill has no full ASD-STE100 dictionary: the specification and dictionary are copyrighted and free at asd-ste100.org. For words outside the list the agent only warns that a check is needed and never claims a word is approved. The result does not replace a check against the official dictionary. The repository has no license file, so usage terms are undefined. Only English text is covered: the rules do not fit other languages. The skill targets technical instructions and descriptions, not any English text.
How to disable. Delete the `ste100-writer` folder from the agent's skills directory, for example `~/.claude/skills/ste100-writer`.
FAQ
How do I check the result?
Against `references/checklist.md`. `evals/` holds simple evaluations: three cases (procedure, description, warning), the `run_eval.py` script and a blocked-word list.
How do I install without npx?
Copy `skills/ste100-writer` into the skills directory with `cp -R asd-ste100-writer-skill/skills/ste100-writer ~/.claude/skills/ste100-writer` and restart the tool.
What changes in the text?
Long sentences split, passive voice leaves instructions and words like `perform` and `obtain` become `do` and `get`.
Which agents are supported?
The README has install commands with the `-a` flag for GitHub Copilot, Claude Code and OpenCode.
Is there an example of a full document?
Yes, `examples/ai-readme-before.md` and `examples/ai-readme-after.md` show a README before and after editing.
Discussion
No questions or reviews yet.
Related
SkillsA skill that rewrites dense, ambiguous English into ASD-STE100 Simplified Technical English so another agent cannot misread it
A skill that makes an agent write docs and replies in plain English on ASD-STE100 rules: short sentences, one term per meaning, condition before command
Skill that rewrites Chinese technical text into controlled language: one action per sentence, active voice, one term per idea.
Simplified Technical English Skill
simplified-technical-english
A skill that makes a model write in Simplified Technical English (ASD-STE100), a controlled English for technical documentation. Unofficial
A skill that strips defensive caveats, apologies and excess hedging from text and makes claims direct while keeping needed limits
A skill that turns engineering notes, customer input and test expectations into clear, testable technical requirements.
README in short
The README shows two without and with the skill pairs and an example of a whole README before and after editing, then lists install options. Rules, the checklist and word swaps sit in separate `references/` files.