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