Back to Skills

create-skill

Guide for creating well-structured Claude Code skills with proper YAML frontmatter, focused descriptions, and supporting files. Use when the user wants to create a new skill, build a custom skill, extend Claude's capabilities, or mentions creating/designing/building skills.

16starsUpdated 3/19/2026

Security Assessment

Safe(100/100)
Security Score100/100

About create-skill

The 'create-skill' AI skill is designed to guide users through the process of developing well-structured Claude Code skills. It addresses the challenge of creating new capabilities for Claude while ensuring adherence to best practices, proper YAML frontmatter formatting, and clear documentation. By providing step-by-step instructions, it helps users avoid common pitfalls such as incomplete descriptions, poorly defined trigger terms, or disorganized directory structures, streamlining the skill creation process and improving overall skill discoverability and usability.

This skill includes comprehensive guidance on writing SKILL.md files with required and optional frontmatter fields, defining precise descriptions with trigger terms, structuring directories with supporting files, and managing tool access restrictions. It emphasizes creating clear, specific descriptions that indicate both the functionality and the appropriate context for skill activation. Users are guided on organizing supporting files like reference documents, examples, scripts, and templates to ensure the skill is complete, maintainable, and easy for Claude to process efficiently.

The 'create-skill' skill is intended for developers, technical writers, and teams looking to extend Claude's capabilities with custom skills. Typical use cases include creating personal skills for individual projects, developing project-specific skills shared with teammates, and designing plugin skills for wider distribution. It is particularly useful for users who need structured guidance on skill creation, ensuring compliance with best practices, enhancing skill discoverability, and minimizing errors during deployment.

FAQ

How do I start creating a new skill?

Begin by understanding the requirement, then choose whether the skill will be personal, project-specific, or a plugin. Next, create the directory structure and write the SKILL.md following the specified format.

What are the required fields in SKILL.md?

Every SKILL.md file must include a 'name' using lowercase letters, numbers, and hyphens, and a 'description' that clearly explains what the skill does and when to use it. Optional fields include 'allowed-tools' to restrict tool usage.

Can I include supporting files?

Yes, you can add supporting documentation, example files, scripts, and templates. Use relative paths in SKILL.md to reference these files, and Claude will progressively load them as needed.

Where can I store my skills?

Personal skills can be stored in '~/.claude/skills/', project skills in '.claude/skills/', and plugin skills can be bundled for distribution. Personal skills are private, project skills are version-controlled and shared, and plugin skills are for broader usage.

Are there limitations on tool access?

Yes, you can restrict which tools a skill can use via the 'allowed-tools' field, which is useful for security-sensitive workflows or to prevent unintended modifications.

Install create-skill

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill