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?
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.
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.
> 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?
But did lead to me finding https://vale.sh and its various available linters. Might give that a try.
Tends to produce relatively well structured prose that’s easy to edit.
Not really a promising tell for a writing skill, IMO.
> Yes, this README breaks half of them. Marketing is explicitly out of STE scope. The skill knows that and stays in the docs.
> Where it refuses to go: marketing copy, blog voice, brand writing. Flat on purpose.
(Each sentence there has an emoji that HN cuts out)
Oh lord.
Pick one.
"Agent Skill to Enforce ASD-STE100 Simplified Technical English in Documents"
> 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.
And I agree, maybe I should use this for my emails too
Smells like today. I’ll take goose shit over this.
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