knowledge-generate

Principio rector: doble audiencia

Todo lo que genera esta skill (estructura, contenido, memoria del agente) tiene que servir igual de bien a una persona leyendo en GitHub que a un agente de IA navegando o editando el repositorio. Esto no es un detalle de estilo, es una restricción de diseño que debe guiar cada paso:

Prefiere estructura predecible (misma forma de hub en cada carpeta, encabezados semánticos consistentes) frente a prosa libre difícil de parsear.
No escondas información relevante solo en formato visual (orden implícito, énfasis tipográfico); si otra skill necesita un dato para decidir dónde guardar o buscar algo (p. ej. la descripción de un contexts), ese dato tiene que quedar explícito en el Markdown, no dar por hecho que "se entiende leyendo".
El contenido generado (hubs, glosarios, cualquier fichero nuevo) se redacta pensando en ambas lecturas a la vez: legible como prosa humana y con enlaces/encabezados que un agente pueda seguir sin ambigüedad.

Propósito

Esta skill es el orquestador del sistema. Lee el fichero KNOWLEDGE.md (el manifiesto) y:

Genera o adapta la estructura de carpetas y ficheros "hub" de la documentación (root/<contexto>/hub.md, root/hub.md).
Genera o actualiza el fichero de memoria del agente (CLAUDE.md y/o AGENTS.md) según memory y agent.
Instala las skills de extensión que el proyecto necesita según las claves activas del manifiesto, mediante npx skills add.

Importante: knowledge-generate genera documentos y memoria, nunca skills. Las skills son ficheros estáticos ya escritos (en este repositorio o, en el futuro, en repositorios de extensiones de la comunidad) que leen KNOWLEDGE.md en tiempo de ejecución y se adaptan a su configuración y a las instrucciones del cuerpo libre.