{"$schema":"http://json-schema.org/draft-07/schema#","$id":"https://json.schemastore.org/codex-skill-metadata.json","title":"Codex skill metadata","description":"Metadata for OpenAI Codex skills.\nhttps://developers.openai.com/codex/skills#optional-metadata","type":"object","additionalProperties":true,"properties":{"$schema":{"title":"schema reference","type":"string","description":"JSON Schema reference for editor autocomplete and validation.\nhttps://developers.openai.com/codex/skills#optional-metadata"},"dependencies":{"title":"dependencies","type":"object","description":"Tool dependencies used by the skill.\nhttps://developers.openai.com/codex/skills#optional-metadata","additionalProperties":true,"properties":{"tools":{"title":"tools","type":"array","description":"External tools the skill depends on.\nhttps://developers.openai.com/codex/skills#optional-metadata","items":{"$ref":"#/definitions/toolDependency"}}}},"interface":{"title":"interface","type":"object","description":"UI metadata shown by Codex clients.\nhttps://developers.openai.com/codex/skills#optional-metadata","additionalProperties":true,"properties":{"brand_color":{"title":"brand color","type":"string","minLength":1,"description":"Hex color used for UI accents, such as badges.\nhttps://developers.openai.com/codex/skills#optional-metadata"},"default_prompt":{"title":"default prompt","type":"string","minLength":1,"description":"Default prompt snippet inserted when invoking the skill.\nhttps://developers.openai.com/codex/skills#optional-metadata"},"display_name":{"title":"display name","type":"string","minLength":1,"description":"Human-facing skill name shown in UI skill lists and chips.\nhttps://developers.openai.com/codex/skills#optional-metadata"},"icon_large":{"title":"large icon","type":"string","minLength":1,"description":"Path to a large icon asset, relative to the skill directory.\nhttps://developers.openai.com/codex/skills#optional-metadata"},"icon_small":{"title":"small icon","type":"string","minLength":1,"description":"Path to a small icon asset, relative to the skill directory.\nhttps://developers.openai.com/codex/skills#optional-metadata"},"short_description":{"title":"short description","type":"string","minLength":1,"description":"Human-facing short description for quick scanning.\nhttps://developers.openai.com/codex/skills#optional-metadata"}}},"policy":{"title":"policy","type":"object","description":"Skill invocation policy.\nhttps://developers.openai.com/codex/skills#optional-metadata","additionalProperties":true,"properties":{"allow_implicit_invocation":{"title":"allow implicit invocation","type":"boolean","description":"When false, Codex will not implicitly invoke the skill based on the user prompt. Explicit $skill invocation still works.\nhttps://developers.openai.com/codex/skills#optional-metadata"}}}},"definitions":{"toolDependency":{"title":"tool dependency","type":"object","description":"External tool dependency declaration.\nhttps://developers.openai.com/codex/skills#optional-metadata","required":["type","value"],"additionalProperties":true,"properties":{"description":{"title":"description","type":"string","minLength":1,"description":"Human-readable explanation of the dependency.\nhttps://developers.openai.com/codex/skills#optional-metadata"},"transport":{"title":"transport","type":"string","minLength":1,"description":"Connection type for the dependency. The currently documented MCP transport is streamable_http.\nhttps://developers.openai.com/codex/skills#optional-metadata"},"type":{"title":"type","type":"string","minLength":1,"description":"Dependency category. The currently documented value is mcp.\nhttps://developers.openai.com/codex/skills#optional-metadata"},"url":{"title":"url","type":"string","format":"uri","description":"Dependency server URL.\nhttps://developers.openai.com/codex/skills#optional-metadata"},"value":{"title":"value","type":"string","minLength":1,"description":"Identifier of the tool or dependency.\nhttps://developers.openai.com/codex/skills#optional-metadata"}}}}}