# How to Use Claude Skills with the Claude Code CLI: A Complete Setup Guide > Master Claude skills and the Claude Code CLI with this setup guide. Discover how to activate specialized capabilities with natural language queries and enhance your coding workflow. - Repository: [Composio/awesome-claude-skills](https://github.com/composiohq/awesome-claude-skills) - Tags: how-to-guide - Published: 2026-07-27 --- **Claude Code CLI automatically discovers and loads skill packages from the `~/.config/claude-code/skills/` directory, activating specialized capabilities only when your natural language queries match a skill's defined purpose.** The Awesome Claude Skills repository from ComposioHQ provides a comprehensive catalog of self-contained skill packages designed to extend the Claude Code CLI. Each skill is a portable folder containing a mandatory [`SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/SKILL.md) file with metadata and step-by-step instructions, plus optional helper scripts and resources that the CLI pulls into context on-demand rather than at startup. ## What Are Claude Skills? A Claude skill is a self-contained package that teaches Claude Code how to perform specific tasks. According to the ComposioHQ/awesome-claude-skills source code, skills reside in individual directories that include structured metadata and executable resources. ### Anatomy of a Skill Package Every skill follows a strict folder structure. The canonical template appears in [`skill-creator/SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/skill-creator/SKILL.md), which demonstrates the required metadata format at the top of the file, followed by detailed instructions. A production-ready example lives in [`slack-gif-creator/SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/slack-gif-creator/SKILL.md), showing how to bundle auxiliary scripts like [`slack-gif-creator/core/gif_builder.py`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/slack-gif-creator/core/gif_builder.py) alongside the metadata. The essential components include: - **SKILL.md**: Mandatory metadata file containing `name` and `description` fields plus step-by-step instructions - **Helper scripts**: Optional resources such as [`gif_builder.py`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/gif_builder.py) that execute specific tasks - **Assets**: Any templates or configuration files referenced by the instructions ## Installing Skills for the Claude Code CLI The Claude Code CLI implements a dynamic loading system that scans your local skills directory at startup, registering metadata immediately while deferring heavy instruction sets until needed. ### The Skills Directory Structure When the CLI launches, it scans `~/.config/claude-code/skills/` to discover available skills. This location follows the XDG Base Directory specification for configuration files. The CLI loads only the metadata initially, pulling the full instruction set from [`SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/SKILL.md) into the model's context only when your query matches the skill's purpose. ### Step-by-Step Installation Process To install a skill from the Awesome Claude Skills repository: 1. Clone the repository or copy a specific skill directory 2. Create the skills configuration directory if it doesn't exist 3. Copy the skill folder to `~/.config/claude-code/skills/` 4. Verify the metadata in [`SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/SKILL.md) ```bash # Clone the entire repository or navigate to a specific skill git clone https://github.com/ComposioHQ/awesome-claude-skills.git cd awesome-claude-skills/slack-gif-creator # Create the skills directory and install the skill mkdir -p ~/.config/claude-code/skills/ cp -r . ~/.config/claude-code/skills/slack-gif-creator # Verify the skill metadata is properly configured head ~/.config/claude-code/skills/slack-gif-creator/SKILL.md ``` ## Using Skills in Claude Code Once installed, skills integrate seamlessly into the Claude Code workflow without requiring explicit activation commands. ### Inspecting Skill Metadata Before running Claude Code, inspect the top of [`SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/SKILL.md) to confirm the `name` and `description` fields accurately reflect the skill's capabilities. This metadata determines when the CLI activates the skill. ```bash # Preview the skill's metadata and instructions head ~/.config/claude-code/skills/slack-gif-creator/SKILL.md ``` ### Invoking Skills Through Natural Language Launch Claude Code normally using the `claude` command. The CLI automatically registers installed skills and monitors your prompts for matches against skill descriptions. When you submit a query, Claude Code: 1. Analyzes your natural language input 2. Matches against installed skill metadata 3. Loads the full [`SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/SKILL.md) and associated scripts on-demand 4. Executes the workflow defined in the skill instructions For example, after installing the `slack-gif-creator` skill: ```markdown User: Create a fun "thumbs-up" GIF for Slack that loops for 3 seconds. Claude Code will: 1. Detect that the Slack GIF Creator skill matches the request 2. Load the full SKILL.md and helper scripts like gif_builder.py 3. Execute the generation workflow 4. Return the completed GIF file ``` This on-demand loading keeps the initial context window light while providing access to complex, multi-step workflows when needed. ## Key Files in the Repository Understanding these specific files helps you navigate the Awesome Claude Skills collection: - **[`README.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/README.md)**: Contains the CLI quick-start guide and explains the overall skill concept for Claude Code integration - **[`skill-creator/SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/skill-creator/SKILL.md)**: Serves as the canonical template showing the metadata structure and instruction format that Claude Code expects - **[`slack-gif-creator/SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/slack-gif-creator/SKILL.md)**: Demonstrates a production-ready skill with complete metadata and references to auxiliary resources - **[`slack-gif-creator/core/gif_builder.py`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/slack-gif-creator/core/gif_builder.py)**: Example auxiliary script showing how custom Python code integrates with skill instructions - **[`skill-creator/scripts/init_skill.py`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/skill-creator/scripts/init_skill.py)**: Utility script for bootstrapping new skills, useful when authoring CLI-compatible packages ## Summary - **Claude Code CLI** discovers skills automatically from `~/.config/claude-code/skills/` at startup - Each skill requires a **[`SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/SKILL.md)** file containing metadata (`name`, `description`) and detailed instructions - Skills load on-demand: metadata registers immediately, but heavy instructions only enter context when queries match - Installation requires only copying skill folders to the configuration directory—no compilation or runtime dependencies - The **`slack-gif-creator`** and **`skill-creator`** directories provide canonical examples of production-ready skill structure ## Frequently Asked Questions ### Where does Claude Code CLI look for skills? Claude Code CLI scans the `~/.config/claude-code/skills/` directory at startup to discover installed skill packages. This follows standard XDG configuration paths, creating a centralized location for managing your skill library. ### What file is required for every Claude skill? Every skill must include a **[`SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/SKILL.md)** file at its root. This file contains mandatory metadata fields including `name` and `description`, plus step-by-step instructions that Claude Code loads when the skill activates. ### Are there dependencies needed to run skills in Claude Code? No. Skills require zero compilation or runtime dependencies because they consist of pure markdown files and optional scripts. The CLI reads [`SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/SKILL.md) directly and executes any referenced helper scripts using your system's existing interpreters. ### How do I create my own skill for Claude Code? Use the **[`skill-creator/scripts/init_skill.py`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/skill-creator/scripts/init_skill.py)** utility to bootstrap new skills, or copy the template from **[`skill-creator/SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/skill-creator/SKILL.md)**. Ensure your directory includes a properly formatted [`SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/SKILL.md) with accurate metadata, then install it to `~/.config/claude-code/skills/` to make it available to the CLI.