Where should I store my custom Claude Skills?

Personal skills for individual workflows should be placed in '~/.claude/skills/', while project-specific skills intended for team sharing should be kept in the '.claude/skills/' directory of your repository.

Why isn't my custom skill activating in Claude Code?

Activation issues are usually caused by vague descriptions. Ensure your SKILL.md frontmatter includes specific trigger words, file extensions, and a clear 'Use when...' clause that describes the intended context.

What is a Claude Code Skill?

A Claude Code Skill is a specialized capability that enhances Claude's behavior for specific tasks by providing domain-specific guidance, best practices, and implementation patterns via a SKILL.md file.

What are the naming requirements for a Claude Skill?

Skill names must use lowercase letters, numbers, and hyphens only, with a maximum of 64 characters. The 'name' field in the YAML frontmatter must exactly match the directory name containing the SKILL.md file.

Claude Skill Author

Name: Claude Skill Author
Author: Microck

byMicrock

•

110

•

学习与文档

Guides developers through the process of designing, writing, and validating custom Agent Skills for Claude Code.

The Claude Skill Author simplifies the creation of specialized capabilities for Claude Code by providing a structured framework for authoring SKILL.md files. It assists users in defining skill scope, choosing the correct storage location (personal vs. project-level), and writing optimized YAML frontmatter for better discovery. By following standardized patterns for instructions and examples, this skill ensures that custom extensions are robust, well-documented, and trigger reliably during development tasks.

主要功能

01Automated SKILL.md template generation with YAML frontmatter validation

02Best practice implementation for tool permissions and trigger words

03Support for both single-file and multi-file progressive disclosure structures

04Guidance on skill discovery optimization through targeted description formulas

05Step-by-step validation checklists for naming and file hierarchy

06110 GitHub stars

使用场景

01Troubleshooting and debugging skill activation and discovery issues

02Converting existing complex prompts or scripts into discoverable agent skills

03Designing a new custom automation for project-specific coding workflows

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add microck/ordinary-claude-skills skill-writer

For use in Claude.ai and ChatGPT

Download Skill