create-skill

Creates Claude Code skills, subagents, rules, and hooks with validated SKILL.md frontmatter.

5|1|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/ai-hero/hero-skills --skill create-skill-ai-hero
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-skill
Source: https://github.com/ai-hero/hero-skills/tree/main/skills/create-skill
Command: npx skills add https://github.com/ai-hero/hero-skills --skill create-skill-ai-hero

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a well-structured Claude Code skill, subagent, rule, or hook requires knowing the Agent Skills format, frontmatter rules, and naming conventions. This Skill guides you through defining trigger conditions and success criteria, then writes a validated SKILL.md that follows the specification. ## Core Features & Use Cases - Component Type Selection: Chooses between skill, subagent, rule, or hook based on whether you need workflows, isolated execution, always-on constraints, or event-triggered automation. - Format Guidance and Validation: Enforces frontmatter rules (name, description, argument-hint), the 500-line body limit, and anti-pattern checks like avoiding duplicate info and lowercase placeholders. - Recalibrate Mode: Tunes the HERO.md configuration fields this Skill reads before running, so misconfigured values are fixed without a full run. - Use Case: After completing a tricky deployment manually, ask to capture that procedure as a reusable skill so the agent follows the exact steps next time. ## Quick Start Ask Claude to create a skill that notifies Slack when a deployment finishes, using the create-skill command.

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 custom Claude Code skill?

Describe what you want the skill to do, when it should trigger, and what success looks like. The skill writes a SKILL.md with valid frontmatter into .claude/skills/NAME/ and validates naming, description length, and file references.

What is the difference between a skill, subagent, rule, and hook in Claude Code?

Skills are workflow instructions loaded on demand, subagents run isolated execution, rules are always-on constraints, and hooks are event-triggered automation in settings.json. The skill picks the right type based on your goal.

What frontmatter fields does a SKILL.md file require?

Only name and description are required by the Agent Skills spec. Optional fields include argument-hint, disable-model-invocation, license, compatibility, metadata, and allowed-tools, plus the hero-skills-specific wayfare field.

Where are user-level Claude Code skills stored?

Project skills go in .claude/skills/NAME/SKILL.md, while user-level skills go in ~/.claude/skills/ for cross-project availability. The folder name must match the name field in the frontmatter.

Why should a SKILL.md stay under 500 lines?

The agent loads the entire SKILL.md on activation, so every line competes with the conversation for context. Longer material belongs in references/ files with explicit instructions on when to read each one.