create-skill

Generate a Claude Code skill directory with SKILL.md and YAML frontmatter.

17|2|Updated Dec 27, 2013
One-click install
npx skills add https://github.com/l-lin/dotfiles --skill create-skill-l-lin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-skill
Source: https://github.com/l-lin/dotfiles/tree/main/home-manager/modules/share/ai/.config/ai/skills/create-skill
Command: npx skills add https://github.com/l-lin/dotfiles --skill create-skill-l-lin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It automates the creation of a new Claude Skill by generating a standardized skeleton (directory structure, YAML frontmatter, and optional resources).

Core Features & Use Cases

  • Skeleton generation: creates SKILL.md, reference.md, examples.md, scripts/, templates/
  • Frontmatter enforcement: ensures name and description fields are present
  • Discovery-ready: provides triggers and keywords for Claude to match intents

Quick Start

Create a new skill named my-skill and place it under ~/.claude/skills/my-skill; the tool will generate the required files.

Frequently Asked Questions about create-skill

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

FAQPage Schema
How do I scaffold a new Claude skill with proper structure?

Scaffolding a Claude skill generates a standardized directory structure at ~/.claude/skills/<skill-name>/ with SKILL.md, reference.md, and templates. Use the create-skill command and provide a skill name, description, and trigger phrases to automatically set up YAML frontmatter, workflow documentation, inputs/outputs specifications, and error handling guidelines following best practices.

What files and directories does skill scaffolding create?

Skill scaffolding creates SKILL.md with YAML frontmatter, reference.md for documentation, examples.md for usage patterns, a scripts/ directory for automation logic, and a templates/ directory for reusable components. This structure ensures discovery-readiness and aligns with Claude Code skill best practices for naming, keywords, and trigger phrase configuration.

Can I automate the creation of reusable Claude capabilities?

Yes, the create-skill command automates reusable Claude capability creation by extracting skill name, description, and trigger phrases from your input, then generating a complete directory structure with enforced YAML frontmatter, workflow documentation, and validation. This eliminates manual scaffolding and ensures consistency across your skill library.

What preparation is needed before creating a new skill?

Before scaffolding, have a clear skill name, a concise description of what the skill does, and trigger phrases users would say to invoke it. The create-skill command handles directory structure, frontmatter validation, and file generation automatically, so no environment setup or manual file creation is required.

How do I ensure my new skill follows Claude best practices?

The create-skill scaffold enforces best practices by automatically including YAML frontmatter validation, workflow and input/output documentation templates, error handling guidance, and versioning conventions. All generated files align with Claude Code skill standards, so your skill integrates seamlessly with the platform.

What's the fastest way to build a Claude skill from scratch?

Use the create-skill command to generate a complete skill skeleton in seconds: provide a skill name, description, and trigger phrases, and it creates the full directory structure, documentation templates, and YAML frontmatter automatically. This is faster than manual file creation and guarantees alignment with best practices.