skill-creator

Create and validate Codex skill directories with templates and scripts.

Updated Jul 31, 2026
One-click install
npx skills add https://github.com/AarnavBaddam/skills --skill skill-creator-aarnavbaddam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/AarnavBaddam/skills/tree/main/.system/skill-creator
Command: npx skills add https://github.com/AarnavBaddam/skills --skill skill-creator-aarnavbaddam

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Creating a well-structured skill requires knowing the SKILL.md frontmatter rules, naming conventions, resource organization, and validation requirements, which is easy to get wrong without guidance. ## Core Features & Use Cases - Skill Scaffolding: Initialize new skill directories with a SKILL.md template, optional scripts/references/assets folders, and agents/openai.yaml UI metadata via init_skill.py. - Authoring Guidance: Provides principles for concise instructions, progressive disclosure, degrees of freedom, and forward-testing with subagents. - Validation: Checks frontmatter format, required fields, naming rules, and description constraints with quick_validate.py. - Use Case: When you want to package a repeatable workflow (e.g., PDF rotation) as a reusable skill, use this skill to scaffold the directory, write the SKILL.md, generate UI metadata, and validate the result. ## Quick Start Use the skill-creator skill to create a new skill named pdf-rotator in my skills directory with a scripts folder.

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 the skill name and output path, optionally passing --resources scripts,references,assets and --examples. It generates a SKILL.md template with TODO placeholders, an agents/openai.yaml file, and any requested resource directories.

What fields are required in SKILL.md frontmatter?

SKILL.md frontmatter requires a name and a description. The name must be lowercase hyphen-case under 64 characters, and the description must explain what the skill does and when to use it, without angle brackets.

How do I validate a skill directory structure?

Run quick_validate.py with the path to the skill folder. It checks YAML frontmatter format, required name and description fields, naming rules, and rejects unexpected frontmatter keys, reporting specific errors to fix.

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. Only create directories the skill actually needs.

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

agents/openai.yaml holds UI-facing metadata such as display_name, short_description, icons, brand color, and default_prompt. Generate it with generate_openai_yaml.py or init_skill.py by passing values as --interface key=value overrides.