skill-creator

Create and validate Skill Units with SKILL.md frontmatter and supporting scripts.

6|1|Updated Dec 8, 2009
One-click install
npx skills add https://github.com/jey3dayo/dotfiles --skill skill-creator-jey3dayo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/jey3dayo/dotfiles/tree/main/agents/skills/skill-creator
Command: npx skills add https://github.com/jey3dayo/dotfiles --skill skill-creator-jey3dayo

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Define Skill Units as self-contained folders identified by a root SKILL.md frontmatter that includes a name and a description.

Core Features & Use Cases

  • Modular, self-contained structure: Each skill sits in its own folder with a mandatory SKILL.md frontmatter and optional resources.
  • Template-driven initialization and validation: Uses scripts/init_skill.py to bootstrap new skills and scripts/quick_validate.py to ensure integrity.
  • Resource scaffolding: Supports optional scripts/, references/, and assets/ directories for deterministic tasks, documentation, and output assets.
  • UI integration via agents/openai.yaml: Generates an interface section for UI metadata.
  • Progressive disclosure design patterns: Encourages splitting content into references and assets to manage context load.

Quick Start

Initialize a new skill using the provided template, then customize SKILL.md and add optional resources as needed.

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 a modular folder structure?▼

To create a Codex skill, use the init_skill.py script to bootstrap a self-contained folder with a root SKILL.md frontmatter, then add optional scripts, references, and assets directories for modular reuse and selective context loading.

What is a Skill Unit in Codex and how does progressive disclosure work?▼

A Skill Unit is a self-contained folder identified by a SKILL.md frontmatter. Progressive disclosure works by storing optional resources in references and assets directories, loading them on-demand to manage context load efficiently.

How do I validate Codex skill structure and frontmatter before deployment?▼

You validate Codex skill structure by running the quick_validate.py script, which ensures consistent naming, folder integrity, and interface data to verify that your SKILL.md frontmatter meets the required specifications.

Can I generate OpenAI UI metadata for my custom skill development workflow?▼

Yes, you can generate OpenAI UI metadata by using the generate_openai_yaml.py script, which creates an agents/openai.yaml file containing the interface section needed for UI integration of your custom skill.

Do I need pyyaml to generate OpenAI YAML files for skill templates?▼

Yes, pyyaml is a required dependency for generating OpenAI YAML files, as the generate_openai_yaml.py script relies on it to parse and output the interface metadata for UI integration.

When should I split content into references instead of keeping it in SKILL.md?▼

You should split content into references when your SKILL.md becomes too large, using progressive disclosure design patterns to manage context load by storing documentation in separate directories loaded on-demand.