Agent Skill to Force Docs in ASD-STE100 Simplified Technical English

navs 269 points 95 comments July 30, 2026
github.com · View on Hacker News

Discussion Highlights (20 comments)

handfuloflight

Okay here's one of the outputs: > Before you start, make sure that your AWS credentials are correct. If they are not, S3 rejects the upload with a permission error. Wouldn't it be better to write: Before start, ensure AWS credentials are correct. Otherwise, S3 rejects uploads with permission error.

Merkur

nice :-) i'll try that! thx

evanjrowley

Honestly I should use this on my own emails and slack messages.

bbg2401

Oh, is ASD-STE100 this week’s mindless productivity/AI-bro trend? Ads-STE100: Simplified Technical English - https://news.ycombinator.com/item?id=49101215 ASD-STE100 Simplified Technical English for LLMs - https://news.ycombinator.com/item?id=49065956 ASD-STE100 Simplified Technical English [pdf] - https://news.ycombinator.com/item?id=49075687 Show HN: Claude Skill for ASD-STE100 – Simplified English - https://news.ycombinator.com/item?id=49108318

hankbond

["Skill", "Force"] Pick one.

codingjoe

What a wonderful skill. I hate the long and verbose do strings or docs LLMs spit out. This will make a great addition to my docu agent. And I agree, maybe I should use this for my emails too

bayesnet

It’s ironic that the README has all the tells of being LLM-written: > 53 numbered rules, 9 sections, written in 1983 by people whose readers die when a sentence is ambiguous. The ones doing the heavy lifting: … Not really a promising tell for a writing skill, IMO.

grim_io

I wish this were selectable as the default output style.

tajd

On a related note I wrote a skill to apply the economist style guide to LLM generated writing https://github.com/TAJD/economist-style-guide-plugin Tends to produce relatively well structured prose that’s easy to edit.

SoMomentary

Anyone tried this as an output style and not just as a skill?

dan_sbl

I took one of the examples ("Leveraging sqlpipe's robust...") and just prefixed it with this: > Rewrite this using ASD-STE100 simplified technical English: And you get a good-enough result, it seems? Maybe add another sentence or two for guidance, but what's with needing these giant skills, when ASD-STE100 was surely in the training material?

alehlopeh

No semicolons — write two sentences. Oh lord.

cryo32

The day I have to negotiate and persuade the machine to stop talking shit rather than command it is the day I decide fuck it and go and farm geese or something. Smells like today. I’ll take goose shit over this.

jpease

I like the idea, but not sold on the skill. But did lead to me finding https://vale.sh and its various available linters. Might give that a try.

ricardobeat

The very first sections of the README having obvious claude-isms is not very reassuring: > AI slop dies as a side effect > One folder, no dependencies, MIT.

z3ugma

Also from a nicely explained YouTube video: https://www.youtube.com/watch?v=uJblcC4lKYw " The cure for AI slop is a 1986 aircraft manual" https://github.com/woosal1337/blog/tree/main/videos/ep01-the...

Planktonne

This is cruft [1]. No one who is capable of using this needs it--it's a line in the prompt at most. [1] https://knowyourmeme.com/memes/thinking-quickly-dave-constru...

cesarvarela

Man, I was just now imploring Claude to be more concise.

alansaber

The irony of vibing a de-sloppinator

abeyer

STE Misapplication issues and limited adoption https://en.wikipedia.org/wiki/Simplified_Technical_English#M...

Semantic search powered by Rivestack pgvector
15,510 stories · 144,699 chunks indexed