Codex/Skill

• Agent Skills in Codex

  • Built on the open standard Agent/Skills.
    • Use Progressive Disclosure, as per the spec.
  • Codex/Skill/Invocation

    • How do I get the loaded Codex/Skills to pop up in a menu where I can select from them? card

      • use $ to bring up the UX/Pattern/Text Input/Suggest/Completion menu for skills
  • Codex/Skill/Optional metadata

    • Codex Skills - Optional Metadata
      • Add agents/openai.yaml to configure UI metadata in the Codex app, to set invocation policy, and to declare tool dependencies for a more seamless experience with using the skill.
        yaml

        interface:
          display_name: "Optional user-facing name"
          short_description: "Optional user-facing description"
          icon_small: "./assets/small-logo.svg"
          icon_large: "./assets/large-logo.png"
          brand_color: "#3B82F6"
          default_prompt: "Optional surrounding prompt to use the skill with"
        
        policy:
          allow_implicit_invocation: false
        
        dependencies:
          tools:
            - type: "mcp"
              value: "openaiDeveloperDocs"
              description: "OpenAI Docs MCP server"
              transport: "streamable_http"
              url: "https://developers.openai.com/mcp"

        
        allow_implicit_invocation (default: true): When false, Codex won’t implicitly invoke the skill based on user prompt; explicit $skill invocation still works.