Habilidades - Olostep Docs

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

Instala habilidades de Olostep en agentes como Cursor, Claude, Codex, Windsurf, y más
Las habilidades se colocan en una tienda canónica (~/.agents/skills) y se vinculan 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

Esta función está disponible a través del CLI de Olostep.

Las habilidades

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

Habilidad	Lo que 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`	Rastrea autónomamente todo un sitio
`map`	Descubre cada URL en un sitio
`batch`	Extrae hasta 10,000 URLs en paralelo
`extract-schema`	Extrae una página en JSON estructurado que coincide con un esquema
`docs-to-code`	Extrae documentación de API y escribe código funcional a partir de ella
`integrate`	Instala automáticamente el SDK de Olostep en un proyecto
`migrate-code`	Lee una guía de migración y actualiza el código local
`research`	Investigación web comparativa y citada para una decisión
`debug-error`	Busca un mensaje de error en GitHub / SO / documentación en vivo
`setup`	Enseña al agente cómo configurar el servidor MCP

Las habilidades se combinan con el servidor MCP: el servidor MCP proporciona al agente las herramientas en vivo, las habilidades le dan el conocimiento de cuándo y cómo usarlas.

Categorías

Cada habilidad pertenece a una de tres categorías:

Habilidades de uso — utilizan las características de Olostep: scrape, search, answers, crawl, map, batch.
Habilidades de construcción — instalan e integran Olostep en una base de código: setup (configurar el servidor MCP) e integrate (añadir el SDK de Olostep a un proyecto).
Habilidades de flujo de trabajo — producen un entregable con Olostep: research, docs-to-code, migrate-code, debug-error, extract-schema.

Instala solo una categoría con olostep add skills --category usage (o build, o workflow). 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 tener capacidades añadidas desde la instalación), y recurre a la copia local de lo contrario. Navega por todas las habilidades alojadas en olostep.com/skills.

`olostep add skills`

Sincroniza habilidades desde un directorio fuente en el CLI, las instala en la tienda canónica, y luego las despliega en el directorio de habilidades de cada agente.

Instala el CLI

# Instalación global
npm install -g olostep-cli

# O ejecuta sin instalar
npx -y olostep-cli@latest add skills

Uso

# Instala todas las habilidades en todos los agentes detectados (por defecto)
olostep add skills

# Autentica primero, luego instala
olostep add skills --login

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

# Siempre copia en lugar de vincular simbólicamente
olostep add skills --link-mode copy

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

Opciones

Opción	Predeterminado	Descripción
`--login`	—	Ejecuta el inicio de sesión del navegador antes de instalar
`--source <path>`	Dir. de habilidades empaquetadas en CLI	Directorio fuente de habilidades
`--cli-local-dir <path>`	CLI/skills	Directorio donde las habilidades fuente se sincronizan para uso local del CLI
`--agent <name>`	—	Dirige a un agente específico — repetible
`--all-agents` / `--no-all-agents`	`--all-agents`	Si no se establece `--agent`, dirige a todos los agentes instalados detectados
`--global` / `--no-global`	`--global`	Instala en directorios globales de habilidades de agentes conocidos
`--canonical-dir <path>`	`~/.agents/skills`	Ubicación de almacenamiento canónica para habilidades de Olostep
`--agent-skills-dir <path>`	—	Directorio de habilidades de destino personalizado (requiere `--no-global`)
`--skill <name>`	—	Incluye solo esta habilidad — repetible
`--exclude <name>`	—	Excluye esta habilidad — repetible
`--overwrite` / `--no-overwrite`	`--overwrite`	Reemplaza los objetivos existentes
`--link-mode <auto\|symlink\|copy>`	`auto`	`auto` intenta vincular simbólicamente, recurre a copiar
`--json`	—	Emite salida JSON legible por máquina

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 un error
Una selección de habilidades vacía después de --skill / --exclude generará un error

Salida JSON

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

`olostep list skills`

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

olostep list skills            # resumen legible por humanos
olostep list skills --json     # legible por máquina

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 con los campos name y description. Los nombres duplicados y sanitizados son rechazados.

---
name: research-agent
description: Agente de investigación autónomo para investigación profunda en la web
---

# Agente de Investigación

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

Agentes compatibles

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

Cada clave se asigna a una ruta de habilidades de directorio de inicio conocida. Usa --all-agents (el predeterminado) para dirigir a todos los agentes instalados detectados, o pasa --agent <key> para dirigir a específicos.

Convención de nombres

Los nombres de las carpetas instaladas siempre usan el prefijo olostep-: por ejemplo, research-agent se convierte en olostep-research-agent. 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.

`olostep remove skills`

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

Uso

# Elimina todas las habilidades de Olostep de todos los agentes
olostep remove skills

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

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

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

Opciones

Opción	Predeterminado	Descripción
`--agent <name>`	—	Elimina solo de los agentes especificados — repetible
`--all-agents` / `--no-all-agents`	`--all-agents`	Si no se establece `--agent` o dir. personalizado, usa todos los agentes instalados detectados
`--canonical-dir <path>`	`~/.agents/skills`	Directorio canónico de habilidades para eliminar de
`--agent-skills-dir <path>`	—	Directorio de habilidades de destino personalizado para eliminación
`--skill <name>`	—	Elimina solo las habilidades coincidentes — repetible
`--json`	—	Emite salida JSON legible por máquina

Seguridad: Solo se tocan carpetas con el prefijo olostep-. Las carpetas de agentes no-Olostep nunca se modifican. La limpieza del archivo de bloqueo solo elimina claves con el prefijo olostep-.

Documentation Index

​Las habilidades

​Categorías

​olostep add skills

​Instala el CLI

​Uso

​Opciones

​Salida JSON

​olostep list skills

​Descubrimiento y formato de habilidades

​Agentes compatibles

​Convención de nombres

​olostep remove skills

​Uso

​Opciones

Las habilidades

Categorías

`olostep add skills`

Instala el CLI

Uso

Opciones

Salida JSON

`olostep list skills`

Descubrimiento y formato de habilidades

Agentes compatibles

Convención de nombres

`olostep remove skills`

Uso

Opciones