What problem does it solve? Repeated workflows get re-explained in every session because there is no consistent process for turning them into reusable Codex skills with triggerable descriptions and correct placement. ## Core Features & Use Cases - Skill Authoring Workflow: Guides creation from concrete trigger phrasings through frontmatter description writing to body structure, keeping AGENTS.md terse and moving detail into references. - Placement Decisions: Distinguishes personal skills in ~/.codex/skills from repo-local skills in .agents/skills based on whether the workflow depends on host-level state or repo-owned scripts. - Validation Wrapper: Runs the installed OpenAI quick_validate.py over one or more skills via scripts/codex_skill_validate.py, with uv fallback, validator discovery, and JSON report output. - Use Case: After noticing the same release-check procedure repeated across repos, use this Skill to draft a personal skill, write a description that triggers reliably, and validate it before committing. ## Quick Start Use the joey-skill-authoring skill to turn this repeated workflow into a validated personal Codex skill with a proper frontmatter description.
