What are the requirements for the SKILL.md frontmatter?

The name must be lowercase with hyphens only (max 64 chars) and match the directory name. The description must be under 1024 characters and include both what the skill does and when to use it.

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.

Why isn't my skill activating in Claude Code?

Activation issues are usually caused by vague descriptions. Ensure your description includes specific 'Use when...' clauses, file extensions, and trigger words that match user queries.

Where should I store my custom skills?

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

Claude Skill Writer

Name: Claude Skill Writer
Author: Microck

byMicrock

•

开发者工具

Streamline the creation and optimization of Claude Code Agent Skills with structured guidance and validation.

The Claude Skill Writer is a meta-utility designed to help developers author, structure, and validate custom Agent Skills for Claude Code. It provides a standardized framework for creating SKILL.md files, ensuring that YAML frontmatter meets technical requirements and that skill descriptions are optimized for AI discovery. Whether you are building personal productivity tools or team-wide coding conventions, this skill ensures your custom extensions are discoverable, well-documented, and follow the progressive disclosure pattern for complex workflows.

主要功能

01Step-by-step SKILL.md authoring and YAML frontmatter generation

02Discovery optimization using trigger-heavy description formulas

03Templates for multi-file skills and progressive disclosure patterns

04Troubleshooting guides for skill activation and tool permission issues

0581 GitHub stars

06Validation for naming conventions and directory structure requirements

使用场景

01Refining and debugging existing skills that fail to activate during relevant queries

02Converting repetitive prompt workflows into persistent, discoverable Agent Skills

03Developing custom project-specific skills to enforce team coding standards

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