Where should I store my personal Claude Code skills?

Personal skills should be stored in the ~/.claude/skills/ directory, while project-specific skills reside in the .claude/skills/ directory of your project.

When should I use an MCP server instead of a Skill?

Use an MCP server when you need to provide actual tool capabilities or external data connections. Use a Skill to teach Claude the specific patterns or knowledge on how to use those tools.

What is the main difference between a Skill and a Slash Command?

Skills are discovered and applied automatically by Claude based on the conversation context, whereas Slash Commands require explicit manual invocation by the user.

How do I troubleshoot a Skill that is not triggering correctly?

Verify that your SKILL.md description includes clear trigger phrases, ensure the directory structure is correct, and run Claude with the --debug flag to inspect loading errors.

Claude Code Extension Reference

Name: Claude Code Extension Reference
Author: hgeldenhuys

byhgeldenhuys

•

学習とドキュメンテーション

Provides authoritative architectural guidance and implementation patterns for building Claude Code extensions, hooks, and MCP servers.

This skill acts as a comprehensive internal encyclopedia for developers looking to extend Claude Code's core capabilities. It provides clear disambiguation between different extension types, helping you choose between Skills for automated discovery, Slash Commands for manual triggers, Hooks for event-driven automation, and MCP servers for external tool integration. By centralizing best practices, file structures, and troubleshooting steps, this skill ensures that developers follow standardized patterns when building customized AI workflows and toolsets.

主な機能

01Comprehensive troubleshooting for extension loading and triggers

021 GitHub stars

03Detailed implementation patterns and directory structure guides

04MCP server integration and tool naming conventions

05Extension type disambiguation for Skills, Commands, Hooks, and MCP

06Event-driven hook configuration and lifecycle management

ユースケース

01Implementing Model Context Protocol (MCP) servers for external API access

02Deciding the optimal architecture for a new Claude Code extension

03Configuring project-specific hooks for automated code validation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add hgeldenhuys/claude-code-sdk claude-code-reference

For use in Claude.ai and ChatGPT

Download Skill