skill-creator

Source excerpt starting at line 1.

1# openai.yaml fields (full example + descriptions)2 3`agents/openai.yaml` is an extended, product-specific config intended for the machine/harness to read, not the agent. Other product-specific config can also live in the `agents/` folder.4 5## Full example6 7```yaml8interface:9  display_name: "Optional user-facing name"10  short_description: "Optional user-facing description"11  icon_small: "./assets/small-400px.png"12  icon_large: "./assets/large-logo.svg"13  brand_color: "#3B82F6"14  default_prompt: "Optional surrounding prompt to use the skill with"15 16dependencies:17  tools:18    - type: "mcp"19      value: "github"20      description: "GitHub MCP server"21      transport: "streamable_http"22      url: "https://api.githubcopilot.com/mcp/"23 24policy:25  allow_implicit_invocation: true26```27 28## Field descriptions and constraints29 30Top-level constraints:31 32- Quote all string values.33- Keep keys unquoted.34- For `interface.default_prompt`: generate a helpful, short (typically 1 sentence) example starting prompt based on the skill. It must explicitly mention the skill as `$skill-name` (e.g., "Use $skill-name-here to draft a concise weekly status update.").35 36- `interface.display_name`: Human-facing title shown in UI skill lists and chips.37- `interface.short_description`: Human-facing short UI blurb (25–64 chars) for quick scanning.38- `interface.icon_small`: Path to a small icon asset (relative to skill dir). Default to `./assets/` and place icons in the skill's `assets/` folder.39- `interface.icon_large`: Path to a larger logo asset (relative to skill dir). Default to `./assets/` and place icons in the skill's `assets/` folder.40- `interface.brand_color`: Hex color used for UI accents (e.g., badges).41- `interface.default_prompt`: Default prompt snippet inserted when invoking the skill.42- `dependencies.tools[].type`: Dependency category. Only `mcp` is supported for now.43- `dependencies.tools[].value`: Identifier of the tool or dependency.44- `dependencies.tools[].description`: Human-readable explanation of the dependency.45- `dependencies.tools[].transport`: Connection type when `type` is `mcp`.46- `dependencies.tools[].url`: MCP server URL when `type` is `mcp`.47- `policy.allow_implicit_invocation`: When false, the skill is not injected into48  the model context by default, but can still be invoked explicitly via `$skill`.49  Defaults to true.50