AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

skill-creator

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations.

Original source
openai
License
Apache-2.0
Pinned revision
49f948faa9258a0c61caceaf225e179651397431

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read openai--skill-creator at revision 49f948faa9258a0c61caceaf225e179651397431, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 3

references/openai_yaml.md

openai.yaml fields (full example + descriptions)

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.

Full example

interface:
  display_name: "Optional user-facing name"
  short_description: "Optional user-facing description"
  icon_small: "./assets/small-400px.png"
  icon_large: "./assets/large-logo.svg"
  brand_color: "#3B82F6"
  default_prompt: "Optional surrounding prompt to use the skill with"

dependencies:
  tools:
    - type: "mcp"
      value: "github"
      description: "GitHub MCP server"
      transport: "streamable_http"
      url: "https://api.githubcopilot.com/mcp/"

Field descriptions and constraints

Top-level constraints:

  • Quote all string values.

  • Keep keys unquoted.

  • 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.").

  • interface.display_name: Human-facing title shown in UI skill lists and chips.

  • interface.short_description: Human-facing short UI blurb (25–64 chars) for quick scanning.

  • 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.

  • 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.

  • interface.brand_color: Hex color used for UI accents (e.g., badges).

  • interface.default_prompt: Default prompt snippet inserted when invoking the skill.

  • dependencies.tools[].type: Dependency category. Only mcp is supported for now.

  • dependencies.tools[].value: Identifier of the tool or dependency.

  • dependencies.tools[].description: Human-readable explanation of the dependency.

  • dependencies.tools[].transport: Connection type when type is mcp.

  • dependencies.tools[].url: MCP server URL when type is mcp.