ChatGPT Work Tool and Skill Reference

(codex-tool-reference.simonw.chatgpt.site)

106 points | by ijidak 4 hours ago ago

32 comments

  • simonw 3 hours ago ago

    I think the most interesting skill here is the control-browser one: https://codex-tool-reference.simonw.chatgpt.site/skills/cont...

    It tells ChatGPT Work how to launch a Playwright instance via its Node.js REPL, and tells it to run:

      nodeRepl.write(await browser.documentation());
    
    To get further instructions.

    That method returns this text with full details about how to use the browser: https://codex-tool-reference.simonw.chatgpt.site/skills/cont...

    I'd love to know why it's defined like that, as opposed to including all of the instructions directly in the skill Markdown file.

    • jw1224 2 hours ago ago

      I've used a similar technique with my own tools. It helps to save context overall, by deferring the detailed instructions not only to when they're needed, but also to where they're needed.

      Simply loading the browser Skill alone, doesn't always mean a browser is actually necessary (or supported). The user might've want them to control their main desktop browser; or the user might be pointing them toward a read-only HTML file that doesn't need rendering; or the sandbox might prevent network access; etc...

      Codex is especially 'keen' to use Skills (especially by comparison to Claude), I often see it load Skills which it doesn't go on to use, because the main Skill content says "when not to use this". So I'm sure this is a product design decision to help with those kinds of circumstances.

    • lanyard-textile 2 hours ago ago

      It's runtime dependent on the browser being used! A skill file wouldn't be able to have this dynamically injected for the browser that's about to be used.

      Skill file could indicate general instructions for all browsers. This provides guidance for the browser that's about to actually be used.

    • tomrod 43 minutes ago ago

      Two sources of truth, if playwright updates?

      Honestly, this is one of the things OpenAI does pretty well, I think, these tiny design decisions that you wouldn't notice until it becomes super annoying.

    • newswasboring 3 hours ago ago

      I'm guessing, but can be because then the skill will always fetch the latest docs.

  • simonw 3 hours ago ago

    See this comment for background (and creation prompt): https://news.ycombinator.com/item?id=49504625#49505116

    • cebert 2 hours ago ago

      Simon, thanks for all the great work you do. I definitely appreciate your contributions to discussion threads here as well as your blog. I learned so much from you.

    • owebmaster 3 hours ago ago

      [flagged]

      • dang an hour ago ago

        simonw is a fine contributor to HN and we're lucky to have him.

        I realize that for some people there is too much LLM-related content and (therefore?) too much by certain authors, but that has always been the case for certain topics and certain authors in HN's history. This is a side effect of the frontpage being the same for everyone, and therefore the scarcest resource.

        https://hn.algolia.com/?dateRange=all&page=0&prefix=true&que...

      • roseway4 2 hours ago ago

        Simon is not the OP. He’s just commenting on his own work. How is that spam?

      • simonw 3 hours ago ago

        My comment here is entirely justified in this case.

        Someone else submitted my vibe-coded slop site to the front page without any context, and it accumulated enough votes to show up at the top.

        I could have linked to my blog post about it, but instead I linked to a Hacker News comment precisely because I anticipated complaints about "spamming" if I linked to my blog.

      • yoavm 3 hours ago ago

        Simon, thank you for your comments and the great content you create. I've learned a lot from your blogposts and your experiments.

      • NoDodgeQuestion 3 hours ago ago

        You don't know, SimonW made Django Python framework?

        • Cheyana 2 hours ago ago

          Chuckling at a Python reference in a comment thread arguing about spam.

        • rob 2 hours ago ago

          Didn't he leave the project before it even had an official release?

          • rob an hour ago ago

            https://simonwillison.net/2005/Jul/17/django/

            > I haven’t been involved with Django since leaving the Journal-World back in September, but now that the framework is open-sourced I look forward to contributing to its further development—both in terms of documentation and actual code.

        • bewareofscams 2 hours ago ago

          Having done a thing does not make a person into a demigod embodiment for life, please remember that guys.

      • bewareofscams 2 hours ago ago

        I share the sentiment of the parent (downvoted) commenter.

      • infecto 3 hours ago ago

        I just tune out every post that says “I wrote about this already” and then links to it. Simon is great and kudos for his self promotion but it’s interesting to see as it’s often called out for anyone else.

        The guy is good but he certainly stretches the limit. I just auto ignore his stuff but I know others enjoy!

  • satvikpendem 2 hours ago ago

    I don't get how this is different from Codex if Codex can do all the same things.

    • simonw an hour ago ago

      ChatGPT Work in the ChatGPT desktop app is effectively Codex with a different skin. It can operate on your local files in the same way.

      ChatGPT Work in the ChatGPT web and mobile app experience is very different.

      If you like, you can think of it as a cloud-hosted version of Codex that's skinned to look more like consumer ChatGPT.

      • satvikpendem an hour ago ago

        If I use Codex in one session on desktop can I then resume it for cloud and mobile sessions as Work? Or do I have to make separate sessions each time? Or rather, can Codex in the cloud do the same things, if such a thing exists?

  • enraged_camel 3 hours ago ago

    Meta comment: I've been wondering why AI-generated websites/artifacts/reports always have the same "look". It reminds me of Bootstrap (CSS Framework) days when every startup website looked the same.

    Are they following some sort of common guideline?

    • simonw 3 hours ago ago

      In this case they really are, and you can read the guidelines that helped create the site on the site itself in the skills: https://codex-tool-reference.simonw.chatgpt.site/skills/site...

      Scroll down to the "Establish the visual direction" section.

      • tsunamifury 2 hours ago ago

        This can be replaced, you just have to do the work of building a design library yourself and the guidance components. Then building skills around their use.

    • Almondsetat 2 hours ago ago

      Because most AI generated websites are from people who don't know much and as such cannot even articulate the look they want

    • newswasboring 3 hours ago ago

      I think these guideline are built into the llms. After all with llms, any decision you don't take will be taken for you. For a so called slop site (Simon's words, not mine :P) I don't think they specified a style so the llm just decided the default it knows. One day I will run experiments (when I can afford it) trying to identify the "taste" of different llms.

  • ChrisArchitect 3 hours ago ago

    [dupe] Discussion on associated blog post: https://news.ycombinator.com/item?id=49504625

  • felixgallo 3 hours ago ago

    Anyone using ChatGPT Work given Sam Altman's richly documented history(1), the essential elimination and/or public exit of the safety function at OpenAI(2), and the huggingface debacle's exposure of the abject operational, cultural and technical failures at OpenAI(3), is making a serious mistake.

    (1) https://www.newyorker.com/magazine/2026/04/13/sam-altman-may... (2) https://thenextweb.com/news/openai-preparedness-team-disband... (3) https://thezvi.wordpress.com/2026/08/29/metr-and-redwood-off...

    • nickthegreek 2 hours ago ago

      Which provider currently lives up to your moral code?