One question I have about stuff like this: How does it affect the models intelligence or thinking ability. If this modifies the output or chain of thought in any way, it may impact what the model is capable of right? Especially if it's not trained to use this kind of language during training.
Agent Skill to Force Docs in ASD-STE100 Simplified Technical English
81–90 of 139 posts
Re: Agent Skill to Force Docs in ASD-STE100 Simplified Technical English
#82Earlier quoted context omitted.
What’s it like to be this abrasive about people simply doing things?
It would be nice if people were indeed doing things. However, asking Claude to write a skill encoding ASD-STE100 after seeing it pop-up in your social feed is not doing much at all. It's certainly not worth a post on HN. Having said that, this skill might have been the seed for the flurry of low-effort posts on the subject on various platforms this week. If that's the case, I take back the majority of my scorn. You'l…
Re: Agent Skill to Force Docs in ASD-STE100 Simplified Technical English
#83Gotta love how the very first example in Issue 9 of the standard is already self-defeating: > "Test" is an approved noun, but not an approved verb. > STE: Test B is an alternative to test A. So much for clear - unless you know the STE specific rule, the sentence is unambiguously ambiguous. Direct access btw since the official site gates downloads with a Google form: https://www.asd-ste100.org/assets/files/ASD-STE100_…
How is that ambiguous? The best interpretation I can find where "test" is a verb is an elision: Test [that] B is an alternative to test A. That is an unlikely reading: "test" is a verb in the first instance and a noun in the second, breaking parallelism. And it's just a very unlikely thing to direct someone to do.
could mean there's a Test B and a Test A, and they're interchangeable.
Or:
You can run Test B to confirm A works, that is "to test A".
Again the stated goal to clear documentation for non-native or limited-exposure speakers. This doesn't pass that test.
Re: Agent Skill to Force Docs in ASD-STE100 Simplified Technical English
#84Nothing is more comical than AI Slope declaring that I kill AI slop: > your AI writes like a LinkedIn post. make it write like a Boeing manual. > An agent skill that forces LLMs to write docs in ASD-STE100 Simplified Technical English: the controlled language aerospace has used since 1983 so a tired mechanic cannot misread an instruction. AI slop dies as a side effect.
THE SYNTHETIC LUBRICATING OIL USED IN THIS ENGINE CONTAINS ADDITIVES WHICH, IF ALLOWED TO COME INTO CONTACT WITH THE SKIN FOR PROLONGED PERIODS, CAN BE TOXIC THROUGH ABSORPTION.
In STE this sentence appears as below:
DO NOT GET THE ENGINE OIL ON YOUR SKIN. THE OIL IS POISONOUS. IT CAN GO THROUGH YOUR SKIN AND INTO YOUR BODY.
Consider if you translated those phrases into a foreign language you’re basically familiar with. You can be awake as you want and mis-interpret the first one.
Re: Agent Skill to Force Docs in ASD-STE100 Simplified Technical English
#85This 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...
Re: Agent Skill to Force Docs in ASD-STE100 Simplified Technical English
#86Seems to be doing too much, a 1 line in the system prompt is all you need. And it works well enough. “Output tokens are precious, be succinct in your responses. Use ASD-STE100 simplified technical english”
Does this actually work for you? I've tried adding rules in my user profile as well as adding instruction in my CLAUDE.md but my models always eventually go off the rails and start spewing technical jargon in doc strings & descriptions. At this point I'd do anything to get claude to dumb down and simplify it's explanations in my code, so I'm looking forward to giving this a try and seeing how it goes.
Clause is a token torment machine that licks your balls while stealing your wallet
Re: Agent Skill to Force Docs in ASD-STE100 Simplified Technical English
#87Earlier quoted context omitted.
> - Ask it to update the skill to warn it against making that mistake again Yep! I have a canned prompt that basically boils down to "scroll up, read through and give me the top `n` things that were difficult..." and more often than not a small skill or change to `agents.md` comes out of that.
> "scroll up, read through and give me the top `n` things that were difficult..." Why do you think it can answer that? It has zero clue.
Re: Agent Skill to Force Docs in ASD-STE100 Simplified Technical English
#88"When writing plans or documentation use:
ASD-STE100 Simplified Technical English (STE for short)"
Re: Agent Skill to Force Docs in ASD-STE100 Simplified Technical English
#89This 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...
I have yet to see an "agent skill" that does not match this description.
Re: Agent Skill to Force Docs in ASD-STE100 Simplified Technical English
#90This 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...
I have yet to see an "agent skill" that does not match this description.
But also development instructions focusing on how and what to research before implementing (some of the stuff I do ends up heavily influenced by papers and publications while the naïve implementation is often bad, old, or gets stuck.