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\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\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$\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.Frequently Asked Questions
Are these prompts free? Yes — all PromptSpace prompts are free to copy and use. Browse our ChatGPT Prompts library for hundreds more.Do these work on the free tier? Most work on free tiers. Complex prompts may perform better on paid versions (ChatGPT Plus, Claude Pro) with larger context windows.
How do I get better AI results? Be specific: include your role, desired format, target audience, and any constraints. More context always improves output.
Can I modify these prompts for my use case? Absolutely — treat every prompt as a starting template. Customize the role, topic, tone, and format to match your needs.
