skill-creator

Create and validate skill directories with SKILL.md templates and UI metadata.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill skill-creator-avatar-arts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/AvaTar-ArTs/.Agent-skills/tree/main/agents/skill-creator
Command: npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill skill-creator-avatar-arts

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 a new skill directory with a templated SKILL.md, agents/openai.yaml UI metadata, and optional scripts/, references/, and assets/ folders using init_skill.py. - Design Guidance: Apply progressive disclosure principles, degrees-of-freedom guidance, and proven workflow and output patterns when writing skill instructions. - Validation: Check frontmatter format, required fields, and hyphen-case naming rules with quick_validate.py before publishing. - Use Case: When you want to package a repeatable workflow, such as PDF form filling, as a reusable skill, use this skill to scaffold the directory, write the SKILL.md, generate the openai.yaml interface metadata, and validate the result. ## Quick Start Use the skill-creator skill to scaffold a new skill named pdf-form-filler with scripts and references resources and validate it.

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 from scratch?▼

Run scripts/init_skill.py with the skill name and output path, optionally passing --resources scripts,references,assets and --examples. The script generates the directory, a SKILL.md template with TODO placeholders, and agents/openai.yaml, which you then edit and validate.

What fields are required in SKILL.md frontmatter?▼

SKILL.md frontmatter requires only name and description. The name must be hyphen-case lowercase letters, digits, and hyphens 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 before publishing it?▼

Run scripts/quick_validate.py with the path to the skill folder. It checks YAML frontmatter format, required name and description fields, allowed properties, and hyphen-case naming rules, printing an error message if any check fails.

When should I use scripts, references, or assets in a skill?▼

Use scripts for deterministic executable code, references for documentation loaded into context as needed, and assets for files used in outputs like templates or fonts. Create only the directories the skill actually needs.

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

agents/openai.yaml stores UI-facing metadata such as display_name, short_description, icons, brand color, and default_prompt for skill lists and chips. Generate it with generate_openai_yaml.py by passing interface values as key=value arguments.