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

 (github.com)

64 points | by navs 2 hours ago

12 comments

  • tajd 17 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.

  • SoMomentary 8 minutes ago
    Anyone tried this as an output style and not just as a skill?
  • bayesnet 23 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 5 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 10 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.
  • hankbond 59 minutes ago
    ["Skill", "Force"]

    Pick one.

    [-]
    • CGMthrowaway 24 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 18 minutes ago
      Violates rule 4.2: Do not omit words or use contractions to shorten sentences. Keep articles, keep "that".
    • harshreality 33 minutes ago
      The example is unambiguous. Your modification is ambiguous at best. <failure to ensure aws credentials are correct> != <aws credentials are incorrect>
    • stavros 41 minutes ago
      No, how is that better?
    • trhway 27 minutes ago
      Which one would do better in a college essay? I think the original one, and it has higher word count.
  • codingjoe 37 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 19 minutes ago
    I wish this were selectable as the default output style.
  • evanjrowley 1 hour 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 45 minutes ago
      New models (especially Opus 5, released just last week) produces unintelligible output, so people are trying to fix it.
    • UqWBcuFx6NV4r 33 minutes ago
      What’s it like to be this abrasive about people simply doing things?
    • tonyarkles 26 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!
  • dahdum 55 minutes ago
    [dead]
  • nikolahristov 56 minutes ago
    [dead]
  • Merkur 2 hours ago
    nice :-) i'll try that! thx