Revisada el 2026-10-12
Skill de Claude Code que convierte la imagen de un mapa mental en una hoja de referencia A4 de una página. Cada rama es una tarjeta, los ejemplos se comprueban y el PDF se exporta con Chrome sin interfaz.
Sirve para material de estudio propio. La hoja se redacta con palabras propias y no reproduce textos ni imágenes de obras protegidas. Para el proceso explicado paso a paso, véase la ficha de estudio.
| Datos clave | |
|---|---|
| Formato | Skill de Claude Code (SKILL.md)1 |
| Idioma | Español |
| Instalación | Global: ~/.claude/skills/generar-pdf-desde-mapa-mental/SKILL.md. Solo un proyecto: .claude/skills/generar-pdf-desde-mapa-mental/SKILL.md1 |
Prompt
Copia el bloque completo en un archivo SKILL.md. La cabecera inicial (name y description) es la que usa Claude Code para decidir cuándo ofrecer la skill.1
---
name: generar-pdf-desde-mapa-mental
description: Convierte un mapa mental (imagen exportada de NotebookLM/Gemini u otra herramienta) en una hoja de referencia A4 imprimible en PDF para estudiar. Lee la imagen, reorganiza las ramas en tarjetas de color, añade ejemplos comprobados y exporta con Chrome headless. Funciona en cualquier proyecto, sin archivos externos. Actívala cuando el usuario pegue un mapa mental y pida "un doc/PDF para imprimir", "ficha de estudio", "hoja resumen A4" o "/generar-pdf-desde-mapa-mental".
---
Convierte un mapa mental en una ficha de estudio A4 de una sola página. Autocontenida: la plantilla de estilos va en este mismo archivo.
## Entrada
- Comprueba que el mapa parte de material propio, de dominio público o con una licencia o autorización que permita resumirlo. La hoja se redacta con palabras propias y no reproduce textos ni imágenes de una obra protegida.
- Imagen del mapa mental (pegada en el chat o ruta a un PNG/JPG). Si el texto no se lee bien, pide una imagen mejor antes de inventar nada. Conviene que el mapa tenga todas las ramas expandidas; si se ven ramas cerradas, avisa.
- Curso y asignatura (si no constan en el proyecto, pregúntalo una vez).
## Requisitos
- Google Chrome (o Chromium). Ruta en macOS: `/Applications/Google Chrome.app/Contents/MacOS/Google Chrome`; en Linux, `google-chrome` o `chromium`.
- `pdfinfo` y `pdftoppm` (paquete poppler; en macOS, `brew install poppler`). Si faltan, dilo y no des la verificación por hecha.
## Pasos
1. Lee el mapa y trasládalo a un esquema: una rama principal = una tarjeta. Las ramas con 4-7 hojas sueltas y paralelas (p. ej. criterios) van en tabla.
2. Reescribe cada hoja en frase corta, para el alumno de la edad indicada. Trato de "tú" si se dirige a él; sin jerga que no sea del temario.
3. Añade un ejemplo por tarjeta que no esté en el mapa. Compruébalo a mano (cuentas, resultados) antes de escribirlo. Dilo en la respuesta final.
4. Escribe el HTML con la base de abajo: rejilla de 2 columnas, una tarjeta por rama con un color distinto (`a` a `e`), tabla a ancho completo en una tarjeta `full`, y un bloque `ej` blanco para los ejemplos. Cambia `<title>`, `<h1>` y el subtítulo (curso · asignatura).
5. Guarda el HTML en `output/borradores/` si el proyecto tiene esa carpeta; si no, en el directorio de trabajo. Nombre descriptivo: `<tema>-resumen.html`.
6. Exporta a PDF desde esa carpeta:
`"<ruta de Chrome>" --headless --disable-gpu --no-pdf-header-footer --print-to-pdf=<tema>-resumen.pdf <tema>-resumen.html`
7. Verifica: `pdfinfo` debe dar 1 página A4. Si sale en 2, baja `font-size` del body (9 pt es el mínimo cómodo), reduce los márgenes de `@page` (8 mm) y el padding de las tarjetas; si aun así no cabe, ofrece dos hojas. Renderiza con `pdftoppm -png -r 70` y mira la imagen: nada cortado, tabla legible.
8. Entrega: ruta del PDF y del HTML, qué ejemplos se han añadido, y ofrece variantes (letra más grande, dos hojas, hueco para ejemplos propios). Pasa a `output/finales/` solo si el proyecto lo usa y el usuario lo aprueba.
## Base HTML
```html
<!doctype html>
<html lang="es"><head><meta charset="utf-8"><title>Tema</title>
<style>
@page{size:A4;margin:8mm}
*{box-sizing:border-box}
body{font-family:"Helvetica Neue",Arial,sans-serif;font-size:9pt;color:#222;margin:0;line-height:1.35}
h1{font-size:17pt;margin:0 0 2mm;color:#2b3a67}
.sub{color:#666;margin:0 0 4mm;font-size:8.5pt}
.grid{display:grid;grid-template-columns:1fr 1fr;gap:4mm}
.card{border:1.5px solid;border-radius:3mm;padding:2mm 3mm;break-inside:avoid;margin-bottom:3mm}
.card h2{font-size:11pt;margin:0 0 1.5mm}
.card h3{font-size:10.5pt;margin:2mm 0 .5mm}
.a{border-color:#3b6fd4;background:#eef3ff}.a h2{color:#3b6fd4}
.b{border-color:#2f9e6b;background:#ecf8f2}.b h2{color:#2f9e6b}
.c{border-color:#d9822b;background:#fff4e6}.c h2{color:#d9822b}
.d{border-color:#8a4fd1;background:#f5eeff}.d h2{color:#8a4fd1}
.e{border-color:#c94a6b;background:#fff0f4}.e h2{color:#c94a6b}
ul{margin:0;padding-left:5mm}li{margin:.5mm 0}
table{border-collapse:collapse;width:100%}
td,th{border:1px solid #d9822b;padding:1mm 2mm;text-align:left;font-size:9pt}
th{background:#ffe3c2}
.ej{background:#fff;border-radius:2mm;padding:1.5mm 2.5mm;margin-top:1.5mm;font-size:9pt}
.full{grid-column:1/-1}
.tree{font-family:Menlo,monospace;font-size:8.5pt;background:#fff;border-radius:2mm;padding:1.5mm 2.5mm;margin-top:1.5mm;white-space:pre}
.grid:last-of-type .card{margin-bottom:0}html,body{height:280mm;overflow:hidden}
</style></head><body>
<h1>Tema</h1>
<p class="sub">Hoja de referencia · curso · asignatura</p>
<div class="grid">
<div class="card a"><h2>Rama 1</h2>
<ul><li>Idea corta.</li></ul>
<div class="ej">Ejemplo comprobado.</div></div>
<div class="card b"><h2>Rama 2</h2>
<ul><li>Idea corta.</li></ul>
<div class="ej">Ejemplo comprobado.</div></div>
</div>
<div class="card c full"><h2>Rama con tabla</h2>
<table><tr><th>Columna</th><th>Columna</th></tr>
<tr><td>Dato</td><td>Dato</td></tr></table></div>
</body></html>
```
## Cuidados
- sed en macOS: `sed -i ''` (con comillas vacías).
- No inventes contenido que contradiga el mapa; si algo del mapa parece incorrecto o ambiguo, dilo.
- Si la hoja es para otro curso, ajusta el vocabulario y deja el resto igual.
- `html,body{height:280mm;overflow:hidden}` evita una segunda página en blanco; si el contenido no cabe, lo recorta, así que revisa siempre la imagen renderizada.Cómo adaptarla
- Cambia la paleta de colores y la tipografía de la base HTML a tu gusto.
- Ajusta el tamaño de letra mínimo y los márgenes si imprimes en otro formato.
- La ruta de Chrome del texto es la de macOS; en Linux, usa
google-chromeochromium. - Si prefieres dos hojas en lugar de una, elimina el límite de altura del
bodyy el paso de verificación de una página.
Véase también
Referencias
Footnotes
-
Extend Claude with skills. Anthropic, documentación de Claude Code. Consultado el 2026-10-10. ↩ ↩2 ↩3