This repository gives you an installable skill for ASD-STE100 writing. Use it to write or rewrite technical text in Simplified Technical English.
| Without the skill | With the skill |
|---|---|
| Prior to initiating the maintenance task, the technician shall perform verification of the hydraulic pressure indicator and subsequently commence removal of the access panel in order to inspect the pump drive coupling. | Before you start the maintenance task, do a check of the hydraulic pressure indicator. Remove the access panel. Do a check of the pump drive coupling. |
| The integration test creates a topic and subscription on the emulator, publishes a message, and blocks until the message is actually received, asserting payload and attributes. | The integration test creates a topic and a subscription on the emulator. Then it publishes one message. The test waits for delivery and checks the payload and attributes. |
This is an example of a change from a README generated with AI to a README in ASD-STE100 Simplified Technical English. The source is a real README with marketing words, gerunds, passive verbs, and long sentences. The skill removed the marketing words and made each sentence shorter and more clear.
-
Before:
examples/ai-readme-before.md -
After:
examples/ai-readme-after.md
Run this command:
npx skills add blagoySimandov/asd-ste100-writer-skill
Examples for specific agents:
npx skills add blagoySimandov/asd-ste100-writer-skill -a github-copilot -g -y
npx skills add blagoySimandov/asd-ste100-writer-skill -a claude-code -g -y
npx skills add blagoySimandov/asd-ste100-writer-skill -a opencode -g -y
Use this command to see the skills before you install:
npx skills add blagoySimandov/asd-ste100-writer-skill --list
- Clone this repository.
- Copy
skills/ste100-writer
to your local skills directory. - Restart your tool.
git clone https://github.com/blagoySimandov/asd-ste100-writer-skill.git
mkdir -p ~/.claude/skills
cp -R asd-ste100-writer-skill/skills/ste100-writer ~/.claude/skills/ste100-writer
Ask for a rewrite in ASD-STE100.
Example prompt:
Rewrite this maintenance procedure in ASD-STE100.
Keep all technical data and all safety data.
skills/ste100-writer/SKILL.md
: Skill instructions.skills/ste100-writer/references/rules.md
: Rule summary.skills/ste100-writer/references/checklist.md
: Final check list.skills/ste100-writer/references/word-choices.md
: Example word choices.
The repository has simple evals in evals/
.
Read evals/README.md
for setup and commands.