skill-creator

Create and update Codex skills with SKILL.md frontmatter and resource directories.

1|Updated Nov 1, 2025
One-click install
npx skills add https://github.com/rselbach/dotfiles --skill skill-creator-rselbach
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/rselbach/dotfiles/tree/main/codex/skills/.system/skill-creator
Command: npx skills add https://github.com/rselbach/dotfiles --skill skill-creator-rselbach

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Guides users to create and update Codex skills.

Core Features & Use Cases

  • Provides templates and best practices for structuring Skill Units, including SKILL.md, scripts/, references/, and assets/.
  • Supports creation and updating workflows with validation and metadata guidance.
  • Demonstrates how to scaffold new skills and evolve existing ones with minimal friction.

Quick Start

Run the skill initialization workflow using scripts/init_skill.py with a new skill name and the desired resources.

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 with scripts and references?

To create a new Codex skill, run the initialization workflow using scripts/init_skill.py with your desired skill name and resource directories. This scaffolds the SKILL.md file and optional scripts/, references/, and assets/ folders automatically.

What is a Skill Unit and how does its structure work?

A Skill Unit is a modular component guided by a SKILL.md file containing required frontmatter like name and description. It supports optional resource directories including scripts, references, and assets for bundling tooling integrations and workflows.

How do I validate Codex skill metadata and frontmatter?

You validate Codex skill metadata by ensuring the SKILL.md frontmatter contains a name and description, then using the built-in validation tooling. This aligns your skill with agents metadata and confirms the structural requirements are met.

Can I update existing Codex skills without rebuilding the structure?

Yes, you can update existing Codex skills by evolving the SKILL.md and adding resources with minimal friction. The skill supports creation and updating workflows, allowing you to modify templates and metadata guidance without rebuilding from scratch.

Do I need pyyaml to scaffold and validate Codex skills?

Yes, pyyaml is required as a dependency to scaffold and validate Codex skills. It supports the validation tooling and metadata processing needed to parse the SKILL.md frontmatter and align with agents metadata.

What are the limitations when building modular skill workflows?

The main limitation is that SKILL.md frontmatter must contain a name and description to pass validation. While optional resource directories are supported, all bundled scripts and references must align with the agents metadata and validation tooling constraints.