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

 (github.com)

76 points | by navs 2 hours ago

15 comments

  • dan_sbl 13 minutes ago
    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 11 minutes ago
    No semicolons — write two sentences.

    Oh lord.

  • tajd 34 minutes ago
    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.

  • cryo32 2 minutes ago
    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.

  • bayesnet 40 minutes ago
    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.

    [-]
    • mcintyre1994 22 minutes ago
      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)

    • gchamonlive 26 minutes ago
      The readme looks to me concise and correct. Tested it and it works. Better than many human-written readmes I've seen around.
  • SoMomentary 24 minutes ago
    Anyone tried this as an output style and not just as a skill?
  • hankbond 1 hour ago
    ["Skill", "Force"]

    Pick one.

    [-]
    • CGMthrowaway 41 minutes ago
      Here is the revised post title that follows ASD‑STE100 Simplified Technical English rules:

      "Agent Skill to Enforce ASD-STE100 Simplified Technical English in Documents"

  • handfuloflight 2 hours ago
    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.

    [-]
    • qznc 35 minutes ago
      Violates rule 4.2: Do not omit words or use contractions to shorten sentences. Keep articles, keep "that".
    • harshreality 50 minutes ago
      The example is unambiguous. Your modification is ambiguous at best. <failure to ensure aws credentials are correct> != <aws credentials are incorrect>
    • stavros 57 minutes ago
      No, how is that better?
    • trhway 43 minutes ago
      Which one would do better in a college essay? I think the original one, and it has higher word count.
  • codingjoe 54 minutes ago
    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

  • grim_io 36 minutes ago
    I wish this were selectable as the default output style.
  • evanjrowley 2 hours ago
    Honestly I should use this on my own emails and slack messages.
  • bbg2401 1 hour ago
    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

    [-]
    • xlii 1 hour ago
      New models (especially Opus 5, released just last week) produces unintelligible output, so people are trying to fix it.
    • UqWBcuFx6NV4r 49 minutes ago
      What’s it like to be this abrasive about people simply doing things?
    • tonyarkles 43 minutes ago
      You didn’t link to it but I looked back at my very few submissions and realized that I had posted it in 2019. I thought it sounded familiar!
    • toomuchtodo 11 minutes ago
      Potentially related to https://news.ycombinator.com/item?id=49068179
  • dahdum 1 hour ago
    [dead]
  • nikolahristov 1 hour ago
    [dead]
  • Merkur 2 hours ago
    nice :-) i'll try that! thx