What are the core requirements for a valid Skill file?

A valid skill requires a directory containing a SKILL.md file with YAML frontmatter. The frontmatter must include a 'name' (lowercase/hyphens) and a 'description' under 1024 characters.

Where should I store my new Claude Code Skills?

You can store them in ~/.claude/skills/ for personal use across your system, or in a specific project's .claude/skills/ directory for team-wide sharing.

What is the main purpose of the Skill Writer?

It provides a structured guide to help users author, structure, and validate custom Agent Skills for use within the Claude Code environment.

How does Claude discover my custom skill?

Claude discovers skills based on the 'description' field in the SKILL.md frontmatter. This tool helps you write effective, keyword-rich descriptions to ensure the agent activates the skill when needed.

Skill Writer for Claude Code

Name: Skill Writer for Claude Code
Author: Activer007

byActiver007

0•

Developer Tools

Guides developers in designing, authoring, and validating high-quality Agent Skills for the Claude Code environment.

Skill Writer serves as a comprehensive framework for creating specialized Agent Skills, ensuring they follow strict validation rules and architectural best practices. It assists users in defining clear skill scopes, choosing appropriate storage locations (personal vs. project), and structuring multi-file skills with progressive disclosure. By providing step-by-step guidance on YAML frontmatter, description optimization, and troubleshooting, this tool ensures your custom capabilities are correctly discovered and executed by Claude.

Key Features

01YAML frontmatter validation and naming rules enforcement

02Multi-file skill structure and directory design

03Validation checklists for skill quality assurance

04Standardized SKILL.md template generation

05Trigger word and description optimization for discovery

060 GitHub stars

Use Cases

01Converting existing prompt engineering patterns into reusable skills

02Designing new project-specific skills for automated team workflows

03Debugging and fixing activation issues for custom local skills

What are Skills?·How to Install

Install with 🐟 Skill.Fish

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

For use in Claude.ai and ChatGPT

Download Skill