# Find Docs

> Recupera documentación, referencias de API y ejemplos de código actualizados para cualquier tecnología de desarrollo, usando el CLI de Context7.

Fuente: https://skillsagentes.com/skills/upstash/context7/find-docs
Markdown: https://skillsagentes.com/skills/upstash/context7/find-docs.md

Repositorio: https://github.com/upstash/context7
Autor: upstash
Licencia: MIT
Actualizado: el mes pasado
Coste de contexto: 220 tok instalada, 1.9k tok al activarse, 1.9k tok con todos los archivos del bundle
Bundle: 1 archivo, 7 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add upstash/context7 --skill find-docs --agent claude-code
# Cursor
npx -y skills add upstash/context7 --skill find-docs --agent cursor
# Codex
npx -y skills add upstash/context7 --skill find-docs --agent codex
# Gemini CLI
npx -y skills add upstash/context7 --skill find-docs --agent gemini
# Windsurf
npx -y skills add upstash/context7 --skill find-docs --agent windsurf
# Cline
npx -y skills add upstash/context7 --skill find-docs --agent cline
```

## Qué hace

- Resuelve el nombre de una librería a un ID de Context7 con `ctx7@latest library`, y luego consulta la documentación con `ctx7@latest docs`
- Prioriza coincidencias de nombre, reputación de la fuente y puntuación de benchmark al elegir entre varios resultados
- Soporta IDs específicos de versión en formato /org/project/version

## Cuándo usarla

- Preguntas de sintaxis de API, configuración o migración de versión que mencionan una librería
- Depuración que involucra comportamiento específico de una librería, o instrucciones de instalación de un CLI

## Qué la activa

- "Busca cómo limpiar un useEffect asíncrono en React"
- "¿Cómo defino relaciones uno a muchos con cascade delete en Prisma?"

## Antes de instalar

- Funciona sin autenticación; CONTEXT7_API_KEY o `ctx7 login` dan límites de tasa más altos.
- Necesita en el PATH: npm, npx

## Archivos

- SKILL.md — 7 KB

## SKILL.md

Reproducido tal cual desde upstash/context7 bajo MIT. Esta sección es el documento original y está en inglés.

# Documentation Lookup

Retrieve current documentation and code examples for any library using the Context7 CLI.

Run commands with `npx ctx7@latest` so setup always uses the latest CLI without a global install:

```bash
npx ctx7@latest library <name> "<query>"
npx ctx7@latest docs <libraryId> "<query>"
```

Optionally install globally if you prefer a bare `ctx7` command:

```bash
npm install -g ctx7@latest
```

## Workflow

Two-step process: resolve the library name to an ID, then query docs with that ID.

```bash
# Step 1: Resolve library ID
npx ctx7@latest library <name> "<query>"

# Step 2: Query documentation
npx ctx7@latest docs <libraryId> "<query>"
```

You MUST call `library` first to obtain a valid library ID UNLESS the user explicitly provides a library ID in the format `/org/project` or `/org/project/version`.

IMPORTANT: Do not run these commands more than 3 times per question. If you cannot find what you need after 3 attempts, use the best result you have.

## Step 1: Resolve a Library

Resolves a package/product name to a Context7-compatible library ID and returns matching libraries.

```bash
npx ctx7@latest library React "How to clean up useEffect with async operations"
npx ctx7@latest library "Next.js" "How to set up app router with middleware"
npx ctx7@latest library Prisma "How to define one-to-many relations with cascade delete"
```

Use the official library name with proper punctuation (e.g., "Next.js" not "nextjs", "Customer.io" not "customerio", "Three.js" not "threejs"). If results look wrong, try alternate spellings such as `next.js` before changing the query.

Always pass a `query` argument — it is required and directly affects result ranking. Use the user's intent to form the query, which helps disambiguate when multiple libraries share a similar name. Do not include any sensitive or confidential information such as API keys, passwords, credentials, personal data, or proprietary code in your query.

### Result fields

Each result includes:

- **Library ID** — Context7-compatible identifier (format: `/org/project`)
- **Name** — Library or package name
- **Description** — Short summary
- **Code Snippets** — Number of available code examples
- **Source Reputation** — Authority indicator (High, Medium, Low, or Unknown)
- **Benchmark Score** — Quality indicator (100 is the highest score)
- **Versions** — List of versions if available. Use one of those versions if the user provides a version in their query. The format is `/org/project/version`.

### Selection process

1. Analyze the query to understand what library/package the user is looking for
2. Select the most relevant match based on:
   - Name similarity to the query (exact matches prioritized)
   - Description relevance to the query's intent
   - Documentation coverage (prioritize libraries with higher Code Snippet counts)
   - Source reputation (consider libraries with High or Medium reputation more authoritative)
   - Benchmark score (higher is better, 100 is the maximum)
3. If multiple good matches exist, acknowledge this but proceed with the most relevant one
4. If no good matches exist, clearly state this and suggest query refinements
5. For ambiguous queries, request clarification before proceeding with a best-guess match

### Version-specific IDs

If the user mentions a specific version, use a version-specific library ID:

```bash
# General (latest indexed)
npx ctx7@latest docs /vercel/next.js "How to set up app router"

# Version-specific
npx ctx7@latest docs /vercel/next.js/v14.3.0-canary.87 "How to set up app router"
```

The available versions are listed in the `library` command output. Use the closest match to what the user specified.

## Step 2: Query Documentation

Retrieves up-to-date documentation and code examples for the resolved library.

```bash
npx ctx7@latest docs /facebook/react "How to clean up useEffect with async operations"
npx ctx7@latest docs /vercel/next.js "How to add authentication middleware to app router"
npx ctx7@latest docs /prisma/prisma "How to define one-to-many relations with cascade delete"
```

### Writing good queries

The query directly affects the quality of results. Be specific and include relevant details, but keep each query to one topic — if the question spans multiple distinct concepts, run a separate `docs` command per concept instead of combining them, unless the question is about how the concepts interact. Do not include any sensitive or confidential information such as API keys, passwords, credentials, personal data, or proprietary code in your query.

| Quality | Example |
|---------|---------|
| Good | `"How to set up authentication with JWT in Express.js"` |
| Good | `"React useEffect cleanup function with async operations"` |
| Bad (too vague) | `"auth"` |
| Bad (too vague) | `"hooks"` |
| Bad (too broad) | `"routing and auth and caching in Next.js"` |

Describe what to look up in the library's documentation, rather than the task to complete — vague one-word queries return generic results, and multi-topic queries dilute ranking and return shallow results for each topic.

The output contains two types of content: **code snippets** (titled, with language-tagged blocks) and **info snippets** (prose explanations with breadcrumb context).

## Authentication

Works without authentication. For higher rate limits:

```bash
# Option A: environment variable
export CONTEXT7_API_KEY=your_key

# Option B: OAuth login
npx ctx7@latest login
```

## Error Handling

If a command fails with a quota error ("Monthly quota reached" or "quota exceeded"):
1. Inform the user their Context7 quota is exhausted
2. Suggest they authenticate for higher limits: `npx ctx7@latest login`
3. If they cannot or choose not to authenticate, answer from training knowledge and clearly note it may be outdated

Do not silently fall back to training data — always tell the user why Context7 was not used.

## Common Mistakes

- Library IDs require a `/` prefix — `/facebook/react` not `facebook/react`
- Always run `npx ctx7@latest library` first — `npx ctx7@latest docs react "hooks"` will fail without a valid ID
- Use descriptive queries, not single words — `"React useEffect cleanup function"` not `"hooks"`
- One topic per query — split `"routing and auth and caching"` into a separate `docs` command per concept, unless the question is about how they interact
- Do not include sensitive information (API keys, passwords, credentials) in queries

## Dónde encaja

- Categoría: [Herramientas para desarrolladores](https://skillsagentes.com/categorias/herramientas-desarrollo.md) — Skills que cambian cómo tu agente escribe, revisa y despliega código.
- Creador: [upstash](https://skillsagentes.com/creators/upstash.md) — 15 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Context7 Mcp](https://skillsagentes.com/skills/upstash/context7/context7-mcp.md): Se usa cuando el usuario pregunta sobre librerías, frameworks o referencias de API, o necesita ejemplos de código. Se activa con menciones de React, Vue, Next.js, Prisma, Supabase, etc.
- [Context7 Docs](https://skillsagentes.com/skills/upstash/context7/context7-docs.md): Obtiene documentación y ejemplos de código actualizados para cualquier librería, framework, SDK, CLI o servicio cloud, incluso los conocidos.
- [Context7 Cli](https://skillsagentes.com/skills/upstash/context7/context7-cli.md): Usa el CLI ctx7 para obtener documentación de librerías, gestionar skills de codificación con IA y configurar el MCP de Context7.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)