skill-creator

Create and validate Skill units with SKILL.md frontmatter and resource scaffolds.

Updated Jul 10, 2023
One-click install
npx skills add https://github.com/iamtatsuki05/dotfiles --skill skill-creator-iamtatsuki05
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/iamtatsuki05/dotfiles/tree/main/dotfiles/.agent/skills/.system/skill-creator
Command: npx skills add https://github.com/iamtatsuki05/dotfiles --skill skill-creator-iamtatsuki05

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Guides users to create or update a Skill unit by enforcing a SKILL.md frontmatter with name and description and by organizing optional resources (scripts, references, assets) to ensure consistent structure and discoverability.

Core Features & Use Cases

  • Provides templates and scaffolding for new skills, including SKILL.md and agents/openai.yaml.
  • Supports resource scaffolding (scripts, references, assets) and example content to accelerate onboarding.
  • Includes validation tooling (quick_validate.py) to catch basic structural issues before deployment.
  • Used when creating a new skill or updating an existing skill to extend Codex's capabilities with specialized workflows or integrations.

Quick Start

Run scripts/init_skill.py <skill-name> --path <path> to create a skeleton, then edit SKILL.md and run scripts/quick_validate.py <skill-dir> to validate.

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 proper SKILL.md frontmatter and structure?

To create a new Codex skill, run scripts/init_skill.py to generate a skeleton, edit the SKILL.md frontmatter with name and description, and run scripts/quick_validate.py to validate. This process ensures proper structure, metadata, and discoverability.

What is the best way to validate a skill structure before deployment?

The best way to validate a skill structure is by running scripts/quick_validate.py on the skill directory. This validation tool catches basic structural issues with the SKILL.md frontmatter and resource scaffolding, ensuring consistency across skills before deployment.

Do I need YAML to define skill metadata and agents?

You need YAML to define skill metadata and agents through the agents/openai.yaml file. The skill creation process enforces frontmatter hygiene and uses YAML to standardize structure, metadata, and validation across the skill unit.

Can I use templates to scaffold optional resources like scripts and references for a skill?

You can use templates to scaffold optional resources like scripts, references, and assets for a skill. The skill creation tooling provides resource scaffolds and example content to accelerate onboarding and standardize progressive disclosure.

Why does my skill unit fail validation checks?

Your skill unit fails validation checks when the SKILL.md frontmatter lacks proper name and description fields, or when optional resources are not organized correctly. The validation tool enforces frontmatter hygiene and structural consistency.

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

The best way to update an existing skill is by editing the SKILL.md frontmatter and organizing optional resources like scripts and references. Run the validation tool after updates to ensure metadata consistency and discoverability across the extended Codex workflows.