What is a Claude Code Skill?

A specialized capability that enhances Claude's behavior during specific tasks, providing domain-specific guidance, implementation patterns, and tool restrictions.

Where does Claude Code look for skills?

Skills are discovered in the local project's '.claude/skills/' directory, the global '~/.claude/skills/' folder, and within any enabled plugins.

What is progressive disclosure in skill writing?

It is a design pattern used to keep the main SKILL.md file concise (under 500 lines) by moving detailed templates, examples, and troubleshooting guides into separate reference files.

Why should I use the gerund form for skill names?

Using the gerund form, such as 'writing-skills' instead of 'skill-writer', clearly describes the action the skill assists with and follows official naming conventions.

How do I restrict which tools a skill can use?

You can define the 'allowed-tools' field in the YAML frontmatter to explicitly list which tools, such as Read, Write, or Bash, the skill is permitted to invoke.

Skill Authoring Guide

Name: Skill Authoring Guide
Author: hgeldenhuys

byhgeldenhuys

•

開発者ツール

Standardizes the creation and optimization of custom Claude Code skills through structured templates and best practices.

概要

This skill provides comprehensive guidance for developers looking to extend Claude Code's capabilities with custom skills. It enforces best practices such as gerund-based naming conventions, mandatory YAML frontmatter configuration, and progressive disclosure to keep skill files maintainable and performant. By offering predefined workflows and validation checklists, it ensures that every new skill is efficient, well-documented, and properly integrated into the Claude Code ecosystem, whether in local projects or complex monorepos.

主な機能

Progressive disclosure patterns to keep skill files under the 500-line limit
1 GitHub stars
Step-by-step workflow templates with copyable validation checklists
Enforced gerund-based naming conventions for improved skill discovery
Standardized YAML frontmatter configuration for tool and model control
Support for advanced configurations including context forking and lifecycle hooks

ユースケース

Refactoring legacy skill sets to comply with official Claude Code structure
Creating new domain-specific skills for private repositories or monorepos
Validating skill naming and file organization before team-wide deployment

概要

主な機能

Progressive disclosure patterns to keep skill files under the 500-line limit
1 GitHub stars
Step-by-step workflow templates with copyable validation checklists
Enforced gerund-based naming conventions for improved skill discovery
Standardized YAML frontmatter configuration for tool and model control
Support for advanced configurations including context forking and lifecycle hooks

ユースケース

Refactoring legacy skill sets to comply with official Claude Code structure
Creating new domain-specific skills for private repositories or monorepos
Validating skill naming and file organization before team-wide deployment