Claude Skills Complete Reference

Claude Code skills extend what Claude can do by packaging instructions, scripts, and templates into reusable units. This reference covers everything from creating your first skill to deploying skills across enterprise teams.

Getting Started

Build, test, and ship your first skill with the fundamentals.

• Build Your First Claude Code Skill in 5 Minutes – Create a working SKILL.md from scratch with frontmatter and instructions
• Claude Skills Folder Structure Explained – Directory layout, supporting files, and where skills live
• Every SKILL.md Frontmatter Field Explained – Complete reference for all 14 YAML frontmatter fields
• Claude Skill Naming Conventions – Naming rules, namespaces, and collision avoidance
• Claude Skills Versioning Strategies – Semantic versioning and backward compatibility for skills
• Claude Skills with Embedded Scripts – Bundle Python, Bash, and Node scripts inside skills
• Claude Skills for Git, Docker, and Testing – Practical skills for common development workflows
• Claude Skills vs MCP Servers – When to use each and how they complement each other
• Publishing Claude Skills to GitHub – Share skills via git repositories
• Testing Claude Skills Before Production – Validation, dry runs, and quality checks

Team Collaboration

Share skills across teams without conflicts or breaking workflows.

• How to Share Claude Skills with Your Team – Distribution methods: git, plugins, managed settings
• Managing Claude Skills Across Team Members – Prevent naming conflicts and version drift
• Claude Skills Distribution Methods – Project, personal, enterprise, and plugin scopes
• Claude Skills CI/CD Patterns – Automate skill testing and deployment in pipelines
• Claude Skills Code Review Workflow – Review process for skill changes
• Claude Skills Library Pattern for Organizations – Centralized skill libraries for large teams
• Claude Skills Onboarding for New Developers – Getting new team members productive with skills
• Security Review Process for Claude Skills – Audit skills for safety before deployment
• Team SKILL.md Conventions Style Guide – Consistent skill authoring across a team
• Update Shared Skills Without Breaking Workflows – Safe rollout strategies for skill changes

Troubleshooting

Fix the most common Claude Skills errors.

• Fix Claude Code Skills Not Showing Up – Diagnostic steps when skills do not appear in the menu
• Fix Unknown Skill Error – Resolve “unknown skill” after renaming or moving
• Fix ENOENT No Such File or Directory – Path resolution and missing file errors
• Fix Skill Timeout Errors – Timeout causes and remediation strategies
• Fix Spawn Unknown Error – Script execution failures in skills
• Fix Malformed YAML Frontmatter – Common YAML syntax errors and fixes
• Fix Skill Name Already in Use – Naming conflicts across scopes
• Fix Claude Not Finding Skills Directory – Directory placement and discovery issues
• Fix Skill Infinite Loop – Break recursive skill invocations
• Fix Skill Conflicts with MCP Server – Namespace collisions and resolution

By Industry

Practical skill implementations for specific verticals.

• Claude Skills for E-Commerce – Product catalog, pricing, and inventory automation
• Claude Skills for Financial Analysis – Portfolio analysis, risk assessment, and compliance
• Claude Skills for Legal Document Review – Contract analysis, clause extraction, and due diligence
• Claude Skills for Medical Records – CPT codes, FHIR validation, and clinical notes
• Claude Skills for Academic Research – Literature review, citation, and statistical validation
• Claude Skills for Logistics – HS codes, shipment tracking, and inventory alerts
• Claude Skills for Real Estate – Property data, comps, and listing automation
• Claude Skills for Manufacturing QA – Quality control, defect tracking, and SPC
• Claude Skills for Travel Booking – Itinerary optimization and fare comparison
• Claude Skills for SEO Content – Content optimization and keyword targeting

Architecture & Patterns

Advanced patterns for building complex skill systems.

• How to Combine Multiple Claude Skills – Composition patterns for multi-skill workflows
• Claude Skill Composition Patterns – Chain, fan-out, and pipeline architectures
• Claude Skill Inheritance and Composition – Extend base skills without duplication
• Claude Skills vs Subagents: When to Use Each – Inline vs isolated execution
• Claude Skills Data Flow Patterns – Input/output contracts between skills
• Claude Skills for Monorepo Projects – Nested discovery and team isolation
• Claude Skill Registry Pattern – Centralized skill catalog for large organizations
• Claude Skills Performance Optimization – Reduce token usage and execution time
• Claude Skills Shared Dependencies – Share templates and scripts across skills
• Polyglot Claude Skills – Multi-language skill implementations

Skills vs Alternatives

How Claude Skills compare to other approaches.

• Claude Skills vs ChatGPT Custom GPTs – Feature-by-feature comparison
• Claude Skills vs OpenAI Assistants API – Architecture, cost, and capability comparison
• Claude Skills vs MCP Servers (Detailed) – When structured skills beat server-based tools
• Claude Skills vs Subagents (Detailed) – Inline instructions vs isolated execution
• Claude Skills vs Claude AI Projects – Code skills vs web app projects
• Claude Skills vs LangFlow Agents – Markdown vs visual agent builders
• Claude Skills vs Raw Prompts with Tools – When structured skills beat ad-hoc prompting
• Hybrid Patterns: Skills + MCP + Custom Tools – Combining approaches for maximum coverage
• Claude Memory vs SuperMemory Skill – Built-in vs skill-based memory
• Migrating OpenAI Assistants to Claude Skills – Step-by-step migration guide