create-skill

Create or update Claude skills with YAML frontmatter and SKILL.md structure.

5|3|Updated Oct 23, 2025
One-click install
npx skills add https://github.com/Cygnusfear/claude-stuff --skill create-skill-cygnusfear
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-skill
Source: https://github.com/Cygnusfear/claude-stuff/tree/main/skills/create-skill
Command: npx skills add https://github.com/Cygnusfear/claude-stuff --skill create-skill-cygnusfear

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Extending Claude's capabilities with specialized knowledge or tools requires understanding the skill anatomy and best practices for effective AI consumption. This skill provides comprehensive guidance through the entire skill creation process, from conceptualization to testing and iteration.

Core Features & Use Cases

  • Skill Anatomy & Progressive Disclosure: Explains the structure of a skill (SKILL.md, scripts/, references/, assets/) and how to manage context efficiently.
  • Step-by-Step Creation Workflow: Guides users through understanding concrete examples, planning reusable content, initializing, editing, and iterating on skills.
  • Best Practices for AI Consumption: Emphasizes metadata quality, imperative writing style, and avoiding duplication to optimize skill usage by AI agents.
  • Use Case: A developer wants to create a new skill to integrate Claude with their company's internal CRM. This skill guides them through defining the CRM's API schema in references/ and creating scripts/ for common operations, ensuring the skill is robust and effective.

Quick Start

Choose a descriptive skill name (e.g., "analyze-excel")

SKILL_NAME="my-new-skill"

Create the basic directory structure

mkdir -p skills/$SKILL_NAME/{scripts,references,assets}

Start editing the SKILL.md file

(e.g., nano skills/$SKILL_NAME/SKILL.md)

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 skill to extend Claude's capabilities?

Create a skill by organizing a directory with SKILL.md frontmatter (name, description, allowed-tools), a body explaining the skill's purpose, and bundled resources in scripts/, references/, and assets/ folders. This structure lets Claude understand and execute domain-specific workflows and tool integrations.

What's the correct anatomy and structure for building a skill?

A skill consists of YAML frontmatter defining metadata, a SKILL.md body with progressive disclosure of information, scripts/ for reusable code, references/ for documentation and schemas, and assets/ for supporting files. This layout ensures Claude efficiently consumes and applies the skill.

How do I integrate my company's internal tools or APIs into a Claude skill?

Define your tool's API schema and workflows in the references/ folder, create scripts/ for common operations, and specify allowed-tools in the YAML frontmatter. This guides Claude to interact with your internal systems reliably and securely.

What best practices should I follow when writing skill documentation for AI consumption?

Use imperative, direct language; avoid duplication across components; maintain high metadata quality in frontmatter; apply progressive disclosure to prevent cognitive overload; and organize content so Claude can parse and apply it efficiently without ambiguity.

Can I update an existing skill or do I need to create a new one?

You can both create new skills and update existing ones using the same anatomy and workflow. The skill creation process handles both cases, guiding you through editing SKILL.md, updating references/, modifying scripts/, and iterating based on testing and feedback.