| name | consulting-slide-rulebook |
| description | Usa a crear decks de consultora con rulebook de arquetipos. |
| version | 2.1.0 |
| tags | ["consulting","slides","decks","presentaciones","arquetipos","pptx","skill"] |
| related_skills | ["ppt-master","powerpoint","html-to-pdf-report-pipeline"] |
| author | Mastermind (scout stars-explorer) |
| license | MIT |
| metadata | {"hermes":{"tags":["consulting","slides","pptx"],"related_skills":["ppt-master","powerpoint"]}} |
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
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
- 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.
