skill-creator

Create, validate, and package Claude skill directories with SKILL.md frontmatter.

Updated Jul 30, 2026
One-click install
npx skills add https://github.com/johsquaree/claude-basic-docs --skill skill-creator-johsquaree
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/johsquaree/claude-basic-docs/tree/main/.claude/skills/skill-creator
Command: npx skills add https://github.com/johsquaree/claude-basic-docs --skill skill-creator-johsquaree

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Building a new skill from scratch requires knowing the SKILL.md frontmatter format, directory conventions, and packaging rules, which is error-prone when done manually. This Skill guides the full lifecycle of creating, editing, validating, and packaging skills so they are discoverable and correctly structured. ## Core Features & Use Cases - Skill Initialization: Run scripts/init_skill.py to scaffold a new skill directory with a SKILL.md template and example scripts/, references/, and assets/ folders. - Authoring Guidance: Follow a six-step process covering use-case discovery, resource planning, SKILL.md writing style, and progressive disclosure design. - Validation & Packaging: Use scripts/package_skill.py to validate frontmatter, naming conventions, and description quality, then produce a distributable zip file. - Use Case: When asked to build a pdf-editor skill, use this Skill to scaffold the directory, add a rotate_pdf.py script, write proper frontmatter, and package the result as pdf-editor.zip. ## Quick Start Create a new skill named data-cleaner in the current workspace and 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 scripts/init_skill.py with a hyphen-case skill name and an output path. The script 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 must contain YAML frontmatter with a name and description field, followed by Markdown instructions. The name must be hyphen-case lowercase, and the description should explain what the skill does and when to use it.

How do I package a skill into a zip file?

Run scripts/package_skill.py with the path to the skill folder and an optional output directory. The script validates the skill first and only creates the zip archive if validation passes.

Why does skill validation fail on my SKILL.md?

Validation fails when frontmatter is missing, the name is not hyphen-case lowercase, the name starts or ends with a hyphen, or the description contains angle brackets. Fix the reported field and rerun the validator.

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

Use scripts/ for deterministic executable code, references/ for documentation loaded into context on demand, and assets/ for files used in outputs like templates or fonts. Not every skill needs all three directories.