Where should I store my custom skills?

Use ~/.claude/skills/ for personal productivity tools or .claude/skills/ within a project directory to share workflows with your team via version control.

Why isn't Claude triggering my custom skill?

The most common causes are invalid YAML frontmatter in the SKILL.md file or a description that lacks specific trigger words and file extensions.

Can a skill use multiple files?

Yes, while SKILL.md is the entry point, you can include supporting files like reference.md for documentation or scripts/ directories for executable helper utilities.

What is a Claude Code Skill?

A Claude Code Skill is a specialized capability or instruction set that enhances Claude's behavior for specific domain tasks like data analysis, API design, or code review.

Claude Skill Architect

Name: Claude Skill Architect
Author: Microck

byMicrock

•

Productividad y Flujo de Trabajo

Guides the creation and validation of custom Agent Skills for Claude Code using structured templates and best practices.

The Claude Skill Architect is a specialized utility designed to streamline the development of Agent Skills, the modular capabilities that enhance Claude's task performance. It guides users through the entire lifecycle of skill creation—from defining scope and choosing between personal or project-level directories to writing valid YAML frontmatter and optimizing descriptions for better discovery. By enforcing naming conventions and providing structured templates for SKILL.md files, this tool ensures your custom workflows are consistently recognized and correctly executed by Claude Code, making it easier to convert complex prompts into reusable automated capabilities.

Características Principales

01Optimization strategies for skill descriptions to improve Claude's trigger accuracy

02Support for both personal and project-specific workflow implementations

03Templates for multi-file skills including reference documents and helper scripts

0481 GitHub stars

05Step-by-step guidance for creating valid SKILL.md files and directory structures

06Automated validation for YAML frontmatter fields and naming conventions

Casos de Uso

01Standardizing team-wide engineering conventions through shared project-level skills

02Converting long, repetitive system prompts into structured, reusable Agent Skills

03Troubleshooting and debugging skill discovery issues within the Claude Code environment

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