Scan project → extract tech stack → search skills.sh → user selects installation method and skills → install.
Flow
Step 1: Scan the project, extract tech stack keywords
Read the config files in the project root directory:
| File | Extraction method |
|---|---|
package.json |
keys of dependencies + devDependencies |
next.config.* |
→ nextjs |
nuxt.config.* |
→ nuxt |
vite.config.* |
→ vite |
tailwind.config.* or CSS contains @import "tailwindcss" |
→ tailwind |
components.json |
→ shadcn |
pyproject.toml / requirements.txt |
extract dependency names |
Cargo.toml |
→ rust + dependencies |
go.mod |
→ go + module keywords |
Dockerfile / docker-compose.yml |
→ docker |
supabase/ directory |
→ supabase |
.github/workflows/ |
→ github-actions |
Normalization:react-dom → react,@next/font → nextjs,tailwindcss → tailwind。
Keep only framework-level keywords (react, nextjs, vue, svelte, tailwind, supabase, prisma, drizzle, fastapi, django, etc.), filter out utility libraries (lodash, axios, etc.).
Step 2: Search skills.sh
Check whether find-skillsis already installed (check ~/.kiro/skills/find-skills/、~/.claude/skills/find-skills/、.kiro/skills/find-skills/)。
- Installed → search and quality-filter following the find-skills flow
- Not installed → search directly with
npx skills find <keyword>Search
Search for each keyword, merge and deduplicate, filter out those with fewer than 5K installs, skip already installed skills.
Step 3: Ask about installation preferences
Before letting the user choose skills, confirm two questions in order:Installation method and Target client。
3a: Installation method
In Claude Code, use AskUserQuestion:
AskUserQuestion:
question: "选择安装方式:"
options:
- "全局 + symlink(推荐,所有项目共享,自动更新)(Recommended)"
- "全局 + copy(所有项目共享,独立副本)"
- "项目级 + symlink(仅当前项目,团队可共享)"
- "项目级 + copy(仅当前项目,适合提交到仓库)"
In other agents, fall back to text:
📋 安装方式:
[1] 全局 + symlink(推荐) [2] 全局 + copy
[3] 项目级 + symlink [4] 项目级 + copy
👉 输入编号(默认 1):
Corresponding flags:
| Choice | flags |
|---|---|
| Global + symlink | -g -y |
| Global + copy | -g -y --copy |
| Project-level + symlink | -y |
| Project-level + copy | -y --copy |
3b: Target client
In Claude Code, use AskUserQuestion (multiSelect: true):
AskUserQuestion:
question: "安装到哪些客户端?"
multiSelect: true
options:
- "所有已检测到的客户端(推荐)(Recommended)"
- "Claude Code"
- "Kiro CLI"
- "Cursor"
- "Codex"
- "Windsurf"
- "GitHub Copilot"
In other agents, fall back to text:
🖥️ 安装到哪些客户端?
[1] 所有已检测到的(推荐)
[2] 指定客户端(输入名称,逗号分隔,如:claude-code,kiro-cli,cursor)
👉 输入编号(默认 1):
Corresponding flags:
- Select "all" → do not add
-a(installs to all detected by default) - Select specific clients → add
-a claude-code -a kiro-cli, etc.
Remember the flags the user selected; use them consistently for all subsequent install commands.
Step 4: User selects Skills
Output a tech stack summary, let the user choose which skills to install.
In Claude Code: use AskUserQuestion, set multiSelect: true. Mark recommended items with (Recommended) and place them at the front of the options list. Example:
AskUserQuestion:
question: "检测到技术栈:React, Next.js, Tailwind, Supabase。以下是推荐的 skills(已过滤已安装和低质量),请选择要安装的:"
multiSelect: true
options:
- "vercel-react-best-practices (332K installs) — React/Next.js 最佳实践 (Recommended)"
- "web-design-guidelines (265K installs) — Web 设计规范 (Recommended)"
- "frontend-design (315K installs) — 前端设计"
- "supabase-postgres-best-practices (109K installs) — Supabase 最佳实践 (Recommended)"
- "shadcn (96K installs) — shadcn/ui 组件"
- "next-best-practices (68K installs) — Next.js 进阶"
In other agents, fall back to numbered text:
🔍 检测到技术栈:React, Next.js, Tailwind, Supabase
📦 推荐 Skills:
[1] ✅ vercel-react-best-practices 332K installs (react, nextjs)
[2] ✅ web-design-guidelines 265K installs (前端通用)
[3] frontend-design 315K installs (前端通用)
[4] ✅ supabase-postgres-best-practices 109K installs (supabase)
[5] shadcn 96K installs (shadcn)
[6] next-best-practices 68K installs (nextjs)
✅ = 推荐
👉 请选择:all / 1,3,5 / recommended / 不装了
Step 5: Install
Based on the skills the user selected and the installation preferences from Step 3, execute one by one:
npx skills add <owner/repo@skill-name> <flags>
After each install, output the result (success/failure).
Step 6: Completion summary
✅ 安装完成!共安装 N 个 skills(全局 + symlink):
- vercel-react-best-practices
- shadcn
- supabase-postgres-best-practices
💡 这些 skills 会在后续对话中自动生效。
Rules
- Must wait for the user to choose before installing — do not install automatically
- Installation preferences come before skill selection — first ask how to install, then ask what to install
- Prefer native interaction — Use AskUserQuestion with Claude Code, others fall back to text
- Rely on find-skills for searching(if installed)
- Keywords must be precise — use framework names, not generic terms
- Better to have nothing than something inferior — if no high-quality results can be found, don't list them