Create New Skills

Create new Claude Code Agent Skills with SKILL.md structure and YAML frontmatter.

1.5k|387|Updated Jul 13, 2025
One-click install
npx skills add https://github.com/disler/claude-code-hooks-multi-agent-observability --skill create-new-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Create New Skills
Source: https://github.com/disler/claude-code-hooks-multi-agent-observability/tree/main/.claude/skills/meta-skill
Command: npx skills add https://github.com/disler/claude-code-hooks-multi-agent-observability --skill create-new-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Creating effective AI skills requires understanding best practices, file structures, and how to integrate them with Claude. This Skill provides a comprehensive, step-by-step guide, eliminating guesswork and ensuring new skills are well-designed and functional, so you can extend Claude's capabilities with confidence.

Core Features & Use Cases

  • Guided Skill Creation: Follow a structured workflow to define, design, and implement new Claude Skills, from purpose definition to testing.
  • Best Practices & Examples: Learn optimal SKILL.md structure, effective description writing, and how to leverage supporting files for complex tasks.
  • Progressive Disclosure: Understand how to manage context efficiently by linking additional resources, keeping Claude's focus on what's relevant.
  • Use Case: You want Claude to become an expert in your company's internal API. Use this skill to guide Claude in creating a new api-documentation skill, complete with example usage and troubleshooting steps, transforming Claude into a more effective team member.

Quick Start

I want to create a new skill for managing my project's documentation. Guide me through the process.

Frequently Asked Questions about Create New Skills

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

FAQPage Schema
How do I create a new Claude Code skill from scratch?

Creating a Claude Code skill requires defining its purpose, structuring a SKILL.md file with Instructions and Examples, adding YAML frontmatter with name and description, optionally including allowed-tools, and packaging reference files. Follow the guided workflow from scaffolding through validation and testing to ensure your skill is functional and well-documented.

What's the best way to structure a skill's documentation and file organization?

Skill documentation follows best practices: YAML frontmatter at the top with name and description, a well-structured SKILL.md containing Instructions and Examples sections, optional allowed-tools definitions, and supporting reference files for complex tasks. Progressive disclosure keeps Claude's context focused by linking additional resources rather than embedding everything inline.

Can I package domain expertise into reusable Claude skills for my team?

Yes. Create domain-specific skills that encapsulate your team's expertise, internal APIs, or custom workflows into reusable capabilities. Document step-by-step instructions, provide concrete examples, and use Git-based collaboration to share skills across projects or personal workspaces, making Claude a more effective specialist for your organization.

What do I need to validate and test before deploying a new skill?

Before deployment, validate that your skill meets the YAML frontmatter requirements, verify SKILL.md structure includes Instructions and Examples, test with reference files if applicable, and confirm allowed-tools declarations match your implementation. Use Git-based workflows to collaborate and validate changes before sharing.

How does progressive disclosure improve skill design and context efficiency?

Progressive disclosure manages context by linking supporting resources instead of embedding all content inline, keeping Claude's focus on relevant information at each step. Structure your skill to present essential instructions first, then reference detailed materials, troubleshooting, or examples only when needed, reducing cognitive load.

Do I need to write code to build a Claude skill?

No. Building a Claude skill is a documentation and design task, not a programming task. You structure YAML frontmatter, write clear Instructions and Examples in SKILL.md, organize reference files, and define allowed-tools if needed. The Skill guides you through best practices without requiring software development expertise.