Where should I store my custom skills?

Personal skills for your individual use should be stored in ~/.claude/skills/, while project-specific skills should be placed in the .claude/skills/ directory of your repository.

Can I restrict which tools a custom skill can use?

Yes, you can use the 'allowed-tools' field in the YAML frontmatter to limit Claude's access to a specific comma-separated list of tools, such as Read, Grep, or Glob.

What is a Claude Code Skill?

A Claude Code Skill is a specialized capability defined in a SKILL.md file that provides domain-specific guidance, best practices, and implementation patterns to enhance Claude's behavior during tasks.

Why isn't Claude picking up my custom skill?

Claude discovers skills via the description field. Ensure your description is specific, includes trigger words, and follows the formula: [What it does] + [When to use it] + [Key triggers].

Skill Writer for Claude Code

Name: Skill Writer for Claude Code
Author: Microck

byMicrock

•

Learning & Documentation

Simplifies the creation of custom Claude Code Agent Skills by providing structured guidance on SKILL.md files, frontmatter validation, and best practices.

Skill Writer is a meta-capability designed to help developers author, design, and validate custom Agent Skills for the Claude Code CLI. It guides you through the entire lifecycle of skill development—from defining focused scopes and choosing directory locations to writing SEO-optimized YAML frontmatter and effective trigger descriptions. By ensuring your custom skills follow established best practices and validation requirements, this tool improves skill discovery and execution reliability, making it an essential utility for anyone looking to extend Claude's capabilities within their local development environment or shared projects.

Key Features

0189 GitHub stars

02Support for both personal and project-specific skill locations

03Automatic validation of skill names, description lengths, and directory structures

04Formula-based approach for writing high-performance skill discovery descriptions

05Template generation for instructions, examples, and progressive disclosure files

06Step-by-step guidance for creating SKILL.md files and YAML frontmatter

Use Cases

01Troubleshooting why an existing custom skill isn't being triggered correctly by Claude

02Converting a complex system prompt into a structured, multi-file Claude Code Skill

03Creating a new custom skill to automate repetitive project-specific coding tasks

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