asguth/grifo

Grifo-Skill

Genera material de estudio nivel universitario sobre cualquier tema, a partir de un tema o de un archivo del usuario: hojas A4 en dos columnas, jerarquía editorial sobria, diagramas, tablas, ilustraciones y preguntas inéditas. Todo pasa por tres revisores (contenido, didáctica, diseño) antes de la entrega.

Las rutas siguientes son relativas a la carpeta de este SKILL.md.

Ruta	Qué es	Cuándo leerla
references/comandos.md	Sintaxis, flags y especificación de cada comando	Siempre: solo la sección "Sintaxis" y la del comando
references/design.md	Paleta, estilos de color, jerarquía, qué componente usar, iconos	Antes del HTML
references/ilustracoes.md	Figura didáctica: archivo abierto, generador, licencia y crédito	Cuando el tema tiene estructura física
references/idiomas.md	Material en otro idioma: etiquetas, fuentes, exámenes de otros países	Si el idioma no es pt-BR
references/componentes.md	HTML de cada componente	Antes del HTML
references/fidelidade.md	Fuentes, citas y referencias con enlace	Antes de investigar
references/bancas.md	Estilo de tribunales de oposiciones	Solo si hay tribunal
agentes/*.md	Prompts de los 3 revisores	Etapa 6
assets/templates/*.html	Esqueleto de cada comando	Inicio de la etapa 4
assets/lucide/nomes.txt	2.052 iconos Lucide (nombre: etiquetas)	Usa grep, nunca lo leas completo
scripts/figura.py	Archivo curado por área, busca/descarga figura con licencia abierta (Commons), genera molécula (RDKit) y gráfico (matplotlib)	Etapa 4, si hay figura
assets/acervo.json	61 figuras verificadas en 10 áreas (leído por figura.py acervo)	No lo leas completo: usa el script
scripts/verificar.py, montar.py, renderizar.py	Lint → HTML autónomo → PDF/PNG + revisión de diseño	Etapa 5

Comandos

/<comando> <tema o archivo> [--formato f] [--estilo e] [--nivel n] [--tribunal t] [--hojas N]
          [--material arq] [--idioma xx]

/resumen, /esquema, /ley-seca, /comparar, /trampas, /preguntas, /flashcards, /mnemónico, /temario, /cronograma, /revision, /apuntes, /validar, /grifo (ayuda). /cmd, cmd: y lenguaje natural → mismo flujo. Flag desconocida → avisar y seguir con el valor por defecto. Comando inexistente → mostrar la ayuda de /grifo. Detalles en references/comandos.md.

Flujo (sigue en orden)

1. Entender la solicitud — y preguntar cuando falte

Si la solicitud no incluye tema/archivo o formato, pregunta una vez, en un único mensaje (en Claude Code, con la herramienta de pregunta si está disponible), ofreciendo opciones:

1. Tema o archivo: "¿Sobre qué tema — o qué archivo (PDF, diapositivas, apuntes) — quieres el material?"
2. Formato:
   • Explicación completa — resumen didáctico (2–4 hojas por defecto, sin límite) + preguntas + solucionario (/resumen);
   • Solo el mapa — esquema visual, 1 hoja por defecto (/esquema);
   • Revisión rápida — víspera, 1 hoja por defecto (/revision);
   • Práctica — preguntas + solucionario comentado (/preguntas) o flashcards;
   • Todo incluido — portada, índice, resumen, mapa, flashcards, preguntas y solucionario (/apuntes).
3. Estilo visual (cada persona aprende de una forma):
   • Sobrio — azul marino y gris, color solo donde tiene significado (predeterminado);
   • Colorido — cada tema con un color diferente, bandas llenas;
   • Pastel — colores por tema en tonos suaves, fondos claros;
   • B/N — tonos de gris, para imprimir en blanco y negro.
4. Nivel (solo si no se puede inferir): secundaria, universidad (predeterminado), oposición (pregunta el tribunal), certificación.

El formato solo cuenta como definido cuando vino de comando con barra (/esquema, /revision…), de --formato, o de palabras explícitas del usuario ("solo el mapa", "revisión rápida", "con preguntas"). En lenguaje natural, "haz unos apuntes/resumen/material de X" no define el formato: pregunta. Cuando preguntes, pregunta también el estilo, en el mismo mensaje. Con tema y formato definidos, no preguntes nada más: estilo no informado = el que el usuario ya usó en esta conversa, si no sobrio (y menciona --estilo colorido|pastel|pb en una línea en la entrega). Solicitudes como "más colorido", "menos color", "para imprimir en B/N" cambian el estilo.

Idioma: escribe el material y responde en el idioma del usuario (o --idioma). Fuera de pt-BR, lee references/idiomas.md antes del HTML. Libertad de creación: elige componentes, orden y énfasis según lo que mejor enseñe.

2. Recopilar el contenido (fidelidad antes que belleza)

Leer references/fidelidade.md. Material del usuario > fuente oficial/primaria > literatura de referencia. Cada número, fecha, fórmula, artículo o definición técnica se verifica; sin fuente accesible → <span class="verificar">. Guarda las fuentes con URL para las referencias.

3. Guion didáctico (nivel universidad)

Para cada subtema: definición precisa → mecanismo/por qué → ejemplo → error común. Elige el componente según la forma del contenido (references/design.md §3) e ilustra todo lo que tiene estructura. Texto corrido solo para concepto, corto y resaltado.

4. Escribir el HTML-fuente a partir de la plantilla

Copia assets/templates/<comando>.html a <slug>-fuente.html y reemplaza todo [[MARCADOR]].

• <html lang="…" data-tema="sobrio|colorido|pastel|pb"> según idioma y estilo (design.md §1.1). Color fijo por tema: class="cor-1" … cor-6 en el bloque/columna.
• Solo clases del sistema de diseño (references/componentes.md); style="" solo para ajuste puntual.
• Sin límite de hojas: el tamaño del comando es el predeterminado, no un techo. El contenido que no cabe va a una nueva .folha; nunca cortes contenido para que quepa, salvo --hojas N del usuario.
• Preguntas siempre en columna única, en una hoja solo para ellas. Solucionario comentado y referencias en hoja separada, después de las preguntas (nada de spoiler en la misma hoja).
• Referencias con enlace: <a href="URL oficial">título</a>.
• Iconos: Lucide (<svg class="ico"><use href="#l-NOMBRE"/></svg>, busca el nombre con grep -i termino assets/lucide/nomes.txt), solo cuando aportan algo al bloque.
• Tema con estructura física (anatomía, fisiología, célula, planta, molécula, circuito, montaje de laboratorio, mapa): la figura es el centro de la hoja y viene de archivo abierto (scripts/figura.py acervo, luego buscar/descargar) o de generador a partir de datos (figura.py molecula, figura.py grafico). Nunca dibujes estructura académica de memoria: la IA se equivoca en anatomía sin darse cuenta. Crédito obligatorio. Método en references/ilustracoes.md.

5. Verificar, montar y renderizar

python3 <skill>/scripts/verificar.py <slug>-fuente.html
python3 <skill>/scripts/montar.py <slug>-fuente.html <slug>.html     # [--fuentes-incrustadas]
python3 <skill>/scripts/renderizar.py <slug>.html <salida> --json     # [--pb]

Corrige todo ERROR del lint y toda advertencia de diseño (desbordamiento, texto que sobresale, columnas desequilibradas, fuente < 8 pt) antes de continuar. Sin Python/navegador: entrega el HTML (Ctrl+P → A4, sin márgenes, gráficos de fondo).

6. Validación (3 revisores que no escribieron el material)

Con subagentes: ejecuta los tres en paralelo, cada uno con su agentes/*.md + rutas del HTML y de los PNGs + fuentes usadas. Sin subagentes: tres pases en secuencia, releyendo desde cero. Corrige BLOQUEANTES e IMPORTANTES, vuelve a montar y renderizar (máx. 2 rondas).

7. Entregar

HTML + PDF. En 2–4 líneas: qué se generó, estilo usado, [VERIFICAR] restantes, fuentes principales y créditos de las figuras. Termina con una línea de aviso: material generado con IA como apoyo al estudio; no sustituye libros, clases ni fuentes oficiales; verifica.

Reglas innegociables

1. Fidelidad > estética. Nada de memoria sin verificar; duda = [VERIFICAR].
2. Derechos de autor. No copiar texto, esquemas ni preguntas de terceros. Imagen de terceros solo con licencia abierta (CC0, dominio público, CC BY, CC BY-SA) y crédito. Actos oficiales pueden citarse literalmente (Ley 9.610/98, art. 8º, IV).
3. Sin retratos de personas reales (menciona el nombre del autor en el texto).
4. Legible en B/N. El color nunca es el único portador de significado: icono + etiqueta. En figura, la leyenda indica qué significa cada color.
5. Densidad de apuntes. Frases directas, sin "en este resumen veremos"; bloque > 6 líneas sin destaque = reescribir.
6. Aviso de IA en cada hoja. El pie de página ya imprime "generado con IA: verifica en las fuentes" (vía CSS, traducido por lang); no lo elimines. El material auxilia el estudio y no sustituye libro, clase, atlas, ley oficial ni orientación profesional.