> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Habilidades

> Instala y gestiona habilidades de Olostep en tus agentes de codificación AI

Instala carpetas de habilidades de Olostep directamente en tus agentes de codificación AI desde la línea de comandos.

* Las habilidades se colocan en una tienda canónica (`~/.agents/skills`) y se enlazan simbólicamente o se copian en el directorio de habilidades de cada agente
* Rastrea todas las instalaciones en un archivo de bloqueo en `~/.agents/.skill-lock.json`
* Funciona con Cursor, Claude, Codex, Windsurf, Continue, y más

Esta función está disponible a través del [CLI de Olostep](/sdks/cli).

## Las habilidades

`olostep add skills` instala las 13. Cada una es un `SKILL.md` que tu agente lee para saber **qué** puede hacer Olostep y **cuándo** usarlo.

Las habilidades se emparejan con el [servidor MCP](/integrations/mcp-server): el servidor MCP proporciona al agente las *herramientas* en vivo, las habilidades le dan el *conocimiento* de cuándo y cómo usarlas.

### Configuración

Comienza aquí — enseña al agente cómo configurar el servidor MCP de Olostep.

| Habilidad | Qué hace                                                                            |
| --------- | ----------------------------------------------------------------------------------- |
| `setup`   | Configura el servidor MCP de Olostep para que todas las demás habilidades funcionen |

### Datos web principales

Las capacidades principales de Olostep — usa estas para darle acceso web en vivo a tu agente.

| Habilidad        | Qué hace                                                                          |
| ---------------- | --------------------------------------------------------------------------------- |
| `scrape`         | Convierte una URL en markdown / HTML / JSON / texto limpio                        |
| `search`         | Búsqueda web en vivo — resultados, respuestas y descubrimiento de URL en el sitio |
| `answers`        | Respuestas estructuradas y citadas de datos web en vivo                           |
| `crawl`          | Rastrear autónomamente un sitio completo                                          |
| `map`            | Descubrir cada URL en un sitio                                                    |
| `batch`          | Rastrear hasta 10,000 URLs en paralelo                                            |
| `extract-schema` | Rastrear una página en JSON estructurado que coincide con un esquema              |

### Construir e integrar

Para agentes que ayudan a los desarrolladores a agregar Olostep a una base de código o mantenerse al día con los cambios de API.

| Habilidad      | Qué hace                                                                   |
| -------------- | -------------------------------------------------------------------------- |
| `integrate`    | Instalar automáticamente el SDK de Olostep en un proyecto                  |
| `docs-to-code` | Rastrear documentación de API y escribir código funcional a partir de ella |
| `migrate-code` | Leer una guía de migración y actualizar el código local                    |

### Investigación y depuración

Para agentes que realizan investigaciones, toman decisiones o depuran errores de código.

| Habilidad     | Qué hace                                                          |
| ------------- | ----------------------------------------------------------------- |
| `research`    | Investigación web comparativa y citada para una decisión          |
| `debug-error` | Buscar un mensaje de error en GitHub / SO / documentación en vivo |

### Categorías

Cada habilidad pertenece a una de tres categorías, que se asignan a la bandera `--category`:

* **`usage`** — usa las características de Olostep: `scrape`, `search`, `answers`, `crawl`, `map`, `batch`, `extract-schema`.
* **`build`** — instala e integra Olostep en una base de código: `setup` (configura el servidor MCP) e `integrate` (agrega el SDK de Olostep a un proyecto).
* **`workflow`** — produce un entregable con Olostep: `research`, `docs-to-code`, `migrate-code`, `debug-error`.

Instala solo una categoría:

```bash theme={null}
olostep add skills --category usage      # habilidades de datos web principales
olostep add skills --category build      # habilidades de configuración + integración
olostep add skills --category workflow   # habilidades de investigación + entregables
```

### Copias alojadas

Cada habilidad instalada también hace referencia a su copia alojada en `https://www.olostep.com/skills/<name>/SKILL.md` — un agente con acceso web puede obtener la última versión (que puede incluir capacidades añadidas desde la instalación) y, de lo contrario, recurre a la copia local. Navega por todas las habilidades alojadas en [olostep.com/skills](https://www.olostep.com/skills/index.md).

## Instalación

```bash theme={null}
npm install -g olostep-cli

# Instala las 13 habilidades en cada agente detectado
olostep add skills

# O usa el subcomando de habilidades (alias)
olostep skills install
```

O sin instalar el CLI:

```bash theme={null}
npx -y olostep-cli@latest add skills
```

## Uso común

```bash theme={null}
# Instalar todas las habilidades
olostep skills install

# Refrescar / actualizar a la última versión
olostep skills update

# Ver qué está instalado y dónde
olostep skills list

# Eliminar todas las habilidades
olostep skills uninstall
```

Filtra lo que se instala:

```bash theme={null}
# Solo habilidades de datos web principales
olostep add skills --category usage

# Solo habilidades de configuración + integración
olostep add skills --category build

# Selección específica
olostep add skills --skill scrape --skill search --skill setup

# Solo agentes específicos
olostep add skills --agent cursor --agent claude

# Salida legible por máquina
olostep add skills --json
```

## Referencia de opciones

| Opción                              | Predeterminado               | Descripción                                                                  |
| ----------------------------------- | ---------------------------- | ---------------------------------------------------------------------------- |
| `--login`                           | —                            | Ejecutar inicio de sesión en el navegador antes de instalar                  |
| `--source <path>`                   | Habilidades incluidas en CLI | Directorio fuente de habilidades                                             |
| `--cli-local-dir <path>`            | CLI/skills                   | Directorio donde las habilidades fuente se sincronizan para uso local de CLI |
| `--agent <name>`                    | —                            | Apuntar a un agente específico — repetible                                   |
| `--all-agents` / `--no-all-agents`  | `--all-agents`               | Apuntar a todos los agentes detectados                                       |
| `--global` / `--no-global`          | `--global`                   | Instalar en directorios de habilidades de agente global                      |
| `--canonical-dir <path>`            | `~/.agents/skills`           | Ubicación de almacenamiento canónica                                         |
| `--agent-skills-dir <path>`         | —                            | Directorio de destino personalizado (requiere `--no-global`)                 |
| `--skill <name>`                    | —                            | Incluir solo esta habilidad — repetible                                      |
| `--exclude <name>`                  | —                            | Excluir esta habilidad — repetible                                           |
| `--category`                        | —                            | `usage`, `build`, o `workflow`                                               |
| `--overwrite` / `--no-overwrite`    | `--overwrite`                | Reemplazar instalaciones existentes                                          |
| `--link-mode <auto\|symlink\|copy>` | `auto`                       | `auto` intenta primero el enlace simbólico, recurre a copiar                 |
| `--json`                            | —                            | Salida JSON legible por máquina                                              |

<Note>
  **Reglas de validación:**

  * `--link-mode` debe ser `auto`, `symlink`, o `copy`
  * `--agent-skills-dir` requiere `--no-global`
  * `--no-global` requiere `--agent-skills-dir`
  * Nombres de agentes desconocidos generarán error
  * Una selección de habilidades vacía después de `--skill` / `--exclude` generará error
</Note>

### Forma de salida JSON

Cuando se pasa `--json`, la salida se ve así:

```json theme={null}
{
  "sync": {
    "plugin_source_dir": "/path/to/CLI/skills",
    "cli_local_dir": "/path/to/CLI/skills"
  },
  "selected_skills": ["scrape", "search"],
  "canonical_dir": "~/.agents/skills",
  "lockfile_path": "~/.agents/.skill-lock.json",
  "installed": [
    {
      "skill": "scrape",
      "canonical_path": "~/.agents/skills/olostep-scrape",
      "targets": [
        { "agent": "cursor", "mode": "symlink", "path": "~/.cursor/skills/olostep-scrape" },
        { "agent": "claude", "mode": "symlink", "path": "~/.claude/skills/olostep-scrape" }
      ]
    }
  ]
}
```

## Agentes compatibles

| Agente   | Clave      |
| -------- | ---------- |
| Cursor   | `cursor`   |
| Claude   | `claude`   |
| Codex    | `codex`    |
| Windsurf | `windsurf` |
| Continue | `continue` |
| Augment  | `augment`  |
| Roo      | `roo`      |
| Gemini   | `gemini`   |
| Copilot  | `copilot`  |
| Factory  | `factory`  |

Usa `--all-agents` (el predeterminado) para apuntar a todos los agentes detectados, o `--agent <key>` para específicos.

## `olostep list skills`

Ve qué habilidades están instaladas y en qué agentes — sin tener que buscar en los archivos.

```bash theme={null}
olostep list skills            # resumen legible por humanos
olostep list skills --json     # legible por máquina
```

## `olostep remove skills`

Elimina carpetas de habilidades instaladas por Olostep de la tienda canónica y directorios de habilidades de agentes, y limpia el archivo de bloqueo.

```bash theme={null}
# Eliminar todas las habilidades de Olostep de todos los agentes
olostep remove skills

# Eliminar una habilidad específica
olostep remove skills --skill research

# Eliminar solo de un agente específico
olostep remove skills --agent cursor

# Salida JSON legible por máquina
olostep remove skills --json
```

| Opción                             | Predeterminado     | Descripción                                                         |
| ---------------------------------- | ------------------ | ------------------------------------------------------------------- |
| `--agent <name>`                   | —                  | Eliminar solo de los agentes especificados — repetible              |
| `--all-agents` / `--no-all-agents` | `--all-agents`     | Apuntar a todos los agentes detectados                              |
| `--canonical-dir <path>`           | `~/.agents/skills` | Directorio canónico de habilidades para eliminar                    |
| `--agent-skills-dir <path>`        | —                  | Directorio de habilidades de destino personalizado para eliminación |
| `--skill <name>`                   | —                  | Eliminar solo habilidades coincidentes — repetible                  |
| `--json`                           | —                  | Salida JSON legible por máquina                                     |

<Note>
  **Seguridad:** Solo se tocan carpetas con el prefijo `olostep-`. Las carpetas de habilidades no-Olostep en directorios de agentes nunca se modifican. La limpieza del archivo de bloqueo solo elimina claves con el prefijo `olostep-`.
</Note>

## Descubrimiento y formato de habilidades

Las habilidades se descubren escaneando subdirectorios en busca de un archivo `SKILL.md`. El archivo debe incluir un bloque de frontmatter YAML con los campos `name` y `description`. Los nombres duplicados y sanitizados son rechazados.

```markdown theme={null}
---
name: my-skill
description: Qué hace esta habilidad y cuándo usarla
---

# Mi Habilidad

...instrucciones de la habilidad aquí...
```

## Convención de nombres

Las carpetas instaladas siempre usan el prefijo `olostep-` — por ejemplo, `research` se convierte en `olostep-research`. Los nombres se sanitizan a minúsculas con caracteres inválidos reemplazados por `-`. Este prefijo mantiene las habilidades gestionadas por Olostep claramente identificables y previene conflictos con otras herramientas.

## Relacionado

* [Referencia de CLI](/sdks/cli) — documentación completa del comando
* [Servidor MCP](/integrations/mcp-server) — proporciona a tu agente herramientas en vivo de Olostep