Setting up SKILL.md skills on Windows works differently than on macOS or Linux, and understanding these differences is key to a smooth Claude Code experience. Windows uses unique file paths and commands, plus it has some quirks that can cause confusion if you're coming from other operating systems. This comprehensive guide dives into where Claude Code stores skills on Windows, how to set them up properly, and how to troubleshoot common issues, including a section on using WSL (Windows Subsystem for Linux) for those who prefer a Linux-like environment.

Where Are Claude Code Skills Stored on Windows?

On Windows, Claude Code stores your SKILL.md files in a hidden directory located inside your user profile folder. The exact path is `C:\Users\\.claude\skills\`. Each skill should be placed in its own subfolder within this directory. For example, if you have a skill named "code-reviewer," it should reside at `C:\Users\\.claude\skills\code-reviewer\SKILL.md`. This setup allows Claude Code to organize and load your skills cleanly every time you launch the application. If you haven’t run Claude Code on your Windows machine yet, you might not see the `.claude` folder because it’s created automatically on first launch. To get started, open Claude Code once, then check your user profile folder for the new `.claude\skills` directory.

How to Find the Skills Folder Quickly

Using File Explorer to navigate to hidden folders can be tedious, especially since `.claude` is a hidden directory. Here are two practical ways to open your skills folder quickly: 1. Using File Explorer: Open File Explorer, then type `%USERPROFILE%\.claude\skills` in the address bar and press Enter. This will take you directly to the skills folder if it exists. 2. Using Command Line: Open PowerShell or Command Prompt and run the command `explorer %USERPROFILE%\.claude\skills`. This command launches File Explorer pointing to the skills directory.

Step-by-Step Setup Guide for Adding a New Skill

To add a new SKILL.md skill to Claude Code on Windows, follow these numbered steps: 1. Open the skills folder: Navigate to `C:\Users\\.claude\skills\` using one of the methods above. 2. Create a new folder: Inside the skills directory, create a new folder named after your skill. For example, `my-new-skill`. 3. Add your SKILL.md file: Place your `SKILL.md` file inside this new folder. Ensure the file is named exactly `SKILL.md` with the correct casing to avoid loading issues. 4. Restart Claude Code: Close and reopen Claude Code to allow it to load the new skill automatically. 5. Verify skill loading: You can test if your skill is active by running a prompt or command that uses the skill’s functionality.

Using WSL (Windows Subsystem for Linux) with Claude Code Skills

If you prefer a Linux-like environment on Windows, WSL is a great option. When running Claude Code inside WSL, the skills folder path changes to the Linux-style home directory: `~/.claude/skills/`. Here’s how to manage skills in WSL: 1. Open your WSL terminal: Launch your preferred WSL distro, such as Ubuntu. 2. Navigate to the skills folder: Run `cd ~/.claude/skills` to go to the skills directory inside your WSL environment. 3. Add or modify skills: Create subfolders and add `SKILL.md` files just like on Windows. 4. File access tip: To access these skills from Windows, you can find your WSL filesystem at `\wsl$\\home\\.claude\skills`. This allows you to edit skills using Windows tools if preferred.

Common Issues and Troubleshooting on Windows

Despite its straightforward setup, some users encounter issues when managing SKILL.md skills on Windows. Here are common problems and how to solve them: - Skills folder not found: If the `.claude` folder is missing, ensure you have launched Claude Code at least once. Also, check that hidden files and folders are visible in File Explorer (View > Hidden Items). - Skill not loading: Confirm your skill folder and `SKILL.md` file are named correctly and placed directly inside the skills folder. Misplaced files or typos can prevent loading. - Permission errors: Windows permissions may restrict Claude Code from reading the skills folder. Right-click the `.claude` folder, select Properties > Security, and ensure your user account has read/write permissions. - Antivirus blocking: Some antivirus programs mistakenly quarantine or block files in hidden directories. Temporarily disable antivirus or whitelist the `.claude` folder if you suspect this issue. - Path length issues: Windows has a maximum path length limitation. Keep folder and file names concise to avoid problems.

Tips for Managing Multiple Skills

Organizing your skills efficiently can save time and prevent confusion. Here are some tips: - Use descriptive folder names: Choose clear, concise names for skill folders that reflect their purpose. - Document your skills: Inside each skill folder, consider adding a README file explaining what the skill does and how to use it. - Back up your skills: Regularly back up the `.claude\skills` folder to avoid losing custom skills due to accidental deletion or system issues. - Version control: For advanced users, manage your skills folder with Git to track changes and collaborate on skill development.

Real-World Use Cases for Custom Skills on Windows

Windows users often leverage custom SKILL.md skills to enhance Claude Code’s capabilities in various scenarios: - Code Review Automation: Developers create a `code-reviewer` skill that analyzes pull requests, highlights potential issues, and suggests improvements directly within Claude Code. - Documentation Generation: Technical writers use a `doc-generator` skill to convert code comments and markdown files into polished documentation. - Data Analysis Assistants: Data scientists build skills that help interpret complex datasets, generate visualizations, and explain statistical results. - Customer Support Bots: Support teams create skills to automate responses based on common inquiries, improving efficiency without leaving Windows.

Final Thoughts

Setting up and managing Claude Code skills on Windows doesn’t have to be complicated. Knowing exactly where your skills are stored and how to organize them ensures a smooth workflow. Whether you’re using native Windows tools or WSL, following this guide will help you customize Claude Code effectively with your own SKILL.md files. Remember to troubleshoot common issues with the tips provided and consider version control for more advanced management. By mastering your skills folder, you unlock the full potential of Claude Code on your Windows machine.