## Asset Header - **Asset ID:** TP-EL-Skills-CanonizacionWikiX-v01 - **Version:** v01 - **Status:** Listo para ejecución en el Room Skills - **Owner:** Victor Heredia - **Sherpa:** SherpaX - **Ratificador:** Victor Heredia - **IntelliBank:** IB-EL-EmpowerLabs / PB-EL-Project-Bank / PB-VH-Victor - **Tipo:** TP — Transfer Pack (handoff entre rooms) - **Propósito:** Canonizar 5 skills nuevos como comandos del plugin WORX y distribuirlos al equipo de forma estable, vía actualización de plugin — sin editar a mano el caché instalado. - **Fecha:** 2026-06-18 - **Origen:** Room Ejecución WikiX (cierre) → entrega al Room Skills --- # Canonización de los Skills WikiX en el Plugin WORX ## Transfer Pack para el Room Skills > *Veredicto: tenemos 5 skills listos y probados conceptualmente. El problema no es el contenido — es el **método de distribución**. Soltar archivos a mano en la carpeta del plugin **rompe el descubrimiento de comandos** (lo comprobamos: desapareció hasta `/arrancaroom`). La vía correcta es reconstruir el plugin una versión arriba con los comandos adentro, empaquetarlo y que todos actualicen una sola vez. Este pack trae todo para resolverlo en una sola sesión, más la oportunidad de ampliar el catálogo.* --- ## 1. Qué resuelve el Room Skills Tres cosas, en orden: 1. **Canonizar** los 5 skills WikiX/ops como comandos oficiales del toolkit WORX (que existan como `/wx-wikixcrea`, `/wx-wikixsalud`, etc. para todo el equipo). 2. **Distribuir** el toolkit actualizado a Victor y al equipo de forma reproducible (zip + update de plugin), sin cirugía manual de archivos. 3. **Ampliar** el paquete: aprovechar la sesión para generar/sumar skills adicionales al catálogo (ver §8). --- ## 2. La lección dura (incidente que origina este pack) En el Room WikiX intentamos instalar los 5 comandos copiándolos a mano dentro de la carpeta `commands/` del plugin instalado. Resultado: **el plugin entero dejó de cargar** — desaparecieron incluso comandos que ya funcionaban (`/arrancaroom`). Se recuperó eliminando los archivos agregados y reiniciando Cowork. **Regla canónica que sale de aquí:** > La carpeta del plugin en `…/Library/Application Support/Claude/…/.remote-plugins/plugin_XXXX/` es un **caché instalado, de solo lectura**. Nunca se edita a mano. Los comandos se agregan en la **fuente** del plugin (el repo/marketplace), se sube la **versión**, y el sistema regenera el caché limpio al actualizar. Esto es exactamente lo que valida el instinto correcto: **zip + update**, no edición archivo por archivo. --- ## 3. Estado actual del plugin (línea base) **Plugin:** `worx-empowerlabs` · **versión actual `0.1.0`** **Caché instalado (solo lectura, NO editar):** `…/.remote-plugins/plugin_01PtP4LScqrpYNNHs1B86E7G/` **Anatomía (limpia y simple):** ``` worx-empowerlabs/ ├── .claude-plugin/plugin.json ← manifest (name, version, description, author, keywords) ├── commands/ ← 7 comandos .md (un archivo = un /comando) │ ├── arrancaroom.md arrancaworx.md listaskills.md │ ├── mindia.md minsemana.md resumenroom.md setupsherpax.md ├── skills/worx-empowerlabs/ ← SKILL.md (contexto WORX) + references/ └── README.md ``` **Manifest actual (`plugin.json`):** ```json { "name": "worx-empowerlabs", "version": "0.1.0", "description": "Toolkit de comandos WORX de EmpowerLabs: arranque e inducción de usuarios al SherpaX y comandos del día a día (arrancar room, minuta del día, resumen).", "author": { "name": "EmpowerLabs · Victor Heredia" }, "keywords": ["worx","empowerlabs","sherpax","induccion","arranque","hiorg"] } ``` **Formato de cada comando** (trivial — esto es todo lo que se necesita): ```markdown --- description: --- # /comando — Título ``` --- ## 4. Los 5 skills listos para canonizar Todos existen como `.md` con frontmatter `description:` válido. Copias persistentes en el vault: `Vault/Vault_skills/` (y respaldo en outputs del room). El texto completo de los 5 va en el **Anexo B**. | Comando | Qué hace | Entidad natural | Estado | |---|---|---|---| | `/wx-wikixcrea` | Crea página WikiX (concepto · guía · hub) con ficha al pie y convención de dos enlaces. | WikiX (producto) | ✅ Al día (usa naming IB-WikiX / WikiX-Hub) | | `/wx-wikixsalud` | Audita y mantiene la salud del WikiX: links rotos, huérfanas, cobertura, **drift**; aplica fixes seguros. | WikiX (producto) | ✅ Al día | | `/wx-wikixupdate` | Re-sintetiza una página (o todo) desde su **fuente autoritativa más reciente**, no desde las Fuentes listadas. | WikiX (producto) | ✅ Al día | | `/creawikidoc` | Crea página **pedagógica** navegable (guía de aprendizaje, sin Asset Header ni Fuentes). | WikiX (producto) | ⚠️ **Drift de naming** — dice "LLM-Wiki" y rutas viejas | | `/wx-updateboardhoy` | Actualiza el board diario del equipo `BRD-EL-HOY-Dashboard-v01`. | EmpowerLabs (ops internas) | ⚠️ **Drift de naming** — referencia `BRD-XX-LLMWiki-GrafoHumano` viejo | **Corrección obligatoria antes de canonizar** (Anexo C): actualizar en `creawikidoc` y `updateboardhoy` toda mención de `LLM-Wiki` → `WikiX` / `IB-WikiX`, y `BRD-XX-LLMWiki-GrafoHumano` → `WikiX-Hub-v01.html`. Son ediciones de texto, ya identificadas. --- ## 5. Decisión arquitectónica a tomar (la pregunta de fondo) Los 5 skills no son todos del mismo dominio. Hay que decidir **dónde viven**: **Opción A — Todo en `worx-empowerlabs` (bump a v0.2.0).** Un solo plugin, el equipo ya lo tiene, solo actualizan. Simple. Pero mezcla WikiX (producto vendible a clientes) con ops internas EL. **Opción B — Plugin nuevo `worx-wikix` para los 4 de WikiX + `updateboardhoy` se queda en `worx-empowerlabs`.** Separa el producto WikiX (canonizable, **vendible a clientes** junto con el InstallPack) de las ops internas. Más limpio para productizar; dos plugins que mantener. **Recomendación de este pack → Opción B (split):** - `worx-wikix` (nuevo): `/wx-wikixcrea`, `/wx-wikixsalud`, `/wx-wikixupdate`, `/creawikidoc` → empata con la ambición de vender WikiX a clientes (ya existe el `IB-WikiX-InstallPack`). - `worx-empowerlabs` (v0.2.0): suma `/wx-updateboardhoy` (ops EL puras). Si se prioriza máxima simplicidad sobre productización, Opción A es legítima. **Decisión de Victor en el room.** --- ## 6. Procedimiento canónico: empaquetar y distribuir Aplica igual sea A o B. La clave: **editar la fuente, no el caché; subir versión; reempaquetar; actualizar**. 1. **Localizar la fuente** del plugin (ver §7 — pregunta abierta). 2. **Agregar los comandos** corregidos a `commands/` en la **fuente** (no en `.remote-plugins/`). 3. **Subir versión** en `.claude-plugin/plugin.json` (`0.1.0` → `0.2.0`) y actualizar `description`/`keywords` (añadir "wikix", "wiki", "dashboard"). 4. **Actualizar el README** del plugin: tabla de comandos + el nuevo flujo. 5. **Empaquetar** (zip de la carpeta del plugin / `.plugin`). 6. **Publicar** en el marketplace/repo fuente desde donde el equipo instala. 7. **Actualizar**: Victor y el equipo corren el *update* del plugin una sola vez → el caché se regenera limpio con los comandos nuevos junto a `/arrancaroom`, `/wx-mindia`, etc. 8. **Verificar**: en una sesión nueva, `/wx-wikixcrea` (y los demás) aparecen y disparan. `/arrancaroom` sigue intacto. > Hay skills de Cowork que asisten esto: `cowork-plugin-management:create-cowork-plugin` (armar plugin desde cero, entrega un `.plugin`) y `cowork-plugin-management:cowork-plugin-customizer` (personalizar uno existente). Útiles para empaquetar sin fricción en el Room Skills. --- ## 7. ⛳ Pregunta abierta crítica (resolver primero en el Room Skills) **¿Dónde está la FUENTE del plugin `worx-empowerlabs`?** El caché instalado (`.remote-plugins/plugin_01PtP4…`) es solo lectura y no es la fuente. La carpeta `Vault/Vault_skills/` **NO es** la fuente de WORX — es un clon del repo público `anthropics/skills` (marketplace `anthropic-agent-skills`); los 5 `.md` quedaron sueltos en su raíz por conveniencia, hay que moverlos a un staging limpio. **Acción:** identificar de qué marketplace/repo se instaló `worx-empowerlabs` (Settings → Capabilities muestra el origen). Esa es la carpeta a editar y versionar. Si no existe un repo fuente accesible, el Room Skills lo **reconstruye** (estructura del §3) y lo publica como marketplace propio de EmpowerLabs — lo que de paso resuelve la distribución al equipo de forma permanente. --- ## 8. Oportunidad de expansión (ampliar el catálogo en la misma sesión) Mientras se arma el paquete, candidatos a canonizar/crear (no exhaustivo — priorizar en el room): - **`/wikixhub`** — regenerar y servir el visor `WikiX-Hub` (maestro + Hubs por entidad). Hoy es script suelto; merece comando. - **`/wikixingesta`** — ingestar una fuente de `Raw/` a página Wiki (pre-validación + creación + registro), separado de `/wx-wikixcrea`. - **Empaquetar comandos ya existentes** que viven como skills sueltas del vault (`next-scanner`, `weekly-sync`, `bmf-registry-updater`, `vault-orphan-rescue`) → evaluar cuáles ascienden a comando del toolkit. - **Revisar nombres**: convención de comandos (`/wikix*` para WikiX, prefijo claro para ops EL) antes de que el catálogo crezca y sea difícil renombrar. --- ## 9. NEXTs - **NEXT (Victor · decisión):** elegir Opción A (todo en worx-empowerlabs) vs **B (split worx-wikix + worx-empowerlabs)**. `#NEXT-Victor` - **NEXT (Victor):** confirmar de qué marketplace/repo se instaló `worx-empowerlabs` (origen de la fuente). `#NEXT-Victor` - **NEXT (SherpaX):** aplicar la corrección de naming a `creawikidoc` y `updateboardhoy` (Anexo C) antes de empaquetar. `#NEXT-SherpaX` - **NEXT (SherpaX):** mover los 5 `.md` de `Vault/Vault_skills/` (raíz del repo anthropic) a un staging limpio del room. `#NEXT-SherpaX` - **NEXT (Room Skills):** ejecutar §6 (empaquetar v0.2.0 / `worx-wikix`), publicar y verificar. `#NEXT-Room` --- ## Anexo A — Rutas exactas | Qué | Ruta | |---|---| | Caché instalado (solo lectura) | `…/.remote-plugins/plugin_01PtP4LScqrpYNNHs1B86E7G/` | | Manifest actual | `…/plugin_01PtP4…/.claude-plugin/plugin.json` (v0.1.0) | | Comandos actuales (7) | `…/plugin_01PtP4…/commands/*.md` | | 5 skills nuevos (copia vault) | `Vault/Vault_skills/{wikixcrea,wikixsalud,wikixupdate,creawikidoc,updateboardhoy}.md` | | `Vault_skills/` = clon de | `github.com/anthropics/skills` (NO es la fuente WORX) | | WikiX (producto) | `Intellibanks/IB-WikiX/` · visor `WikiX-Hub-v01.html` | | InstallPack cliente | `IB-WikiX-InstallPack-v0x` | ## Anexo B — Contenido íntegro de los 5 comandos ### B.1 `/wx-wikixcrea` ```markdown --- description: Crea una página nueva en el WikiX (IB-WikiX) — de tipo concepto, guía pedagógica o hub/home — con ficha al pie, convención de dos enlaces, verificación de enlaces (Gate G0) y registro en el índice. Úsalo cuando el usuario quiera agregar una página al WikiX. --- (cuerpo completo en Vault/Vault_skills/wx-wikixcrea.md — define tipo·naming·Gate G0·redacción dos-enlaces·ficha al pie·anti-huérfana·registro+regenera·confirma) ``` ### B.2 `/wx-wikixsalud` ```markdown --- description: Audita y mantiene la salud del WikiX (IB-WikiX) — corre los validadores, detecta enlaces rotos, huérfanas, cobertura, y DRIFT (páginas cuyas Fuentes apuntan a versiones superadas), propone/aplica fixes seguros y regenera el grafo. Úsalo para revisar o sanear el WikiX. --- (cuerpo: 1 medir · 2 reportar · 3 detección de DRIFT · 4 fixes seguros · 5 regenerar/cerrar · reglas espejo-no-penaliza) ``` ### B.3 `/wx-wikixupdate` ```markdown --- description: Actualiza el WikiX (IB-WikiX) — re-sintetiza una página/tópico desde su fuente autoritativa MÁS RECIENTE (no desde las Fuentes listadas, que pueden estar viejas), o regenera todo el WikiX. Uso: /wx-wikixupdate · /wx-wikixupdate todo. --- (cuerpo: Modo A página única [Gate G0 descubrir fuente autoritativa, comparar, re-sintetizar, ficha, verificar] · Modo B regenerar todo · reglas) ``` ### B.4 `/creawikidoc` ⚠️ requiere corrección de naming (Anexo C) ```markdown --- description: Crea una página pedagógica navegable dentro del WikiX — guía de aprendizaje paso a paso con WikiLinks reales, SIN Asset Header ni Fuentes, solo versión + última actualización al pie. --- (cuerpo en Vault/Vault_skills/creawikidoc.md — OJO: dice "LLM-Wiki" y ruta Intellibanks/LLM-Wiki/Wiki/ → cambiar a WikiX / IB-WikiX/Wiki/) ``` ### B.5 `/wx-updateboardhoy` ⚠️ requiere corrección de naming (Anexo C) ```markdown --- description: Actualiza el tablero del equipo BRD-EL-HOY-Dashboard-v01 — saludo y fecha, mensaje al equipo, prioridades del día, feed y novedades. Mantiene links de boards del equipo; excluye tableros personales. --- (cuerpo en Vault/Vault_skills/wx-updateboardhoy.md — OJO: link Wiki dice LLM-Wiki/BRD-XX-LLMWiki-GrafoHumano-v01.html → cambiar a IB-WikiX/WikiX-Hub-v01.html) ``` ## Anexo C — Correcciones de naming antes de canonizar | Archivo | Buscar | Reemplazar por | |---|---|---| | `creawikidoc.md` | `LLM-Wiki` (texto) | `WikiX` | | `creawikidoc.md` | `Intellibanks/LLM-Wiki/Wiki/` | `Intellibanks/IB-WikiX/Wiki/` | | `creawikidoc.md` | `LLM-Wiki/index.md` | `IB-WikiX/index.md` | | `creawikidoc.md` | `BRD-XX-WikiX-GrafoHumano` (generador) | `WikiX-Hub` (visor vigente) | | `updateboardhoy.md` | `LLM-Wiki/BRD-XX-LLMWiki-GrafoHumano-v01.html` | `IB-WikiX/WikiX-Hub-v01.html` | --- ## Addendum 2026-06-21 · ✅ RATIFICADO — paquete `worx-wikix` v0.2.0 listo para publicar Victor ratificó (L3) el carril `/sk-` y la canonización de la familia. **Paquete ensamblado:** `outputs/worx-wikix-v0.2.0.zip` (manifest v0.2.0 + README + `commands/` con `/sk-wikixcrea`, `/sk-wikixsalud`, `/sk-wikixupdate` [con modo propagación], `/sk-creawikidoc`). **Pasos para publicar:** (1) subir el contenido del zip al **repo/marketplace fuente** de `worx-wikix` (reemplaza v0.1.0); (2) correr el *update* del plugin en Cowork (Victor + equipo); (3) verificar que aparezcan los `/sk-wikix*` y que `/arrancaroom` siga intacto. **No** soltar al caché `.remote-plugins/`. *(`updateboardhoy` sigue en `worx-empowerlabs`, sin `/sk-`.)* --- ## Addendum 2026-06-20 · Familia renombrada a `/sk-` + modo propagación Decisión de Victor: los skills propios del WikiX adoptan el carril **`/sk-`** (marca lo propietario). Para el Room Skills: - **Renombrar la familia** en el plugin `worx-wikix`: `wikixcrea → /sk-wikixcrea` · `wikixsalud → /sk-wikixsalud` · `wikixupdate → /sk-wikixupdate` · `creawikidoc → /sk-creawikidoc`. Archivos nuevos listos en `Vault/Vault_skills/sk-*.md`. - **`/sk-wikixupdate` trae modo nuevo de PROPAGACIÓN de término** (`/sk-wikixupdate `): propaga un rename/redefinición a todas las páginas afectadas sin revisar toda la wiki. Es el procedimiento de WORX OS→WORX OS hecho repetible. - **`updateboardhoy`** (ops EL, no WikiX) se mantiene fuera de esta familia; decidir si también lleva `/sk-` o queda verbo. - **Convención:** se canonizó `/sk-` en la página WikiX `Nomenclatura-Invocacion`; el doc fuente `CP-XX-BMF-NomenclaturaInvocacion-v01` quedó marcado (⚑) para ratificación L3 → promover a v02 con `/sk-` canónico. - Recordatorio: **no soltar a mano en el caché del plugin** — empaquetar y actualizar (sección §6). --- *Transfer Pack generado al cierre del Room Ejecución WikiX · naming y ubicación canónicos · entrega al Room Skills.*