foundry-skill-catalog

You can load Foundry Skills on demand by implementing a FoundrySkillsSource adapter that fetches ZIP-mode skill packages via the Skills REST API and extracts their SKILL.md instructions into your Hosted agent at runtime.

Foundry Skills REST API calls require the Foundry-Features: Skills=V1Preview header. Omitting this preview header on create, import, list, get, download, or delete operations will cause API traps and server errors.

Publishing a Foundry Skill returns an HTTP 500 error if the SKILL.md file contains quoted YAML frontmatter. You must use unquoted frontmatter formatting to avoid server errors when writing skill bodies to the catalog.

You cannot use JSON mode to download Foundry Skills because it operates as write-only. To retrieve and materialize skill packages for agent consumption, you must use ZIP-mode skill bodies through a FoundrySkillsSource adapter.

Build-time bundling seals skills into the agent image, while runtime fetch dynamically pulls shared catalog updates via the Skills REST API. Runtime fetching allows multiple Hosted agents to consume instruction text without duplicating or redeploying.

You do not need to deploy instruction text separately for each Hosted agent. Foundry Skills are centrally managed in a catalog, allowing multiple agents to retrieve and consume the same SKILL.md packages on demand.