skill-creator

Create, validate, and package Claude skill directories with scripts and templates.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/dsonyy/dotfiles --skill skill-creator-dsonyy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/dsonyy/dotfiles/tree/main/skills/skill-creating
Command: npx skills add https://github.com/dsonyy/dotfiles --skill skill-creator-dsonyy

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Building a well-structured skill requires knowing the SKILL.md frontmatter rules, directory conventions, and packaging steps, and doing this by hand is error-prone and inconsistent. ## Core Features & Use Cases - Skill Initialization: Run init_skill.py to scaffold a new skill directory with a SKILL.md template and example scripts, references, and assets folders. - Validation and Packaging: Use quick_validate.py and package_skill.py to check frontmatter, naming conventions, and description quality, then produce a distributable .skill zip file. - Design Guidance: Follow built-in principles on progressive disclosure, degrees of freedom, and reference patterns for workflows and output formats. - Use Case: You want to add a pdf-editor skill to your dotfiles repo. Initialize it with the script, fill in the SKILL.md, validate it, and package it into a .skill file ready to share. ## Quick Start Create a new skill named pdf-editor using the skill-creator scripts and then package it for distribution.

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

Run init_skill.py with a kebab-case skill name and an output path. It generates a skill directory containing a SKILL.md template with TODO placeholders plus example scripts, references, and assets folders you can customize or delete.

How to package a skill into a .skill file?▼

Run package_skill.py with the path to your skill folder and an optional output directory. The script validates the skill first, then creates a zip archive with a .skill extension containing the full directory structure.

What are the SKILL.md frontmatter requirements?▼

The frontmatter must include name and description fields. The name must be kebab-case, lowercase letters, digits, and hyphens only, with a 64 character maximum. The description cannot contain angle brackets and is limited to 1024 characters.

Why does skill validation fail on my frontmatter?▼

Validation fails when required fields are missing, the name uses invalid characters or consecutive hyphens, or unexpected keys appear beyond the allowed set of name, description, license, allowed-tools, metadata, and compatibility.

When should I use scripts versus references in a skill?▼

Use scripts for deterministic, repeatedly rewritten code like file conversions that can execute without loading into context. Use references for detailed documentation such as schemas or API guides that Claude reads only when needed.