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 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
Esta función está disponible a través del CLI de Olostep.
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.
Instalar 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 enlazar 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 en el navegador antes de instalar |
--source <path> | Directorio de habilidades incluido en el 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 de habilidades globales 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 enlazar simbólicamente, si falla, copia |
--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" }
]
}
]
}
SKILL.md. El archivo debe incluir un bloque de frontmatter con los campos name y description. Los nombres duplicados 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 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 |
--all-agents (por defecto) 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 y los caracteres inválidos se reemplazan por -. Este prefijo mantiene las habilidades gestionadas por Olostep claramente identificables y previene conflictos con otras herramientas.
olostep remove skills
Elimina carpetas de habilidades instaladas por Olostep de la tienda canónica y de 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 directorio personalizado, usa todos los agentes instalados 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> | — | 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-.
