skill-creator

Create and validate Codex skill directories with templates, scripts, and frontmatter rules.

Updated Dec 20, 2025
One-click install
npx skills add https://github.com/koala-man-64/helpful-scripts --skill skill-creator-koala-man-64
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/koala-man-64/helpful-scripts/tree/main/exports/codex-skills/home-shared/.system/skill-creator
Command: npx skills add https://github.com/koala-man-64/helpful-scripts --skill skill-creator-koala-man-64

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve? Building a new Codex skill from scratch requires knowing the SKILL.md frontmatter contract, naming rules, directory layout, and validation criteria. This Skill encodes that procedural knowledge and ships the scripts that scaffold and check skills, removing guesswork and malformed-output failures. ## Core Features & Use Cases - Skill scaffolding: Run init_skill.py to generate a complete skill directory with a templated SKILL.md, agents/openai.yaml UI metadata, and optional scripts/, references/, and assets/ folders. - Validation and UI metadata: Run quick_validate.py to check frontmatter format, required fields, and hyphen-case naming, and generate_openai_yaml.py to produce display names and short descriptions for skill lists. - Authoring guidance: Provides design principles for concise instructions, progressive disclosure, degrees of freedom, and forward-testing with subagents. - Use Case: When asked to build a new pdf-editor skill, use this Skill to initialize the folder, write a triggering description, add a rotation script, and validate the result before delivery. ## Quick Start Use the skill-creator skill to scaffold a new skill named pdf-editor with scripts and references resources, then validate it.

Frequently Asked Questions about skill-creator

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

FAQPage Schema
How do I create a new Codex skill from scratch?▼

Run init_skill.py with a hyphen-case skill name and output path to generate the directory, SKILL.md template, and agents/openai.yaml. Then edit the SKILL.md description and body, add any needed scripts or references, and validate with quick_validate.py.

What fields are required in SKILL.md frontmatter?▼

Only name and description are required. The name must be lowercase hyphen-case under 64 characters, and the description must explain what the skill does and when to trigger it, without angle brackets, under 1024 characters.

How do I validate a skill folder before publishing?▼

Run quick_validate.py against the skill directory. It checks that SKILL.md exists, the YAML frontmatter parses, required fields are present, naming rules hold, and no unexpected frontmatter keys appear.

When should a skill include scripts, references, or assets?▼

Add scripts for deterministic or repeatedly rewritten code, references for documentation loaded into context on demand, and assets for files used in outputs like templates or fonts. Create only the directories the skill actually needs.

What is agents/openai.yaml used for in a skill?▼

It stores UI-facing metadata such as display_name, short_description, icons, and a default_prompt shown in skill lists and chips. Generate it with generate_openai_yaml.py or init_skill.py using interface key=value overrides.