Live data from Hacker News

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

github.com

21–30 of 139 posts

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

#22

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 readme looks to me concise and correct. Tested it and it works. Better than many human-written readmes I've seen around.

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

#24

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.

They acknowledge this, but I really dislike whatever style they're using for the readme:

> 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)

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

#25
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?

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

#26
post #5

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.y…

Potentially related to https://news.ycombinator.com/item?id=49068179

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

#30

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

I've added the prompt to use the ASD English, on my CLAUDE.md when I learnt of the standard. The generated output is more tolerable to read, and is less confusing.

I like it, and I'll also try the Economist one on another thread here. I have global instructions on how Claude should try to write things like I do.

I generally avoid having lots of skills, security risk as I won't vet them all.

Post reply on HN