skill-creator

Guides creation of Claude skills with SKILL.md templates, validation, and packaging scripts.

Updated Nov 10, 2013
One-click install
npx skills add https://github.com/bnferguson/dotfiles --skill skill-creator-bnferguson
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/bnferguson/dotfiles/tree/main/claude/config/skills/skill-creator
Command: npx skills add https://github.com/bnferguson/dotfiles --skill skill-creator-bnferguson

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Creating a well-structured Claude skill requires knowing the SKILL.md frontmatter format, directory conventions, and progressive disclosure design principles, which are easy to get wrong without guidance. ## Core Features & Use Cases - Skill Scaffolding: Run scripts/init_skill.py to generate a new skill directory with a SKILL.md template and example scripts/, references/, and assets/ folders. - Validation and Packaging: Use scripts/quick_validate.py to check frontmatter naming and description rules, and scripts/package_skill.py to bundle a validated skill into a distributable zip file. - Authoring Guidance: Follow a five-step process covering use-case discovery, resource planning, initialization, editing, and iteration. - Use Case: When asked to build a new skill such as a pdf-editor, use this skill to scaffold the directory, write the SKILL.md instructions, validate the frontmatter, and package the result for distribution. ## Quick Start Create a new skill called pdf-editor in the current skills directory using the skill-creator initialization script.

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 scripts/init_skill.py with a hyphen-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 to customize or delete.

What is required in a SKILL.md file?▼

SKILL.md requires YAML frontmatter with a name and description field, followed by Markdown instructions. The name must be hyphen-case lowercase, and the description should state what the skill does and when to use it.

How do I validate a skill before packaging it?▼

Run scripts/quick_validate.py against the skill directory. It checks that SKILL.md exists, the frontmatter is well-formed, the name follows hyphen-case rules, and the description contains no angle brackets.

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 output like templates or fonts. Not every skill needs all three directories.

How do I distribute a finished skill?▼

Run scripts/package_skill.py with the skill folder path and an optional output directory. It validates the skill first, then creates a zip archive containing all skill files for distribution.