De la biblioteca a los proyectos: cómo trabajar con skills en Rakenne

Cuando abres Rakenne por primera vez, es fácil percibir dos capas:

• Proyectos, donde haces el trabajo diario con clientes y documentos.
• Skills, que son flujos reutilizables que enseñan al agente a comportarse como un especialista en tu dominio.

Este artículo explica el ciclo de vida completo de una skill desde el punto de vista del usuario final:

1. Qué es la Biblioteca de Skills y cómo encontrar la skill adecuada
2. Cómo instalar una skill en un proyecto y empezar a usarla
3. Cómo funcionan las actualizaciones y versiones
4. Cómo hacer fork de una skill cuando necesitas tu propia variante
5. Cómo publicar y compartir skills entre proyectos y clientes

Sin código ni detalles internos: solo cómo usar esto como consultor, analista o responsable de cumplimiento.

1. ¿Qué es la Biblioteca de Skills?

Una skill es un flujo guiado, escrito en lenguaje natural, que indica al agente:

• Cuándo debe usarse (disparadores típicos)
• Qué pasos seguir y en qué orden
• Qué documentos, plantillas y herramientas utilizar a lo largo del proceso

Ejemplos:

• «Inventario de activos ISO 27001»
• «Informe de estudio clínico (CSR) – Secciones clave»
• «Revisión de claims de etiquetado – Mercado estadounidense»

La Biblioteca de Skills es donde viven esas skills:

• Skills de sistema: skills predefinidas que vienen con Rakenne
• Skills del tenant: skills creadas y compartidas dentro de tu organización
• Tus propias skills: borradores y versiones publicadas que has creado o bifurcado

Puedes verla como una tienda de aplicaciones para flujos de trabajo. Los proyectos no reciben todas las skills automáticamente; tú eliges cuáles quieres usar.

2. Encontrar la skill adecuada

Antes de iniciar un proyecto nuevo, vale la pena dedicar unos minutos a explorar la biblioteca.

2.1 Formas habituales de explorar

En la mayoría de vistas de la biblioteca puedes:

• Buscar: escribir una palabra clave como «SOC 2», «clínico», «inventario de activos» o «etiquetado».
• Usar filtros / etiquetas para acotar:
  • Dominio (p. ej., Seguridad de la Información, Life Sciences, Alimentación y Bebidas)
  • Caso de uso (p. ej., «Evaluación de riesgos», «Redacción de políticas», «Readiness», «Extracción de datos»)
• Ordenar por:
  • Más instaladas / populares: lo que más usan otros equipos
  • Actualizadas recientemente: skills que se mantienen activas

Buena regla práctica:

• Empieza amplio: busca por tu marco o regulación («ISO 27001», «ISO 14971», «SOC 2», «CVM FIDC»).
• Luego afina por tipo de documento («SoA», «Registro de riesgos», «Readiness», «Prospecto», «Informe clínico»).

2.2 Leer una skill antes de usarla

Al hacer clic en una skill puedes ver:

• Qué produce: documentos, datos estructurados, checklists, resúmenes…
• Cuándo usarla: prompts o situaciones típicas de inicio
• Entradas necesarias: qué necesitas tener listo (PDFs existentes, set de políticas, datos del cliente, etc.)
• Resultados esperados: ejemplos de lo que generará la sesión

Trátalo como leer la etiqueta de un producto antes de comprar: si las salidas no se alinean con el entregable que necesitas, sigue buscando.

3. Instalar una skill en un proyecto

Las skills viven en la biblioteca, pero solo se vuelven utilizables cuando las vinculas a un proyecto concreto.

3.1 Por qué importa la instalación

Cuando instalas una skill en un proyecto, Rakenne:

• Hace que el flujo de esa skill esté disponible para el agente del proyecto
• Trae consigo cualquier skill de apoyo de la que dependa (por ejemplo, ayudantes comunes de ISO 27001)
• Garantiza que las plantillas y herramientas correctas estén disponibles en segundo plano

Esto mantiene los proyectos limpios: cada proyecto solo ve las skills que realmente necesita.

3.2 Flujo típico de instalación

1. Abre tu proyecto.
   Por ejemplo: «Cliente A – ISMS ISO 27001», «Fondo Alpha – Documentos FIDC» o «ACME – Etiquetado de producto».

2. Ve a la sección de Skills del proyecto.
   Busca «Skills», «Agregar skills» o «Biblioteca de skills» en la navegación del proyecto.

3. Explora o busca la biblioteca desde dentro del proyecto.
   Verás las mismas skills que en la biblioteca global, con indicadores de:

   • Skills ya instaladas
   • Skills compatibles con la plantilla de tu proyecto

4. Instala la skill.

   • Haz clic en Instalar (o equivalente) en la skill que quieras.
   • Si la skill necesita ayudantes (otras skills de las que depende), se instalan juntas.
   • La instalación suele tardar solo unos segundos.

5. Confirma que está disponible en el proyecto.
   Tras la instalación, la skill:

   • Aparece en la lista de Skills instaladas del proyecto
   • Pasa a estar disponible en el chat (ver siguiente sección)

A partir de ese momento, cualquier persona con acceso al proyecto puede usar esa skill.

4. Usar una skill instalada en una sesión

Una vez instalada la skill, ya no necesitas pensar en la biblioteca: basta con hablar con el agente.

4.1 Cómo invocar una skill

Hay dos patrones muy habituales:

• Lenguaje natural
  Abre una sesión y describe lo que quieres:

  «Ayúdame a dirigir un taller de inventario de activos ISO 27001 para ACME.»
  «Necesito extraer todos los datos clave de este prospecto FIDC en PDF.»

  Si el proyecto tiene instalada una skill relevante, el agente a menudo encaminará tu petición a esa skill automáticamente.

• Selección explícita
  En algunas interfaces puedes elegir una skill desde un menú o usar una sintaxis de disparador específica.
  Es útil cuando:

  • Sabes exactamente qué skill quieres
  • Trabajas en un proyecto con varias skills parecidas

4.2 Cómo se siente una sesión dirigida por una skill

Comparado con conversar con una IA genérica, una sesión guiada por skill es:

• Estructurada — el agente te guía por pasos claros:
  • Recopilar ciertas entradas (documentos, datos, elecciones de parámetros)
  • Ejecutar extracciones o análisis
  • Producir documentos, checklists o datos estructurados
• Repetible — si ejecutas la misma skill en otro cliente, el flujo será casi idéntico.
• Trazable — normalmente sabes en qué paso estás y qué vendrá después.

No necesitas recordar los detalles técnicos. Solo:

• Elegir la skill correcta
• Proporcionar las entradas que te pide
• Revisar y aprobar los resultados

5. Cómo funcionan las versiones y actualizaciones de skills

Las skills evolucionan con el tiempo: un mejor checklist, una plantilla más pulida, una interpretación más afinada de una norma.

Rakenne gestiona esto mediante versiones.

5.1 Qué significan las versiones para ti

Desde el punto de vista de quien usa:

• Cada skill tiene una versión actual (por ejemplo «v1.0», «v1.1»…)
• Un proyecto suele usar una versión por skill a la vez
• Cuando aparece una nueva versión, la ves como una oportunidad de actualización, no como un cambio sorpresa

Comportamientos clave:

• Los proyectos existentes se mantienen estables.
  Si un proyecto está en la v1.0, permanecerá en esa versión hasta que decidas cambiarla.
• Los proyectos nuevos pueden empezar en la última versión.
  Al instalar una skill en un proyecto nuevo, normalmente obtendrás la versión más reciente.

5.2 Decidir cuándo actualizar

Cuando hay una nueva versión disponible puedes ver:

• Un aviso o indicador en la skill dentro del proyecto
• Notas de versión que cuentan qué ha cambiado (nuevas secciones, mejor cobertura, corrección de errores, orientación mejorada)

Buenas prácticas:

• Actualiza pronto cuando:
  • Estés empezando un nuevo encargo con un cliente
  • Las notas de versión corrijan errores, lagunas o mapeos que te importan
• Retrasa o prueba antes cuando:
  • Estés en mitad de un entregable regulatorio sensible
  • Tus revisores internos ya hayan aprobado una versión concreta

Un flujo sencillo para trabajos regulados:

1. Crea un proyecto sandbox.
2. Instala la skill y actualízala a la última versión allí.
3. Ejecuta una sesión de prueba con un cliente de ejemplo.
4. Solo entonces, actualiza la skill en los proyectos de producción.

6. Hacer fork de una skill: crear tu propia variante

A veces una skill estándar te lleva al 80 % del camino, pero tu organización:

• Tiene checklists o umbrales de aprobación propios
• Usa terminología diferente (nombres internos de controles, cargos, comités)
• Necesita pasos adicionales para la gobernanza interna

En esos casos, conviene hacer fork de una skill en lugar de empezar desde cero.

6.1 Qué significa “hacer fork” en la práctica

Desde el punto de vista de quien usa:

• Creas un proyecto especial (a menudo a partir de una plantilla Skill Workshop) que contiene:
  • Una copia de la skill original
  • Referencias y ejemplos de apoyo
• Adaptas el flujo a tu realidad:
  • Reformulas preguntas e instrucciones con tu lenguaje
  • Añades o quitas pasos
  • Apuntas a estilos de documento, ejemplos y políticas internas
• Terminas con una skill nueva que:
  • Está claramente basada en la original
  • Pertenece a tu organización
  • Puede instalarse en proyectos como cualquier otra skill

6.2 Cuándo configurar y cuándo hacer fork

• Configura (no hagas fork) cuando:

  • La skill ya tenga opciones/entradas para tus elecciones (p. ej., jurisdicción, sector)
  • Solo necesites cambiar datos (hechos del cliente), no el flujo

• Haz fork cuando:

  • Tu proceso de revisión sea significativamente distinto del estándar
  • La redacción estándar vaya a confundir a tus equipos
  • Necesites pasos adicionales que se reutilizarán en muchos clientes

El fork es la forma de convertir Rakenne de «mejores prácticas genéricas» en tu método propio de la casa.

7. Publicar y compartir tus skills

Cuando tienes una skill personalizada que funciona bien, puedes publicarla para que otras personas la usen.

Desde el punto de vista del usuario final, publicar hace tres cosas:

1. Congela una versión de la skill en la que otros pueden confiar.
2. La añade a la biblioteca visible para tu organización (o para un subconjunto, según la gobernanza).
3. Hace que sea instalable en proyectos normales, igual que una skill de sistema.

Patrones habituales de compartición:

• Dentro de un equipo
  Ejemplo: el equipo de Seguridad publica «Cliente ACME – Gap Assessment ISO 27001» adaptado a cómo ACME interpreta ciertos controles.

• Entre líneas de negocio
  Ejemplo: un equipo de consultoría GRC publica «SOC 2 Readiness – Edición Consultoría» para que cualquier consultor pueda ejecutar el mismo flujo con sus clientes.

• Por segmento de cliente
  Ejemplo: «Informes clínicos – Sponsors de oncología» vs. «Informes clínicos – Dispositivos médicos».

Puedes seguir iterando:

• Crear la v1.1 con pequeñas mejoras
• Migrar los nuevos proyectos a la versión más reciente
• Decidir caso por caso si los proyectos existentes deben actualizarse

8. Escenarios multi‑cliente y multi‑tenant

Si eres consultor o proveedor de servicios gestionados, podrías:

• Atender a varios clientes en el mismo tenant de Rakenne
• Querer que cada cliente tenga sus propios proyectos, pero comparta skills comunes

El patrón habitual es:

1. Crear / hacer fork de tus skills «versión consultoría» una sola vez.
2. Publicarlas en la biblioteca de tu tenant.
3. Para cada cliente:
   • Crear proyectos específicos de ese cliente
   • Instalar las mismas skills en esos proyectos
4. Usar datos específicos de cada cliente (proyectos y documentos) con los mismos flujos de trabajo por detrás.

Esto te da:

• Metodología consistente entre clientes
• Aislamiento de datos a nivel de proyecto
• Un único lugar (la skill) donde actualizar tu enfoque cuando cambian normas o buenas prácticas

9. Poniéndolo todo junto: un ejemplo concreto

Imagina que eres consultor GRC preparando a varios clientes para la certificación ISO 27001.

Un flujo realista podría ser:

1. Encontrar skills en la biblioteca

   • Buscar «ISO 27001» e identificar:
     • «Inventario de activos ISO 27001»
     • «SoA ISO 27001»
     • «Evaluación de riesgos ISO 27001»
     • «Alcance y contexto del ISMS ISO 27001»
     • «Revisión por la dirección ISO 27001»

2. Instalar las skills en un proyecto de cliente

   • Crear el proyecto: «Cliente A – ISMS ISO 27001».
   • Instalar esas skills ISO en el proyecto.

3. Ejecutar sesiones con el cliente

   • Usar la skill de Alcance y contexto para definir los límites del ISMS.
   • Usar Inventario de activos para conducir talleres con stakeholders.
   • Usar Evaluación de riesgos y SoA para generar resultados estructurados.

4. Ajustar el enfoque

   • Ver que tu firma tiene un checklist adicional para la revisión por la dirección.
   • Hacer fork de la skill de Revisión por la dirección, añadir ese checklist y el estilo de presentación, y publicarla como «Consultoría GRC – Revisión por la dirección».

5. Escalar a otros clientes

   • Para «Cliente B – ISMS ISO 27001», instalar tu skill versión consultoría de Revisión por la dirección en lugar de la estándar.
   • Todos los proyectos comparten ahora el mismo flujo mejorado.

No has tocado APIs ni código: solo has trabajado con skills, proyectos y la interfaz de la biblioteca.

10. Próximos pasos

Si es la primera vez que trabajas con skills en Rakenne:

• Paso 1: Abre un proyecto que ya uses y mira la lista de Skills instaladas.
• Paso 2: Visita la Biblioteca de Skills y elige una skill nueva para probar en ese proyecto.
• Paso 3: Para un proceso que repites entre clientes, piensa si merece su propia skill con fork.

Con el tiempo, tu Biblioteca de Skills se convierte en un catálogo vivo de cómo trabaja realmente tu organización, no solo de cómo están escritas las normas.
Ahí es donde Rakenne brilla.