skills.rest
filipesf
filipesfCOMMUNITY
Explore all skills by this author →
Website𝕏@filipesfGitHub

skill-creator

Create or update Codex Skills with SKILL.md frontmatter and resource directories.

Updated Aug 27, 2026
Search Tags:#templates#documentation#SKILL.md#workflows#skill-creation#openai.yaml
One-click install
npx skills add https://github.com/filipesf/dotfiles --skill skill-creator-filipesf
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/filipesf/dotfiles/tree/main/agents/skills/system/skill-creator
Command: npx skills add https://github.com/filipesf/dotfiles --skill skill-creator-filipesf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PyYAML.

What problem does it solve?

This Skill provides a structured, repeatable approach to creating and updating Codex Skills, including the required SKILL.md frontmatter and optional resource directories for scripts, references, and assets.

Core Features & Use Cases

  • Guided skill scaffolding with SKILL.md templates and optional resource directories (scripts, references, assets)
  • Automated generation of UI metadata (agents/openai.yaml) from frontmatter and interface overrides
  • Validation and iteration workflow, including quick_validate checks and best-practice guidance

Quick Start

Use the Skill Initializer to scaffold a new skill, then customize SKILL.md and run validators. Example steps:

  • Initialize a new skill: python3 scripts/init_skill.py <skill-name> --path <output-directory> [--resources scripts,references,assets] [--examples] [--interface key=value]
  • Update metadata: python3 scripts/generate_openai_yaml.py <skill-dir> --interface key=value
  • Validate: python3 scripts/quick_validate.py <path-to-skill>

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 skill with a SKILL.md template?▼

To create a new skill, use the Skill Initializer script to scaffold the directory structure with a canonical SKILL.md frontmatter and optional resource directories for scripts, references, and assets.

What is the required frontmatter for a SKILL.md file?▼

The required frontmatter for a SKILL.md file must include the name and description fields, which are enforced during validation to ensure proper agent metadata generation.

How do I generate openai.yaml metadata from skill frontmatter?▼

You generate openai.yaml metadata by running the generate_openai_yaml.py script, which converts your SKILL.md frontmatter and interface overrides into the required agent UI metadata.

Can I validate a skill before publishing it to a workflow?▼

Yes, you can validate a skill before publishing by running the quick_validate.py script against your skill directory to check frontmatter requirements and apply best-practice guidance.

What's the best way to update an existing Codex skill?▼

The best way to update an existing Codex skill is to modify the SKILL.md content, adjust optional resource directories as needed, and then regenerate the openai.yaml metadata to reflect the changes.

Do I need PyYAML to generate agent metadata?▼

Yes, you need the PyYAML dependency installed in your environment to parse the frontmatter and generate the openai.yaml agent metadata file successfully.

Related Skills

Explore More Content & Communication Skills→
Fudan-SMI-labFudan-SMI-lab
39

torch-npu-pyyaml-preinstall

Preinstall PyYAML before torch-npu to prevent transitive dependency failures.

Official
Intermediate
tkerseytkersey
66

ms

Create, update, and refactor Codex skills with SKILL.md and agents/openai.yaml.

Community
Basic
PytaichukBohdanPytaichukBohdan

creating-new-skills

Create new Claude Code Agent Skills with structured SKILL.md files.

Community
Intermediate
dbowm91dbowm91

skills

Load and activate markdown-defined agent skills from project directories.

Community
Intermediate