What are the naming rules for Claude Code Skills?

Skill names must be lowercase letters, numbers, or hyphens only, with a maximum of 64 characters, and must exactly match their containing directory name.

What is the difference between personal and project skills?

Personal skills are stored in your home directory for individual use across all projects, while project skills are stored within a specific repository and committed to version control for team use.

How do I ensure Claude discovers my custom skill?

Effective discovery relies on a specific description containing trigger words, file extensions, and a 'Use when...' clause that describes the exact context Claude should activate in.

Can I limit what tools a custom skill can access?

Yes, you can use the 'allowed-tools' field in the YAML frontmatter to restrict the skill to specific operations like Read, Grep, or Glob for better security and focus.

Claude Code Skill Architect

Name: Claude Code Skill Architect
Author: ovachiever

byovachiever

•

Productivity & Workflow

Guides developers through the end-to-end process of designing, writing, and validating custom Agent Skills for Claude Code.

The Skill Architect is a specialized utility designed to streamline the creation of high-quality Agent Skills for the Claude Code ecosystem. It provides a structured framework for defining skill scope, generating valid YAML frontmatter, and optimizing SKILL.md files for maximum discovery. By enforcing naming conventions and best practices for instructions and examples, this skill ensures that your custom extensions are robust, well-documented, and ready to trigger reliably during coding sessions. It is an essential tool for developers looking to standardize project workflows or build personal productivity enhancers within the FactoryAI Droid system.

Key Features

01Step-by-step troubleshooting for skill discovery and activation issues

0224 GitHub stars

03Description optimization using specific trigger-word formulas

04Support for multi-file skills and progressive disclosure patterns

05Automated SKILL.md structure and YAML frontmatter generation

06Validation for naming conventions and character limits

Use Cases

01Converting legacy prompts and complex workflows into validated skill files

02Bootstrapping new project-specific automation tools and conventions

03Standardizing team-wide coding patterns into reusable Agent Skills

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ovachiever/droid-tings skill-writer

For use in Claude.ai and ChatGPT

Download Skill