Live data from Hacker News

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

github.com

121–130 of 139 posts

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

#121
post #39

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

Love this line in the critical material quoted there:

“Writing correctly in STE is not an easy task as it requires a good command of the English language together with a good knowledge of the matter of the writing.”

This is simply what is required for good writing (in English) in any domain with or without STE.

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

#122

https://youtu.be/uJblcC4lKYw This video benchmarks slop-style indicators with different skill/prompt solutions including the STE skill vs. George Orwell's six rules of writing prompt: Orwell came out on top overall. Additional bonus: it doesn't add much more tokens to input context. I have compared prose prompts with these rules and without and I am liking the results. 1. Never use a metaphor, simile, or other figure…

I don't know if I have been damaged by reading so much AI, but I swear the narrator of that video had the script for it written by Claude without any of those rules applied. There are so many platitudes and AI-isms in the way he speaks:

    "now the honesty - those translation gains were real but small"
    "and here is the honest part"
    "same disease but with different symptom"
    "so that brutal 3% number was a Claude quirk, not a law of nature"

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

#124
post #115
post #9

Earlier quoted context omitted.

New models (especially Opus 5, released just last week) produces unintelligible output, so people are trying to fix it.

No, it was a viral tweet from last week. They’ve been verbose since GPT-4o.

Ccn't say, though since Opus 5 I'm much more often staring at the wall of text and I have no idea what it's telling me.

WTFs per prompt metric raised sharply for me :)

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

#126

Agent skills work... sometimes - depends on the agent's mood really. I tried to solve this in a rather opposite way. https://github.com/computerreinvention/trie The documentation is updated and recording the intent behind all changes is enforced by a commit-gate. At the symbol level.

I think you've linked to a private repository.

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

#127
Anecdote: was testing Opus 5 and even ASD-STE100 cannot save you from its meta-commentary and signposting all the time. It writes what it wants to write, e.g. "here's where you are right/wrong" instead of "Your instinct of the shape is right, but here's a sharper version". I could not get it to stop doing that.

In contrast if you ask GPT 5.5/5.6 to speak directly/plainly, it will just straight up tell you the content "X is right, Y is wrong". Much preferable.

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

#129
post #29

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.

How would one use Vale in LLM documentation?

I use it with a rule package that has a variety of Vale styles for AI writing tells (github.com/tbhb/vale-ai-tells). Typically I have it set up in a project and then gate the agent with post tool use hooks and pre-commit hooks. It's far from perfect but it does help eliminate a lot of the common tells.
Post reply on HN