skills.rest
bloknayrb
bloknayrbCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/bloknayrb/claudestuff --skill skill-creation-bloknayrb
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
czytczyt
6

template-skill

Create new Claude Skills using a foundational template structure.

Community
Basic
kaustubhhiwarekaustubhhiware

skill-development

Guide creation and refinement of Claude Code skills with structure and validation checklists.

Community
Intermediate
ladislasladislas
2

pac-pi-skill

Enforce standardized skill directory structure and SKILL.md frontmatter in repositories.

Community
Intermediate
shinnytechshinnytech

skill-writer

Guide creation and refinement of Agent Skills for Claude Code.

Official
Intermediate