create-skill

Guide authors to compose compliant SKILL.md files and scaffold Claude skill directories.

16|1|Updated Sep 24, 2025
One-click install
npx skills add https://github.com/Hey-Diga/dotclaude --skill create-skill-hey-diga
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-skill
Source: https://github.com/Hey-Diga/dotclaude/tree/main/skills/create-skill
Command: npx skills add https://github.com/Hey-Diga/dotclaude --skill create-skill-hey-diga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill removes uncertainty and errors when creating new Claude skill directories and SKILL.md files by providing a clear, prescriptive workflow for naming, frontmatter, trigger definition, and instruction structure so contributors produce consistent, discoverable skills.

Core Features & Use Cases

  • Frontmatter generation: Templates and rules for required YAML fields including name and description that contains "Use when" trigger phrases.
  • Name validation: Enforces kebab-case, folder-name matching, and reserved-word restrictions to prevent upload errors and unexpected triggers.
  • Instruction and workflow scaffolding: Step-by-step guidance for writing the SKILL.md body, progressive disclosure levels, error handling, and a final validation checklist.
  • Review and integration tasks: Guides scanning existing skills for overlap, updating CLAUDE.md, and presenting the finished skill for testing.
  • Use Cases: Bootstrapping new skills, auditing existing SKILL.md files, onboarding contributors to Claude skill conventions.

Quick Start

Create a new kebab-case skill folder and write a SKILL.md with YAML frontmatter including name and a one-sentence description that contains "Use when" trigger phrases and an allowed-tools list.

Frequently Asked Questions about create-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a compliant SKILL.md file for a new Claude skill?

To create a compliant SKILL.md file, you need YAML frontmatter with a name, a description containing "Use when" trigger phrases, and an allowed-tools field. The skill folder name must be kebab-case to pass validation.

What is the correct YAML frontmatter format for Claude skill directories?

The correct YAML frontmatter format requires a name field, a description field that includes "Use when" trigger phrases, and an allowed-tools list. This frontmatter structure ensures your skill is discoverable and triggers properly.

How do I write trigger phrases for Claude skill instructions?

Trigger phrases for Claude skill instructions are written in the description field of the YAML frontmatter using the "Use when" format. This specifies the exact conditions when the skill should activate during a conversation.

Can I use uppercase letters or spaces in Claude skill folder names?

No, you cannot use uppercase letters or spaces in skill folder names. The validation enforces strict kebab-case folder naming, matching the folder name to the frontmatter name, and restricts reserved words to prevent upload errors.

What is the best way to scaffold a new skill directory without errors?

The best way to scaffold a skill directory is following a prescriptive workflow that generates frontmatter, validates kebab-case names, drafts instruction workflows, and applies a final validation checklist to ensure consistency and discoverability.

Why does my Claude skill fail validation when uploading?

Skill validation fails when the folder name is not kebab-case, the YAML frontmatter lacks a name or description with "Use when" triggers, or the allowed-tools field is missing. Reserved words in the name also cause upload errors.