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.

主要功能

01Progressive disclosure patterns to keep skill files under the 500-line limit

021 GitHub stars

03Step-by-step workflow templates with copyable validation checklists

04Enforced gerund-based naming conventions for improved skill discovery

05Standardized YAML frontmatter configuration for tool and model control

06Support for advanced configurations including context forking and lifecycle hooks

使用场景

01Refactoring legacy skill sets to comply with official Claude Code structure

02Creating new domain-specific skills for private repositories or monorepos

03Validating skill naming and file organization before team-wide deployment

主要功能

01Progressive disclosure patterns to keep skill files under the 500-line limit

021 GitHub stars

03Step-by-step workflow templates with copyable validation checklists

04Enforced gerund-based naming conventions for improved skill discovery

05Standardized YAML frontmatter configuration for tool and model control

06Support for advanced configurations including context forking and lifecycle hooks

使用场景

01Refactoring legacy skill sets to comply with official Claude Code structure

02Creating new domain-specific skills for private repositories or monorepos

03Validating skill naming and file organization before team-wide deployment