skills.rest
oozoofrog
oozoofrogCOMMUNITY
Explore all skills by this author →
𝕏@oozoofrogGitHub

codex-skill-bootstrap

Create minimal SKILL.md frontmatter and optional agents/openai.yaml for repo-local Codex skills.

Updated Mar 27, 2026
Search Tags:#audit#frontmatter#references#bootstrap#skill-structure#openai.yaml#codex-skill
One-click install
npx skills add https://github.com/oozoofrog/codex-skills-project --skill codex-skill-bootstrap
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codex-skill-bootstrap
Source: https://github.com/oozoofrog/codex-skills-project/tree/main/.agents/skills/codex-skill-bootstrap
Command: npx skills add https://github.com/oozoofrog/codex-skills-project --skill codex-skill-bootstrap

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill helps teams quickly scaffold or modernize a Codex skill by creating a minimal, standards-compliant structure (SKILL.md at the root, optional agents/openai.yaml, and well-organized references) and guiding the alignment with Codex discovery rules.

Core Features & Use Cases

  • Create a minimal repo-local skill structure: SKILL.md and optional openai.yaml.
  • Split long instructions into a references directory for progressive disclosure.
  • Validate the skill layout against the repository's audit harness to ensure discovery readiness.

Quick Start

Create or update a repo-local Codex skill folder named codex-skill-bootstrap with a minimal SKILL.md frontmatter and an optional agents/openai.yaml, then run the audit to verify structure.

Frequently Asked Questions about codex-skill-bootstrap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bootstrap a repo-local Codex skill with a clean structure?▼

To bootstrap a Codex skill, create a minimal SKILL.md frontmatter at the root with name and description, add an optional agents/openai.yaml for metadata, and organize references in directories to ensure a clean, validated structure.

What does an audit-ready SKILL.md frontmatter require?▼

An audit-ready SKILL.md frontmatter requires the presence of a name and description. It should be validated against the repository's audit harness to ensure discovery readiness and aligned with Codex discovery rules.

How do I split long Codex skill instructions for progressive disclosure?▼

To split long instructions for progressive disclosure, move detailed content into a references directory. This separates extended guidance from the minimal SKILL.md, maintaining a clean root structure.

Can I migrate an existing Codex skill to the standard layout?▼

You can migrate existing skills to the standard layout by modernizing the frontmatter and metadata. This includes upgrading to a minimal SKILL.md and an optional agents/openai.yaml file for discovery.

How do I validate a Codex skill layout for discovery readiness?▼

You validate a Codex skill layout by running the repository's audit harness. This checks for the required SKILL.md frontmatter and optional scripts, references, and assets directories to ensure it meets discovery rules.

When do I need an agents/openai.yaml file for my skill?▼

You need an agents/openai.yaml file when adding optional discovery metadata to your repo-local skill. It works alongside the required SKILL.md to provide a clean, standards-compliant structure for Codex.

Related Skills

Explore More Software Engineering Skills→
tkerseytkersey
66

ms

Create, update, and refactor Codex skills with SKILL.md and agents/openai.yaml.

Community
Basic
ippontechippontech
14

skill

Validate Skill unit structure with SKILL.md and YAML frontmatter.

Official
Basic
haryelramalhoharyelramalho

skill-best-practices

Validate agent skill metadata and SKILL.md structure against compliance checklists.

Community
Advanced
jinzhezenggroupjinzhezenggroup
124

create-skill

Generate standardized Agent Skill directories with SKILL.md frontmatter and validation.

Official
Intermediate