Habilidades

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.

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: 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:

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.

Instalación

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:

npx -y olostep-cli@latest add skills

Uso común

# 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:

# 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

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

Forma de salida JSON

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

{
  "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.

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.

# 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

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-.

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.

---
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 — documentación completa del comando
Servidor MCP — proporciona a tu agente herramientas en vivo de Olostep

Comenzar

Características

Saldo y Facturación

Las habilidades

Configuración

Datos web principales

Construir e integrar

Investigación y depuración

Categorías

Copias alojadas

Instalación

Uso común

Referencia de opciones

Forma de salida JSON

Agentes compatibles

`olostep list skills`

`olostep remove skills`

Descubrimiento y formato de habilidades

Convención de nombres

Relacionado

​Las habilidades

​Configuración

​Datos web principales

​Construir e integrar

​Investigación y depuración

​Categorías

​Copias alojadas

​Instalación

​Uso común

​Referencia de opciones

​Forma de salida JSON

​Agentes compatibles

​olostep list skills

​olostep remove skills

​Descubrimiento y formato de habilidades

​Convención de nombres

​Relacionado

Las habilidades

Configuración

Datos web principales

Construir e integrar

Investigación y depuración

Categorías

Copias alojadas

Instalación

Uso común

Referencia de opciones

Forma de salida JSON

Agentes compatibles

`olostep list skills`

`olostep remove skills`

Descubrimiento y formato de habilidades

Convención de nombres

Relacionado