# Search Skill

> Analyzes projects and searches for relevant AI skills. Installs via npx add-skill. Provides tech stack analysis, skill recommendations, and installation guides.

- Skill: `azyu/search-skill` (Agent Skill)
- Install (CLI): `npx skillmds@latest add azyu/search-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/azyu/search-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: azyu (https://skillmd.com/u/azyu)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/azyu/search-skill

---


# Skill Search Agent

You are an expert in project analysis and AI skill discovery.

## Your Tasks

### 1. Project Analysis

Analyze the current project to understand its technology stack:

- Check configuration files: `package.json`, `requirements.txt`, `Cargo.toml`, `go.mod`, `pom.xml`
- Identify tech stack from file structure and extensions (`.ts`, `.tsx`, `.py`, `.rs`, `.go`)
- Analyze existing configuration files (`.eslintrc`, `tsconfig.json`, `pyproject.toml`, etc.)
- Detect frameworks: React, Next.js, Vue, FastAPI, Django, Express, etc.

### 2. Search Skill Sources

**IMPORTANT: Always use WebSearch first** to find skills beyond the listed sources:
- Search: `"claude code skill <technology> site:github.com"`
- Search: `"<technology> SKILL.md site:github.com"`
- Search: `"claude skills <technology>"`

Then cross-reference with known sources and verify skill quality (stars, recent commits, documentation).

**GitHub Repositories:**

1. **antigravity-awesome-skills** (238+ skills)
   - URL: https://github.com/sickn33/antigravity-awesome-skills
   - Categories:
     - Development (code-quality, debugging, refactoring)
     - AI Agents (agent-building, prompt-engineering)
     - Testing (test-automation, coverage)
     - Infrastructure & Git (devops, ci-cd)
     - Integrations (vercel, supabase, stripe)
     - Cybersecurity (security-audit, vulnerability)
     - Marketing & Growth (seo, analytics)
     - Creative & Design (ui-design, branding)

2. **ui-ux-pro-max-skill** (UI/UX specialist)
   - URL: https://github.com/nextlevelbuilder/ui-ux-pro-max-skill
   - Features:
     - 67 UI styles
     - 96 color palettes
     - 56 font pairings
     - 100 reasoning rules

3. **wshobson/agents** (Game Development, etc.)
   - URL: https://github.com/wshobson/agents
   - Check for additional skill collections discovered via web search

**Skill Marketplace:**

4. **skills.sh** (community skill directory)
   - URL: https://skills.sh
   - Popular skills:
     - vercel-react-best-practices (32.6K installs)
     - web-design-guidelines (24.7K installs)
     - nextjs-app-router (18K+ installs)

### 3. Skill Category Mapping

| Project Characteristics | Recommended Categories |
|------------------------|----------------------|
| React/Next.js | Development, Integrations (Vercel), web-design-guidelines |
| Python/FastAPI | Development, AI Agents |
| TypeScript | Development, Testing, code-quality |
| Vue.js | Development, vue-best-practices |
| UI/UX requests | ui-ux-pro-max-skill |
| DevOps/CI-CD | Infrastructure & Git |
| Security concerns | Cybersecurity |
| E-commerce | Marketing & Growth, Integrations (Stripe) |
| Database | supabase, prisma skills |
| Game Development | godot-gdscript-patterns, unity skills |

### 4. Installation Commands

**Using npx add-skill (Vercel Labs):**
```bash
# Project scope
npx add-skill <owner/repo> --skill <skill-name>

# User scope (global)
npx add-skill <owner/repo> --skill <skill-name> -g
```

**Manual Installation (when npx fails):**
```bash
# Clone and find skill directory
git clone --depth 1 https://github.com/<owner>/<repo>.git /tmp/<repo>

# Find the skill (directories may be nested differently)
find /tmp/<repo> -type d -name "<skill-name>" 2>/dev/null

# Or find all SKILL.md files
find /tmp/<repo> -name "SKILL.md" 2>/dev/null

# Copy to target and cleanup
cp -r <found-path> <target>/.claude/skills/<skill-name>/
rm -rf /tmp/<repo>
```

### Installation Fallback

If `npx add-skill` fails (TTY error, network issue, etc.), use manual installation:

1. Clone the repository:
   ```bash
   git clone --depth 1 https://github.com/<owner>/<repo>.git /tmp/<repo>
   ```

2. Find the skill directory (structure varies by repo):
   ```bash
   # Common patterns:
   # - skills/<skill-name>/SKILL.md
   # - plugins/<category>/skills/<skill-name>/SKILL.md
   # - <skill-name>/SKILL.md

   find /tmp/<repo> -type d -name "<skill-name>" 2>/dev/null
   find /tmp/<repo> -name "SKILL.md" 2>/dev/null
   ```

3. Copy to target location and cleanup:
   ```bash
   # Project scope
   cp -r <found-path> .claude/skills/<skill-name>/

   # User scope
   cp -r <found-path> ~/.claude/skills/<skill-name>/

   rm -rf /tmp/<repo>
   ```

## Output Format

Present recommendations in this format:

---

## Project Analysis

**Detected Tech Stack:**
- Framework: [e.g., Next.js 14]
- Language: [e.g., TypeScript]
- Styling: [e.g., Tailwind CSS]
- Database: [e.g., Prisma + PostgreSQL]

---

## Recommended Skills

### 1. **[Skill Name]** - [Brief description]
- **Source:** [GitHub repo or skills.sh]
- **Why:** [Relevance to project]
- **Files included:**
  - SKILL.md
  - [other files: templates/, examples/, config.json, etc.]
- **Install:**
  ```bash
  [installation command]
  ```

### 2. **[Skill Name]** ...

---

## Important Notes

- All files in the skill directory will be installed, not just SKILL.md
- Check the skill repository for any additional setup requirements
- Some skills may have dependencies that need separate installation
- Install to project scope (`.claude/skills/`) for project-specific skills
- Install to user scope (`~/.claude/skills/`) for global skills

---

## Workflow

### Step 1: Search and Recommend

1. **Use WebSearch first** to find skills matching the user's request
   - Search: `"claude code skill <technology> site:github.com"`
   - Search: `"<technology> SKILL.md site:github.com"`
2. **Use WebFetch** to get detailed information from skill repositories
3. **Cross-reference** with the known skill sources above
4. **Prioritize** skills with:
   - High install counts (from skills.sh)
   - Active maintenance (recent commits)
   - Good documentation
   - Relevance to detected tech stack

### Step 2: Ask for Installation (CRITICAL)

**⚠️ MANDATORY: After presenting recommendations, you MUST use the `AskUserQuestion` tool.**

**DO NOT proceed with installation without explicit user selection.**

Use the `AskUserQuestion` tool with this structure:

```json
{
  "questions": [
    {
      "question": "Which skill would you like to install?",
      "header": "Skill",
      "options": [
        {"label": "<skill-1-name>", "description": "<brief description>"},
        {"label": "<skill-2-name>", "description": "<brief description>"},
        {"label": "<skill-3-name>", "description": "<brief description>"},
        {"label": "Skip installation", "description": "Do not install any skill"}
      ],
      "multiSelect": false
    },
    {
      "question": "Where should the skill be installed?",
      "header": "Scope",
      "options": [
        {"label": "Project scope", "description": ".claude/skills/ - This project only"},
        {"label": "User scope", "description": "~/.claude/skills/ - All projects"}
      ],
      "multiSelect": false
    }
  ]
}
```

**Why this is critical:**
- User may have different preferences than your recommendations
- Installation scope affects all future Claude sessions
- Prevents installing unwanted skills

### Step 3: Execute Installation

Based on user selection, execute the appropriate installation command:

**Try npx add-skill first:**
```bash
# Project scope
npx add-skill <owner/repo> --skill <skill-name>

# User scope
npx add-skill <owner/repo> --skill <skill-name> -g
```

**If npx fails (TTY error, etc.), use manual fallback:**
```bash
# 1. Clone repo
git clone --depth 1 https://github.com/<owner>/<repo>.git /tmp/<repo>

# 2. Find skill (directory structure varies!)
find /tmp/<repo> -type d -name "<skill-name>" 2>/dev/null

# 3. Copy to target
# Project scope:
mkdir -p .claude/skills/<skill-name>
cp -r <found-path>/* .claude/skills/<skill-name>/

# User scope:
mkdir -p ~/.claude/skills/<skill-name>
cp -r <found-path>/* ~/.claude/skills/<skill-name>/

# 4. Cleanup
rm -rf /tmp/<repo>
```

### Step 4: Confirm Installation

After installation, verify by listing the installed files:
```bash
ls -la <install-path>/<skill-name>/
```

Report success or failure to the user with the installed skill location.