Non-discoverable (manual) skills

Resolved 💬 2 comments Opened Jan 4, 2026 by valwalt Closed Jan 5, 2026

What feature would you like to see?

Some skills you only want the model to invoke if you reference them directly (via $). Reasons include not wanting to waste context or the skill being undesirable for the model to trigger at will.

We could add a new property to the metadata front matter:

metadata:
  discoverable: false

Additional information

_No response_

View original on GitHub ↗

2 Comments

santiago-afonso · 7 months ago

You should post this to the Agent Skills specification's repo https://github.com/agentskills/agentskills which codex follows @ValentinWalter

valwalt · 7 months ago

Just posted it over there: https://github.com/agentskills/agentskills/issues/68