skill-creator
Comprehensive guide for creating modular skills that extend Codex's specialized capabilities.
- Skills are self-contained folders with a required SKILL.md file and optional bundled resources (scripts, references, assets) that provide domain expertise, workflows, and tool integrations
- Follow progressive disclosure: metadata always in context, SKILL.md body loaded on trigger, bundled resources loaded as needed to minimize context bloat
- Six-step creation process: understand concrete examples, plan reusable contents, initialize with
init_skill.py, edit SKILL.md and resources, validate withquick_validate.py, and iterate based on usage - Keep SKILL.md under 500 lines; use references files for detailed schemas, APIs, and domain knowledge; use scripts for deterministic, repeatedly-rewritten code; use assets for templates and boilerplate
- Write clear, concise frontmatter descriptions that explain what the skill does and when to use it; Codex reads this to determine skill triggering
Skill Creator
This skill provides guidance for creating effective skills.
About Skills
Skills are modular, self-contained folders that extend Codex's capabilities by providing specialized knowledge, workflows, and tools. Think of them as "onboarding guides" for specific domains or tasks—they transform Codex from a general-purpose agent into a specialized agent equipped with procedural knowledge that no model can fully possess.
What Skills Provide
- Specialized workflows - Multi-step procedures for specific domains
- Tool integrations - Instructions for working with specific file formats or APIs
- Domain expertise - Company-specific knowledge, schemas, business logic
- Bundled resources - Scripts, references, and assets for complex and repetitive tasks
Core Principles
More from openai/skills
screenshot
Use when the user explicitly asks for a desktop or system screenshot (full screen, specific app or window, or a pixel region), or when tool-specific capture capabilities are unavailable and an OS-level capture is needed.
2.7Ksecurity-best-practices
Perform language and framework specific security best-practice reviews and suggest improvements. Trigger only when the user explicitly requests security best practices guidance, a security review/report, or secure-by-default coding help. Trigger only for supported languages (python, javascript/typescript, go). Do not trigger for general code review, debugging, or non-security tasks.
2.5Kfigma
Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.
2.4Kplaywright
Use when the task requires automating a real browser from the terminal (navigation, form filling, snapshots, screenshots, data extraction, UI-flow debugging) via `playwright-cli` or the bundled wrapper script.
2.4Kpdf
Use when tasks involve reading, creating, or reviewing PDF files where rendering and layout matter; prefer visual checks by rendering pages (Poppler) and use Python tools such as `reportlab`, `pdfplumber`, and `pypdf` for generation and extraction.
2.3Kfigma-implement-design
Translates Figma designs into production-ready application code with 1:1 visual fidelity. Use when implementing UI code from Figma files, when user mentions "implement design", "generate code", "implement component", provides Figma URLs, or asks to build components matching Figma specs. For Figma canvas writes via `use_figma`, use `figma-use`.
2.2K