skill-creation

Guide creation of Claude Code skills with SKILL.md best practices.

2|Updated Nov 4, 2025

Search Tags:#skill development #best practices #documentation #claude code #meta-skill #progressive disclosure

Ready to run

npx skills add https://github.com/bloknayrb/claudestuff --skill skill-creation-bloknayrb

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-creation
Source: https://github.com/bloknayrb/claudestuff/tree/main/skills/skill-creation
Command: npx skills add https://github.com/bloknayrb/claudestuff --skill skill-creation-bloknayrb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill provides expert guidance and best practices for creating efficient, comprehensive, and well-structured Claude Code skills, ensuring discoverability and maintainability.

Core Features & Use Cases

Progressive Disclosure: Learn how to layer information from metadata to full documentation.
Discoverability: Master naming conventions and description writing for optimal AI invocation.
Organization: Understand the required directory structure and file organization.
Use Case: You are developing a new Claude Skill and need to ensure it's discoverable, well-documented, and adheres to best practices for progressive disclosure. This Skill will guide you through the entire process.

Quick Start

Use the skill-creation skill to learn how to structure your SKILL.md file for optimal discoverability and progressive disclosure.

Frequently Asked Questions about skill-creation

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

FAQPage Schema

How do I structure a Claude Code skill for progressive disclosure?▼

Optimize discoverability by writing clear naming conventions and descriptions in your SKILL.md file, enabling Claude to accurately invoke the skill based on user queries and context.

What should be included in the SKILL.md frontmatter and body?▼

Include concise metadata in SKILL.md frontmatter for AI invocation, followed by a body detailing the problem solved, features, use cases, and quick start instructions for comprehensive documentation.

What are common mistakes when developing Claude skills?▼

Common mistakes include poor content organization, missing validation checklists, inadequate SKILL.md frontmatter, and failing to leverage scripts and references properly within the skill directory structure.

How do I validate a Claude skill before publishing?▼

Validate Claude skills using dedicated checklists to ensure proper directory structure, optimal SKILL.md frontmatter, progressive disclosure, and discoverability before making the skill available.

Does Claude skill development require specific directory components?▼

Claude skill development utilizes a directory structure containing references, scripts, and assets components to organize documentation and supporting files for optimal AI execution.