Saltar al contenido principal

Scripts de Configuración

Refactor: Separación de Responsabilidades​

Antes​

  • setup-tenant.ts hacía todo: crear tenant, API keys, configurar Claude MCP, e instalar skills
  • La opción --skills-only era un workaround

Después​

  • setup-tenant.ts: Crea tenants, genera API keys, configura MCP, opcionalmente instala skills
  • install-skills.ts: Dedicado exclusivamente a gestionar la instalación de skills

Scripts Disponibles​

1. setup-tenant.ts - Configuración Completa de Tenant​

Crea un tenant con todo lo necesario para empezar a trabajar.

# Crear tenant con todo
bun run scripts/setup-tenant.ts mi-empresa

# Crear tenant sin instalar skills
bun run scripts/setup-tenant.ts mi-empresa --no-skills

# Tenant con URL personalizada
bun run scripts/setup-tenant.ts produccion --url https://erp.miempresa.com/mcp

Incluye:

  • Creación de tenant (schema + tablas)
  • Generación de API key
  • Configuración de Claude MCP
  • Instalación de skills (opcional con --no-skills)

2. install-skills.ts - Gestión de Skills​

Script dedicado para instalar/actualizar skills de Claude.

# Instalación básica (symlinks)
bun run scripts/install-skills.ts

# Listar skills disponibles
bun run scripts/install-skills.ts --list

# Sobreescribir skills existentes
bun run scripts/install-skills.ts --force

# Copiar en lugar de symlinks
bun run scripts/install-skills.ts --copy

# Instalar en directorio personalizado
bun run scripts/install-skills.ts --target ~/my-skills

Características:

  • Crea symlinks por defecto (recomendado para desarrollo)
  • Lista skills con descripciones automáticas de SKILL.md
  • Detecta y evita sobreescribir directorios existentes (usa --force)
  • Opción --copy para crear copias independientes
  • Permite especificar directorio destino personalizado

Ventajas del Symlink:

  • Los cambios en ./skills/ se reflejan automáticamente en Claude
  • No necesitas reinstalar después de modificar skills
  • Ideal para desarrollo activo

Casos de Uso​

Desarrollo Normal​

# Primera vez: crear tenant + instalar skills
bun run scripts/setup-tenant.ts mi-empresa

# Actualizar skills después de cambios
# (con symlinks no es necesario, los cambios ya están activos)

Solo Instalar Skills (sin tenant)​

# Primera instalación
bun run scripts/install-skills.ts

# Actualizar forzando sobreescritura
bun run scripts/install-skills.ts --force

Tenant sin Skills​

# En CI/CD o entornos donde no se usa Claude Desktop
bun run scripts/setup-tenant.ts produccion --no-skills --url https://api.prod.com/mcp

Skills en Directorio Personalizado​

# Útil para testing o múltiples instalaciones
bun run scripts/install-skills.ts --target ~/test-skills
bun run scripts/install-skills.ts --target ~/prod-skills --copy

Migración desde setup-tenant.ts --skills-only​

Antes:

bun run scripts/setup-tenant.ts --skills-only

Ahora:

bun run scripts/install-skills.ts

La opción --skills-only está deprecada y redirige al nuevo script.

Skills Disponibles​

Los siguientes skills se descubren automáticamente desde ./skills/:

  • /fyso - Agent-Native ERP Builder
  • /fyso-api - REST API - Fyso
  • /fyso-deploy - Deploy
  • /fyso-entity - Gestión de Entidades
  • /fyso-init - Inicializar Proyecto
  • /fyso-mcp - Configuración MCP
  • /fyso-rules - Reglas de Negocio
  • /fyso-test - Testing

Estructura de Skills​

Para que un directorio sea reconocido como skill válido debe contener:

skills/
  mi-skill/
    SKILL.md          <- REQUERIDO (define el skill para Claude)
    otros-archivos... <- Opcional

El script extrae automáticamente la descripción de la primera línea con # en SKILL.md.

Troubleshooting​

Los skills ya están instalados. Usa --force para reinstalar:

bun run scripts/install-skills.ts --force

"Directorio existente"​

Hay un directorio real (no symlink). Opciones:

# Sobreescribir
bun run scripts/install-skills.ts --force

# Eliminar manualmente y reinstalar
rm -rf ~/.claude/skills/fyso-*
bun run scripts/install-skills.ts

Skills no aparecen en Claude​

  1. Reinicia Claude Desktop/Code completamente
  2. Verifica la instalación:
ls -la ~/.claude/skills/
  1. Deben verse como symlinks: fyso -> /path/to/project/skills/fyso

Usa --copy para crear copias en lugar de symlinks:

bun run scripts/install-skills.ts --copy
Creado con Fyso