blagoysimandov/asd-ste100-writer-skill
Developer toolsThis repository gives you an installable skill for ASD-STE100 writing. Use it to write or rewrite technical text in Simplified Technical English.
Overview
This repository gives you an installable skill for ASD-STE100 writing. Use it to write or rewrite technical text in Simplified Technical English. 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 Use this command to see the skills before you install: 1. Clone this repository. 2. Copy skills/ste100-writer to your local skills directory. 3. Restart your tool. - 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/.
README
ASD-STE100 Writer Skill
This repository gives you an installable skill for ASD-STE100 writing. Use it to write or rewrite technical text in Simplified Technical English.
Example output
| 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. |
Example of a full document
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
Install with skills
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
Install from this repository
- Clone this repository.
- Copy
skills/ste100-writerto 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
Use
Ask for a rewrite in ASD-STE100.
Example prompt:
Rewrite this maintenance procedure in ASD-STE100.
Keep all technical data and all safety data.
Skill files
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.
Evals
The repository has simple evals in evals/.
Read evals/README.md for setup and commands.
Recommended Tools
Try a different keyword or remove a filter.
Install
npx skillfish add blagoysimandov/asd-ste100-writer-skill