$npx -y skills add KimYx0207/findskill --skill windowsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist a
| 1 | # Find Skills (Windows Compatible Version) |
| 2 | |
| 3 | This skill helps you discover and install skills from the open agent skills ecosystem. |
| 4 | |
| 5 | **This is a Windows-compatible fork that fixes the empty output issue in Claude Code on Windows.** |
| 6 | |
| 7 | ## ⚠️ CRITICAL: Windows Compatibility |
| 8 | |
| 9 | **On Windows, you MUST use PowerShell to run skills commands!** |
| 10 | |
| 11 | The default Bash/Git Bash environment on Windows does NOT work with `npx skills` - commands will return empty output. |
| 12 | |
| 13 | **Always use this format on Windows:** |
| 14 | ```bash |
| 15 | powershell -Command "npx skills find '[query]'" |
| 16 | powershell -Command "npx skills add [package] -g -y" |
| 17 | powershell -Command "npx skills list -g" |
| 18 | ``` |
| 19 | |
| 20 | **Example:** |
| 21 | ```bash |
| 22 | # ❌ WRONG - will return empty on Windows |
| 23 | npx skills find "react" |
| 24 | |
| 25 | # ✅ CORRECT - works on Windows |
| 26 | powershell -Command "npx skills find 'react'" |
| 27 | ``` |
| 28 | |
| 29 | ## When to Use This Skill |
| 30 | |
| 31 | Use this skill when the user: |
| 32 | |
| 33 | - Asks "how do I do X" where X might be a common task with an existing skill |
| 34 | - Says "find a skill for X" or "is there a skill for X" |
| 35 | - Asks "can you do X" where X is a specialized capability |
| 36 | - Expresses interest in extending agent capabilities |
| 37 | - Wants to search for tools, templates, or workflows |
| 38 | - Mentions they wish they had help with a specific domain (design, testing, deployment, etc.) |
| 39 | |
| 40 | ## What is the Skills CLI? |
| 41 | |
| 42 | The Skills CLI (`npx skills`) is the package manager for the open agent skills ecosystem. Skills are modular packages that extend agent capabilities with specialized knowledge, workflows, and tools. |
| 43 | |
| 44 | **Key commands (Windows format):** |
| 45 | |
| 46 | - `powershell -Command "npx skills find '[query]'"` - Search for skills |
| 47 | - `powershell -Command "npx skills add [package] -g -y"` - Install a skill |
| 48 | - `powershell -Command "npx skills list -g"` - List installed skills |
| 49 | - `powershell -Command "npx skills check"` - Check for skill updates |
| 50 | - `powershell -Command "npx skills update"` - Update all installed skills |
| 51 | |
| 52 | **Browse skills at:** https://skills.sh/ |
| 53 | |
| 54 | ## How to Help Users Find Skills |
| 55 | |
| 56 | ### Step 1: Understand What They Need |
| 57 | |
| 58 | When a user asks for help with something, identify: |
| 59 | |
| 60 | 1. The domain (e.g., React, testing, design, deployment) |
| 61 | 2. The specific task (e.g., writing tests, creating animations, reviewing PRs) |
| 62 | 3. Whether this is a common enough task that a skill likely exists |
| 63 | |
| 64 | ### Step 2: Search for Skills |
| 65 | |
| 66 | Run the find command with a relevant query. |
| 67 | |
| 68 | **On Windows (REQUIRED):** |
| 69 | ```bash |
| 70 | powershell -Command "npx skills find '[query]'" |
| 71 | ``` |
| 72 | |
| 73 | **On macOS/Linux:** |
| 74 | ```bash |
| 75 | npx skills find [query] |
| 76 | ``` |
| 77 | |
| 78 | For example (Windows format): |
| 79 | |
| 80 | - User asks "how do I make my React app faster?" → `powershell -Command "npx skills find 'react performance'"` |
| 81 | - User asks "can you help me with PR reviews?" → `powershell -Command "npx skills find 'pr review'"` |
| 82 | - User asks "I need to create a changelog" → `powershell -Command "npx skills find 'changelog'"` |
| 83 | - User asks "数据分析" (data analysis in Chinese) → `powershell -Command "npx skills find 'data analysis'"` (Note: Search only supports English keywords!) |
| 84 | |
| 85 | The command will return results like: |
| 86 | |
| 87 | ``` |
| 88 | Install with npx skills add <owner/repo@skill> |
| 89 | |
| 90 | vercel-labs/agent-skills@vercel-react-best-practices |
| 91 | └ https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices |
| 92 | ``` |
| 93 | |
| 94 | ### Step 3: Present Options to the User |
| 95 | |
| 96 | When you find relevant skills, present them to the user with: |
| 97 | |
| 98 | 1. The skill name and what it does |
| 99 | 2. The install command they can run (Windows format!) |
| 100 | 3. A link to learn more at skills.sh |
| 101 | |
| 102 | Example response: |
| 103 | |
| 104 | ``` |
| 105 | I found a skill that might help! The "vercel-react-best-practices" skill provides |
| 106 | React and Next.js performance optimization guidelines from Vercel Engineering. |
| 107 | |
| 108 | To install it (Windows): |
| 109 | powershell -Command "npx skills add vercel-labs/agent-skills@vercel-react-best-practices -g -y" |
| 110 | |
| 111 | Learn more: https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices |
| 112 | ``` |
| 113 | |
| 114 | ### Step 4: Offer to Install |
| 115 | |
| 116 | If the user wants to proceed, you can install the skill for them. |
| 117 | |
| 118 | **On Windows (REQUIRED):** |
| 119 | ```bash |
| 120 | powershell -Command "npx skills add <owner/repo@skill> -g -y" |
| 121 | ``` |
| 122 | |
| 123 | **On macOS/Linux:** |
| 124 | ```bash |
| 125 | npx skills add <owner/repo@skill> -g -y |
| 126 | ``` |
| 127 | |
| 128 | The `-g` flag installs globally (user-level) and `-y` skips confirmation prompts. |
| 129 | |
| 130 | ## Common Skill Categories |
| 131 | |
| 132 | When searching, consider these common categories: |
| 133 | |
| 134 | | Category | Example Queries | |
| 135 | | --------------- | ---------------------------------------- | |
| 136 | | Web Development | react, nextjs, typescript, css, tailwind | |
| 137 | | Testing | testing, jest, playwright, e2e | |
| 138 | | DevOps | deploy, docker, kubernetes, ci-cd | |
| 139 | | Documentation | docs, readme, changelog, api-docs | |
| 140 | | Code Quality | |