Where should I store my Claude Skills?

Personal skills should be stored in ~/.claude/skills/ for global use, while project-specific skills should be placed in .claude/skills/ within your repository.

What is the maximum character limit for skill descriptions?

Skill descriptions in the YAML frontmatter must be under 1024 characters to ensure proper indexing and performance within Claude Code.

What is a Claude Code Skill?

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

How do I ensure Claude discovers my custom skill?

Effective discovery relies on a specific description formula: [What it does] + [When to use it] + [Key triggers]. The Skill Writer helps you refine this in your SKILL.md file.

Can I restrict what tools a skill can use?

Yes, using the 'allowed-tools' field in the YAML frontmatter, you can limit Claude to specific operations like Read, Grep, or Glob for security-sensitive workflows.

Claude Skill Writer

Name: Claude Skill Writer
Author: Microck

byMicrock

•

Developer Tools

Guides the authoring and structuring of custom Agent Skills for Claude Code using best practices.

The Claude Skill Writer is a specialized meta-skill designed to help developers create, author, and validate new Agent Skills for the Claude Code CLI. It provides a standardized framework for defining skill scope, setting up proper directory structures, and writing optimized SKILL.md files with valid YAML frontmatter. By following its step-by-step instructions, users can ensure their custom skills are easily discoverable by Claude, follow security protocols through tool restriction, and maintain high performance through progressive disclosure and clear implementation patterns.

Key Features

01Comprehensive validation checklists for directory naming and file structure

02Automated SKILL.md generation with required YAML frontmatter validation

03Optimization strategies for skill descriptions to improve Claude's discovery triggers

0489 GitHub stars

05Guidance for both personal (~/.claude/skills/) and project-specific (.claude/skills/) skill deployment

06Security-focused tool restriction configuration via the allowed-tools field

Use Cases

01Troubleshooting and debugging skills that fail to activate due to frontmatter or pathing errors

02Authoring a new project-specific skill to enforce team coding standards and conventions

03Converting complex, repetitive manual prompts into reusable and discoverable Agent Skills

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