›_ Codex Issues
Codex Issues / #16307

icon_small for skills is not being displayed properly across the entire UI.

Open 💬 2 comments Opened Mar 31, 2026 by CIO-DOTNET

What version of the Codex App are you using (From “About Codex” dialog)?

26.325.31654

What subscription do you have?

Pro

What platform is your computer?

Microsoft Windows NT 10.0.19045.0 x64

What issue are you seeing?

icon_small for skills do not show up when they are set in agents/openai.yaml of a skill, and show generic icon. This goes for both System skills and Personal skills. See attached screenshots.

<img width="1187" height="449" alt="Image" src="https://github.com/user-attachments/assets/0210a266-9d6e-4d2c-ad76-829e0d9e97c3" />

<img width="774" height="377" alt="Image" src="https://github.com/user-attachments/assets/f74f5ef0-ab58-4774-965e-b03d07c28942" />

<img width="754" height="113" alt="Image" src="https://github.com/user-attachments/assets/66ce08d1-e53a-4a04-a30a-7c488af5630b" />

<img width="764" height="151" alt="Image" src="https://github.com/user-attachments/assets/7a43ecfd-5426-4a40-8071-b5d724e4df77" />

What steps can reproduce the bug?

Install any skill, have logo_small set in agents/openai.yaml of that skill, and generic icon appears instead of set icon. icon_large is working as expected.

This is observed in the VSCode Codex plugin, as well as the Codex App for Windows 10.

What is the expected behavior?

The file set for icon_small in agents/openai.yaml should appear. Find example below:

interface:
  display_name: "Word Docs"
  short_description: "Edit and review docx files"
  icon_small: "./assets/doc-small.svg"
  icon_large: "./assets/doc.png"
  default_prompt: "Edit or review this .docx file and return the updated file plus a concise change summary."

Additional information

This was working as expected last week and has started since updating to the latest version.

View original on GitHub ↗

2 Comments

CIO-DOTNET · 3 months ago

Still experiencing this in version 26.506.21252.

CIO-DOTNET · 3 months ago

Additional investigation from Windows 10 / Codex Desktop 26.519.5221.0.

I used Codex on GPT-5.5 with extra-high reasoning to diagnose this. I cannot prove the exact root cause, but the investigation narrows where the bug appears to be.

A live codex app-server probe returns skills/list metadata with interface.iconSmall resolved to an absolute Windows path.

A live plugin/list / plugin/installed probe for the bundled Browser plugin also returns interface.composerIcon and interface.logo as absolute Windows paths.

So this does not look like a manifest-discovery or app-server path-resolution failure on my machine.

The likely remaining area is the Desktop renderer:

  • Skill mention surfaces may not be using SkillInterface.iconSmall even though the payload contains it.
  • Local icon image loading may be silently falling back, especially for Windows paths converted into Electron media URLs like app://fs/@fs/C:/Users/....
  • If this is Windows 10-only, please test that renderer/media URL path on Windows 10 specifically.

Suggested checks:

  1. Verify skill at-mention and inline mention UI actually render SkillInterface.iconSmall.
  2. Add logging on icon image onError, including the original icon path and resolved image URL.
  3. Add a Windows regression test where skills/list returns interface.iconSmall = C:\...\doc-small.svg and the mention UI displays it.
  4. Add a Windows regression test where plugin/list returns interface.composerIcon = C:\...\composer-icon.png and the Desktop renderer loads the resulting local media URL.

Related source/issue context: