@skillsmanagerbasetis/skill-manager

CLI para gestionar skills de IA e instalarlas en 11 herramientas de coding: Claude Code, Cursor, Windsurf, Gemini CLI, Codex, OpenCode, GitHub Copilot, Aider, Zed AI, RooCode y Qwen CLI.

Las skills se almacenan en PostgreSQL y se distribuyen vía API REST autenticada con AWS Cognito.

Paquetes por entorno

| Entorno | Paquete npm | Comando | API | |---------|------------|---------|-----| | Producción | @skillsmanagerbasetis/skill-manager | skill-manager | skillsmanager.basetis.com | | Staging | @skillsmanagerbasetis/skill-manager-staging | skill-manager-staging | skillsmanager-staging.basetis.com | | Local | @skillsmanagerbasetis/skill-manager-local | skill-manager-local | localhost:3001 |

Cada paquete guarda su configuración en un directorio independiente (~/.skill-manager/, ~/.skill-manager-staging/, ~/.skill-manager-local/).

Requisitos

• Node.js >= 20

Primeros pasos

# 1. Autenticarse (abre navegador con Google OAuth)
npx @skillsmanagerbasetis/skill-manager login

# 2. Configurar (selecciona empresa y herramienta IA por defecto)
npx @skillsmanagerbasetis/skill-manager init

# 3. Explorar el catálogo
npx @skillsmanagerbasetis/skill-manager list

# 4. Instalar una skill
npx @skillsmanagerbasetis/skill-manager install habilidades/habilidad/typescript

Referencia de comandos

Autenticación

| Comando | Descripción | |---------|-------------| | login | Inicia sesión con Google OAuth | | logout | Cierra la sesión | | whoami | Muestra usuario autenticado y estado del token |

Configuración

| Comando | Descripción | |---------|-------------| | init | Configuración inicial (empresa, herramienta, find-skill) | | sync | Regenera el find-skill con permisos actualizados |

Descubrimiento

| Comando | Flags | Descripción | |---------|-------|-------------| | list | --filter, --json | Lista skills publicadas del catálogo | | search [texto] | --type, --level, --entity, --project, --json | Búsqueda avanzada con permisos | | detect | — | Detecta stack del proyecto y recomienda skills |

Instalación

| Comando | Flags | Descripción | |---------|-------|-------------| | install <ruta> | --tool, --scope, --force | Instala skill + hijos opcionales | | install-project <slug> | --tool, --scope, --yes | Instala todas las skills de un proyecto | | install-area <slug> | --tool, --scope, --yes | Instala todas las skills de un área | | install-team <slug> | --tool, --scope, --yes | Instala todas las skills de un equipo | | install-sector <slug> | --tool, --scope, --yes | Instala todas las skills de un sector |

Lectura y estado

| Comando | Flags | Descripción | |---------|-------|-------------| | read <ruta> | --tool, --scope, --raw, --json | Muestra contenido de skill instalada | | status | --json | Compara versiones locales vs catálogo |

Actualización y eliminación

| Comando | Flags | Descripción | |---------|-------|-------------| | update | --dry-run | Comprueba y aplica actualizaciones | | remove <ruta> | --tool, --scope, --yes | Desinstala skill del filesystem |

Publicación

| Comando | Descripción | |---------|-------------| | push <ruta> | Publica cambios locales (push directo o propuesta según permisos) |

Herramientas soportadas (11)

| Herramienta | Global | Proyecto | Formato | |-------------|--------|----------|---------| | Claude Code | ~/.claude/skills/{path}/SKILL.md | .claude/skills/{path}/SKILL.md | SKILL.md | | Gemini CLI | ~/.gemini/skills/{path}/SKILL.md | .agents/skills/{path}/SKILL.md | SKILL.md | | Codex CLI | ~/.codex/{name}/SKILL.md | .agents/skills/{path}/SKILL.md | SKILL.md | | OpenCode CLI | ~/.config/opencode/skills/{path}/SKILL.md | .opencode/skills/{path}/SKILL.md | SKILL.md | | Qwen CLI | ~/.qwen/skills/{path}/SKILL.md | .qwen/skills/{path}/SKILL.md | SKILL.md | | Cursor | ~/.cursor/rules/{name}.mdc | .cursor/rules/{name}.mdc | .mdc | | Windsurf | ~/.windsurf/global_rules.md (append) | .windsurf/rules/{name}.md | .md | | GitHub Copilot | — | .github/copilot/skills/{name}.md | .md | | Aider | — | .aider/skills/{name}.md | .md | | Zed AI | — | .zed/skills/{name}.md | .md | | RooCode | — | .roo/rules/{name}.md | .md |

Licencia

Uso interno Basetis.