What is a Claude Code Skill?

A Claude Code Skill is a specialized capability defined in a SKILL.md file that provides Claude with domain-specific guidance, best practices, and implementation patterns for specific tasks.

How do I test if my new skill is working?

After creating the SKILL.md file, restart Claude Code and ask a question that matches the keywords in your skill's description to verify automatic activation.

Where should I store my Claude Skills?

Personal skills are stored in ~/.claude/skills/ for individual use, while project skills are placed in .claude/skills/ within a repository for team collaboration.

How does Skill Writer improve skill discovery?

It provides a specific formula for descriptions—combining what the skill does with specific trigger words—to ensure Claude recognizes the correct context to activate the skill.

What are the naming requirements for a new skill?

Skill names must be lowercase, use hyphens instead of spaces, be under 64 characters, and exactly match the name of their containing directory.

Skill Writer

Name: Skill Writer
Author: Cursedpotential

byCursedpotential

0•

Developer Tools

Guides developers through the creation, structuring, and optimization of custom Agent Skills for the Claude Code ecosystem.

Skill Writer is a specialized meta-utility designed to streamline the development of new capabilities within Claude Code. It provides a standardized framework for authoring SKILL.md files, ensuring that YAML frontmatter, naming conventions, and directory structures meet validation requirements. By focusing on discovery optimization, it helps authors write effective descriptions with the right trigger words, enabling Claude to accurately identify and activate the correct skill during user interactions. Whether building personal productivity tools or shared team workflows, this skill ensures every new capability follows best practices for reliability and performance.

Key Features

01Automated SKILL.md boilerplate and structure generation

02YAML frontmatter validation for name and description constraints

03Discovery optimization using 'Use when...' trigger word strategies

04Support for multi-file skills and progressive disclosure patterns

050 GitHub stars

06Comprehensive troubleshooting for skill activation and discovery issues

Use Cases

01Authoring and organizing project-specific skills for team-wide automation

02Debugging and optimizing existing skills that fail to activate correctly

03Converting complex manual workflows or prompts into reusable Claude Skills

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cursedpotential/thebigone skill-writer

For use in Claude.ai and ChatGPT

Download Skill