Consulting Slide Rulebook — decks de calidad consultora (McKinsey/BCG)
Fuente: carnot-tech/consulting-pptx-skill (~250⭐, JavaScript, MIT, activo). Renombrado desde gozen3ji/consulting-pptx-skill (mismo repo, verificado por redirect de GitHub el 2026-09-07). Claude Code skill; el 100% de sus patrones son agnósticos de agente.
When to Use
- Crear decks de presentación de calidad consultora: conclusiones en títulos, narrativa izquierda→derecha, tablas con ejes, cero decorativismo.
- Generar PPTX nativo editable desde una especificación JSON (SlideSpec) con preview HTML y QA automático.
- Auditar/mejorar decks ajenos con un rulebook mecanizable.
Qué es (núcleo del repo)
Tres capas, en orden de importancia:
references/slide-rules.md — EL ACTIVO REAL (~110 reglas): observaciones de reviews reales en 1 línea cada una. Ejemplos clave:
- Conclusión en el título (1 línea; si no cabe, 2 líneas agrandando — NUNCA reduciendo fuente). Sin "de/masu" (体言止め). Leer solo los títulos en secuencia debe dar la historia completa.
- Layout: 1 slide = 1 mensaje; izquierda = hechos/diagramas, derecha = implicaciones (nunca arriba/abajo). Prohibida la banda "POINT" inferior.
- Tablas: fila=elemento, columna=ángulo ("tabla con ejes", no tarjetas). Columnas que no aportan a la tesis, fuera.
- Decoración: prohibidos los bordes redondeados; sin borde en cajas con relleno; leyenda obligatoria si hay color.
- "3 factores de IA-parecido": cajas flotantes / explicación redundante sin bullets / frases cortadas sin sujeto-verbo.
- Charts: primero clasificar en 4 formas básicas (tabla / premisa-izq-der / contraste / análisis+comentario); lo creativo sobra en un chart.
- Catálogo de 62 arquetipos (
assets/SlideCatalog_16x9.pdf, assets/SuperTemplate_62type.pptx — 70 slides todas editables nativas; 63 definiciones SlideSpec = 36 tipos + 27 piezas de descripción libre). El catálogo es bloc de notas de layouts, no una camisa de fuerza: se elige el tipo según la narrativa y si no encaja, se tira y se compone libre.
- Pipeline de generación (
pipeline/): SlideSpec JSON → HTML preview → QA → PPTX editable (pptxgenjs) → check mecánico.
Uso — flujo real verificado (contra package.json y SKILL.md del repo, 2026-09-07)
Pasos comunes:
- Definir antes de producir (3-5 líneas): objetivo, entregable, alcance IN/OUT.
- Storyline: 1 título por slide + "cómo mostrarlo" (diagrama / tabla / flecha / 2 columnas / stat-card). Lo que sea tendencia/composición/distribución → gráfico, dibujado a mano, no volcado en pieza de plantilla.
Carril A — descripción libre (el principal, para entregables):
- Copiar
templates/freeform_parts_16x9.html (10 piezas: portada, overview map, tablas con eje, premisa→conclusión 2 col, stat…) y sustituir secciones.
python3 scripts/check_deck.py mi_deck.html → 0 FAIL (WARN de portada permitida).node scripts/check_layout.mjs mi_deck.html → 0 FAIL en solapes/desbordes con render real (requiere playwright).- Fresh-eye review: pasar
references/content-review-prompt.md a otro agente SIN contexto de cómo se hizo que lea el deck crudo (HTML/PDF/PPTX, sin imagen); sus hallazgos → tabla aceptar/rechazar/pendiente con motivo → corregir solo lo aceptado y repetir check.
- PDF final y revisar todas las páginas:
chrome --headless --print-to-pdf=deck.pdf deck.html.
Carril B — pipeline SlideSpec (borradores en segundos / informes repetibles):
cd pipeline && npm run setup # 1 vez: pptxgenjs ^4.0.1 + playwright ^1.60 + chromium
node scripts/validate_spec.mjs slide-spec/mi_deck.json
node scripts/render_spec_to_html.mjs slide-spec/mi_deck.json generated/mi_deck.html
node scripts/qa_html_deck.mjs generated/mi_deck.html
node scripts/export_spec_to_editable_pptx.mjs slide-spec/mi_deck.json generated/mi_deck.pptx
python3 scripts/check_deck.py generated/mi_deck.pptx # 0 FAIL (check PPTX requiere python-pptx)
- Título ≥12 caracteres en afirmación;
source obligatorio; cero placeholders (Text N); en deck no-japonés traducir headers de comparison_table/scenario_table/risk_table/cause_effect vía "headers": {...} (claves en pipeline/slide-spec/schema.json).
- Los 28 arquetipos
.mjs en pipeline/scripts/archetypes/ son el generador por tipo (_ids.json lista el registro completo).
Bucle de calidad (la fuente del valor): los ajustes manuales de cada deck generan nuevas líneas en slide-rules.md — el rulebook se cultiva; catálogo y pipeline solo compran iteraciones rápidas.
Pitfalls
- No confundir versión v1 de este skill: las cifras buenas son 62 arquetipos /
110 reglas (no 38/80; el propio SKILL.md del repo aún dice ~80 — el README manda, colas §4.37-4.48 y §7 añaden hasta ~110).
- Repo transferido: cualquier enlace antiguo a
gozen3ji/* redirige a carnot-tech/*.
check_deck.py: HTML con stdlib; PPTX exige pip install python-pptx.check_layout.mjs necesita chromium instalado (npx playwright install chromium).- El pipeline solo rellena slots del tipo: si una slide no encaja en su molde, NO forzar — salir al carril A para esa slide.
- Para adaptar sin el repo: lo portable es el rulebook (reglas de títulos/lectura/tablas/charts) — funciona igual con python-pptx o HTML propio.
Verificación
- Deck de prueba de 3-4 slides: título de cada slide legible como historia en secuencia, 0 FAIL en
check_deck.py, fresh-eye review con tabla de acepta/rechaza.
Registro (scout stars-explorer)
- 2026-09-03: primera creación (v1 imprecisa) desde
gozen3ji/consulting-pptx-skill (103⭐ de la época).
- 2026-09-05: auditoría → v2.0.0 (cifras corregidas).
- 2026-09-07: re-encuentro del repo como
carnot-tech/consulting-pptx-skill (250⭐, push mismo día) → v2.1.0: comandos verificados contra pipeline/package.json y SKILL.md reales, estructura de 2 carriles, fresh-eye review documentado.
1---2name: consulting-slide-rulebook3description: Usa a crear decks de consultora con rulebook de arquetipos.4license: MIT5---67# Consulting Slide Rulebook — decks de calidad consultora (McKinsey/BCG)89> Fuente: `carnot-tech/consulting-pptx-skill` (~250⭐, JavaScript, MIT, activo). Renombrado desde `gozen3ji/consulting-pptx-skill` (mismo repo, verificado por redirect de GitHub el 2026-09-07). Claude Code skill; el 100% de sus patrones son agnósticos de agente.1011## When to Use1213- Crear **decks de presentación de calidad consultora**: conclusiones en títulos, narrativa izquierda→derecha, tablas con ejes, cero decorativismo.14- Generar **PPTX nativo editable** desde una especificación JSON (SlideSpec) con preview HTML y QA automático.15- Auditar/mejorar decks ajenos con un rulebook mecanizable.1617## Qué es (núcleo del repo)1819Tres capas, en orden de importancia:20211. **`references/slide-rules.md` — EL ACTIVO REAL (~110 reglas)**: observaciones de reviews reales en 1 línea cada una. Ejemplos clave:22 - Conclusión en el título (1 línea; si no cabe, 2 líneas agrandando — NUNCA reduciendo fuente). Sin "de/masu" (体言止め). Leer solo los títulos en secuencia debe dar la historia completa.23 - Layout: 1 slide = 1 mensaje; **izquierda = hechos/diagramas, derecha = implicaciones** (nunca arriba/abajo). Prohibida la banda "POINT" inferior.24 - Tablas: fila=elemento, columna=ángulo ("tabla con ejes", no tarjetas). Columnas que no aportan a la tesis, fuera.25 - Decoración: **prohibidos los bordes redondeados**; sin borde en cajas con relleno; leyenda obligatoria si hay color.26 - "3 factores de IA-parecido": cajas flotantes / explicación redundante sin bullets / frases cortadas sin sujeto-verbo.27 - Charts: primero clasificar en 4 formas básicas (tabla / premisa-izq-der / contraste / análisis+comentario); lo creativo sobra en un chart.282. **Catálogo de 62 arquetipos** (`assets/SlideCatalog_16x9.pdf`, `assets/SuperTemplate_62type.pptx` — 70 slides todas editables nativas; 63 definiciones SlideSpec = 36 tipos + 27 piezas de descripción libre). El catálogo es *bloc de notas de layouts*, **no** una camisa de fuerza: se elige el tipo según la narrativa y si no encaja, se tira y se compone libre.293. **Pipeline de generación** (`pipeline/`): SlideSpec JSON → HTML preview → QA → PPTX editable (pptxgenjs) → check mecánico.3031## Uso — flujo real verificado (contra package.json y SKILL.md del repo, 2026-09-07)3233**Pasos comunes:**341. *Definir antes de producir* (3-5 líneas): objetivo, entregable, alcance IN/OUT.352. *Storyline*: 1 título por slide + "cómo mostrarlo" (diagrama / tabla / flecha / 2 columnas / stat-card). Lo que sea tendencia/composición/distribución → **gráfico, dibujado a mano, no volcado en pieza de plantilla**.3637**Carril A — descripción libre (el principal, para entregables):**38- Copiar `templates/freeform_parts_16x9.html` (10 piezas: portada, overview map, tablas con eje, premisa→conclusión 2 col, stat…) y sustituir secciones.39- `python3 scripts/check_deck.py mi_deck.html` → 0 FAIL (WARN de portada permitida).40- `node scripts/check_layout.mjs mi_deck.html` → 0 FAIL en solapes/desbordes con render real (requiere playwright).41- *Fresh-eye review*: pasar `references/content-review-prompt.md` a **otro agente SIN contexto de cómo se hizo** que lea el deck crudo (HTML/PDF/PPTX, sin imagen); sus hallazgos → tabla aceptar/rechazar/pendiente con motivo → corregir solo lo aceptado y repetir check.42- PDF final y revisar todas las páginas: `chrome --headless --print-to-pdf=deck.pdf deck.html`.4344**Carril B — pipeline SlideSpec (borradores en segundos / informes repetibles):**45```bash46cd pipeline && npm run setup # 1 vez: pptxgenjs ^4.0.1 + playwright ^1.60 + chromium47node scripts/validate_spec.mjs slide-spec/mi_deck.json48node scripts/render_spec_to_html.mjs slide-spec/mi_deck.json generated/mi_deck.html49node scripts/qa_html_deck.mjs generated/mi_deck.html50node scripts/export_spec_to_editable_pptx.mjs slide-spec/mi_deck.json generated/mi_deck.pptx51python3 scripts/check_deck.py generated/mi_deck.pptx # 0 FAIL (check PPTX requiere python-pptx)52```53- Título ≥12 caracteres en afirmación; `source` obligatorio; cero placeholders (Text N); en deck no-japonés traducir headers de `comparison_table`/`scenario_table`/`risk_table`/`cause_effect` vía `"headers": {...}` (claves en `pipeline/slide-spec/schema.json`).54- Los 28 arquetipos `.mjs` en `pipeline/scripts/archetypes/` son el generador por tipo (`_ids.json` lista el registro completo).5556**Bucle de calidad (la fuente del valor):** los ajustes manuales de cada deck generan nuevas líneas en `slide-rules.md` — el rulebook se cultiva; catálogo y pipeline solo compran iteraciones rápidas.5758## Pitfalls5960- **No confundir versión v1 de este skill**: las cifras buenas son 62 arquetipos / ~110 reglas (no 38/~80; el propio SKILL.md del repo aún dice ~80 — el README manda, colas §4.37-4.48 y §7 añaden hasta ~110).61- Repo transferido: cualquier enlace antiguo a `gozen3ji/*` redirige a `carnot-tech/*`.62- `check_deck.py`: HTML con stdlib; PPTX exige `pip install python-pptx`.63- `check_layout.mjs` necesita chromium instalado (`npx playwright install chromium`).64- El pipeline solo rellena slots del tipo: si una slide no encaja en su molde, NO forzar — salir al carril A para esa slide.65- Para adaptar sin el repo: lo portable es el rulebook (reglas de títulos/lectura/tablas/charts) — funciona igual con python-pptx o HTML propio.6667## Verificación6869- Deck de prueba de 3-4 slides: título de cada slide legible como historia en secuencia, 0 FAIL en `check_deck.py`, fresh-eye review con tabla de acepta/rechaza.7071## Registro (scout stars-explorer)7273- 2026-09-03: primera creación (v1 imprecisa) desde `gozen3ji/consulting-pptx-skill` (103⭐ de la época).74- 2026-09-05: auditoría → v2.0.0 (cifras corregidas).75- 2026-09-07: re-encuentro del repo como `carnot-tech/consulting-pptx-skill` (250⭐, push mismo día) → **v2.1.0**: comandos verificados contra `pipeline/package.json` y `SKILL.md` reales, estructura de 2 carriles, fresh-eye review documentado.
ntizar