---
name: valtterimelkko/context7-search
source: https://app.decimal.ai/s/valtterimelkko-context7-search@1/SKILL.md
source_sha256: c33a117fbcfc
---

# Search for Libraries in Context7

Search for libraries in the Context7 documentation database. This helps identify the correct `owner/repo` format needed for fetching documentation.

## When to Use

Use this skill when:
- User mentions a library by informal name (e.g., "next", "prisma", "mongo")
- You need to discover the exact library identifier
- User wants to compare multiple related libraries
- Library name is ambiguous or has multiple versions

**Skip this skill** when you already know the exact library (e.g., `vercel/next.js`). Use `context7-docs` directly instead.

## Prerequisites

Make `CONTEXT7_API_KEY` available either in the current environment or in a shell startup file such as `~/.bashrc`. The bundled scripts can read either form.

## How to Execute

### Basic Library Search

```bash
python3 ./scripts/resolve_library.py --query "LIBRARY_NAME"
```

### Limit Results

```bash
python3 ./scripts/resolve_library.py --query "LIBRARY_NAME" --limit 5
```

## Parameters

| Parameter | Required | Default | Description |
|-----------|----------|---------|-------------|
| `--query` | Yes | - | Library name to search (fuzzy matching) |
| `--limit` | No | 10 | Maximum number of results |

## Example Queries

```bash
# Search for Next.js
python3 ./scripts/resolve_library.py --query "next.js"

# Search for Prisma
python3 ./scripts/resolve_library.py --query "prisma" --limit 5

# Search for MongoDB driver
python3 ./scripts/resolve_library.py --query "mongodb"
```

## Response Format

```json
{
  "success": true,
  "data": {
    "query": "next.js",
    "count": 3,
    "matches": [
      {
        "id": "/vercel/next.js",
        "title": "Next.js",
        "description": "React framework for full-stack web applications",
        "stars": 131745,
        "trustScore": 10,
        "versions": ["v15.1.8", "v14.3.0", "v13.5.11"]
      }
    ]
  }
}
```

## Selecting the Best Match

After getting results, select the best library based on:

1. **Trust score** - Higher is better (0-10 scale)
2. **Stars** - More stars indicates popularity
3. **Description relevance** - Match to user's specific needs
4. **VIP status** - VIP libraries are official/verified

## Common Library IDs

For frequently used libraries, you can skip search and use directly:

| Library | ID |
|---------|-------------|
| Next.js | `vercel/next.js` |
| React | `facebook/react` |
| Prisma | `prisma/prisma` |
| Supabase | `supabase/supabase` |
| FastAPI | `fastapi/fastapi` |
| Express | `expressjs/express` |
| Django | `django/django` |

## Workflow

```
1. User asks about a library (e.g., "How do I use Prisma?")
     |
2. Run context7-search to find library ID
     |
3. Select best match from results (e.g., prisma/prisma)
     |
4. Use context7-docs skill with the library ID
```

## Error Handling

**No matches found:**
- Try simpler search term (e.g., "next" instead of "next.js framework")
- Try the library's official name
- Check spelling

**API error:**
- Verify the API key is available in your environment or shell startup file
- Check network connectivity