metodologia-content-forge

name: metodologia-content-forge description: > Forja contenido brand-compliant MetodologIA desde lenguaje natural. Combina Brand Voice v4.0 (Minto-First + lista roja con prohibición de "gratis"/ "gratuito") con estética Neo-Swiss Clean and Soft Explainer (paleta exclusiva navy #122562 / gold #FFD700 / blue #137DC5 / dark #1F2833 / lilac #BBA0CC / gray #808080 + Poppins/Montserrat/Trebuchet). Genera Markdown, HTML self-contained, slide decks, posts LinkedIn, emails, playbooks. Activa para frases como "post MetodologIA", "playbook MetodologIA", "audita esta pieza con voz MetodologIA", "genera HTML brand-ready MetodologIA", "crea contenido con voz Minto", "reescribe esto con voz MetodologIA". Use proactively cuando el usuario pida contenido educativo o de marca MetodologIA. argument-hint: "<descripción NL del contenido a generar>" allowed-tools: Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion license: CC BY-NC-SA 4.0 version: 1.0.0 author: Javier Montaño · MetodologIA model: opus

metodologia-content-forge v1.0.0

Misión: convertir lenguaje natural en piezas brand-compliant MetodologIA · voz Minto-First v4.0 + estética Neo-Swiss Clean and Soft Explainer · genera Markdown + HTML + briefs para imagen/slide.

Cuándo activar

NO activar cuando:

• Pieza es para otra marca (Sofka, JM Labs, etc.) → otra skill
• Pieza es código pesado (React app) → usar frontend-design
• DOCX/XLSX/PPTX directo → usar brand-docx / brand-xlsx / brand-pptx

Workflow · 5 fases

NL → [INTAKE] → [REASON] → [COMPOSE] → [GENERATE] → [DELIVER]

Fase 1 · INTAKE

Parsear NL y extraer:

Si falta info crítica · preguntar con AskUserQuestion · máximo 3 preguntas.

Fase 2 · REASON

Aplicar reglas de references/01-brand-voice-v4.md + 02-aesthetic-neo-swiss-v1.md:

1. Determinar modo Minto (Micro/Completo/Ultracorto) según density + surface
2. Elegir MECE según audiencia (B2C: Claridad/Sistema/Continuidad · B2B: Gobernanza/Capacidades/Tecnología · Ejec: Riesgo/Retorno/Implementación)
3. Anclar pilares [P1/P2/P3] por soporte
4. Si include_visual: aplicar tokens de assets/color-tokens.json + componentes M1-M10
5. Generar reason.json

Fase 3 · COMPOSE

Sintetizar spec.json:

{
  "meta": { "surface": "...", "audience": "...", "density": "...", "lang": "es-latam" },
  "voice": { "mode": "minto-completo", "pillars": ["P1","P2","P3"] },
  "structure": {
    "conclusion": "...",
    "supports": [
      { "text": "...", "pillar": "P1", "evidence": { "type": "DATO", "value": "..." } },
      { "text": "...", "pillar": "P2", "evidence": { "type": "INDICADOR-SUGERIDO", "value": "..." } }
    ],
    "cta": { "verb": "...", "object": "...", "context": "..." }
  },
  "aesthetic": {
    "palette": "neo-swiss-default",
    "components": ["M1","M2","M5","M10"],
    "dark_mode": false
  },
  "footer": "MetodologIA · Javier Montaño · CC BY-NC-SA 4.0 · 2026"
}

Self-critique (prompts/critique-system.md): valida lista roja · MECE · evidencia · CTA · paleta · tipografía. Si falla, regenera (max 1 intento).

Fase 4 · GENERATE

Fase 5 · DELIVER

1. python scripts/validate_voice.py <output> → reporte voz
2. Si HTML: python scripts/validate_brand.py <output> → reporte estética
3. Si HTML: python scripts/preview.py <output> (abre browser)
4. Imprime ghost menu con próximos pasos

Decision tree NL → output

Architecture

metodologia-content-forge/
├── SKILL.md (este archivo)
├── README.md (quick start)
├── CHANGELOG.md
├── LICENSE.md
├── references/
│   ├── 01-brand-voice-v4.md (fuente única voz · ROJA + JERARQUÍA "sin fricción")
│   ├── 02-aesthetic-neo-swiss-v1.md (paleta · tipografía · componentes M1-M10)
│   ├── 03-nudge-phrases.md (8 nudges canónicos · combos)
│   ├── 04-prompt-templates.md (T1-T8 templates copy-paste)
│   ├── 05-anti-patterns.md (lo que NUNCA hacer)
│   └── 06-decision-tree.md (NL → spec)
├── data/
│   ├── content-types.csv (post · email · playbook · slide · landing · cartilla)
│   ├── voice-modes.csv (minto-completo · minto-micro · ultracorto · auditoria)
│   ├── audiences.csv (b2c · b2b · ejecutivo · mixto + MECE preferido)
│   └── components.csv (M1-M10 con uso · props · anti-patrones)
├── scripts/
│   ├── validate_voice.py (verifica lista roja · "gratis" · gates Minto)
│   ├── validate_brand.py (verifica paleta · tipografía · WCAG · estructura HTML)
│   ├── build_md.py (genera Markdown desde spec)
│   ├── build_html.py (genera HTML self-contained desde spec)
│   ├── build_image_prompt.py (genera prompt para Midjourney/DALL-E)
│   ├── preview.py (abre browser)
│   └── tests/ (smoke tests)
├── templates/
│   ├── html-shell.html.j2 (shell brand-ready Neo-Swiss)
│   └── components/ (M1-M10 snippets)
├── assets/
│   ├── color-tokens.json (single source of truth · 6 colores + derivados)
│   └── examples/ (specs JSON pre-llenados)
├── prompts/
│   ├── intake-system.md
│   ├── compose-system.md
│   └── critique-system.md
├── outputs/ (HTMLs brand-ready: voice-v4 + aesthetic-v1)
└── examples/ (walkthroughs)

Lista roja · 0 tolerancia (verificada por script)

Tokens canónicos (referencia rápida)

Tipografía: Poppins (head) + Montserrat (body) + Trebuchet MS (notes).

Fuente única: assets/color-tokens.json. NUNCA hardcodear hex en otro lado.

Validación obligatoria · checklist

Voz (validate_voice.py)

[ ] 0 lista roja (incluye "gratis"/"gratuito")
[ ] Estructura Minto presente (Conclusión + Soportes + Evidencia + CTA)
[ ] Cada soporte ancla a [P?]
[ ] CTA con verbo + objeto + contexto
[ ] Español latino neutro · trato tú

Brand visual (validate_brand.py · solo HTML)

[ ] Solo 6 colores canónicos + neutrales/derivados
[ ] Tipografías: Poppins + Montserrat + Trebuchet (presentes)
[ ] WCAG AA mínimo · contraste 4.5:1 / 7:1
[ ] Footer con MetodologIA · Javier Montaño · CC BY-NC-SA 4.0
[ ] Footer NO contiene "gratis" ni derivados

Quick start

cd ~/.claude/skills/metodologia-content-forge

# Validar voz de una pieza existente
python scripts/validate_voice.py archivo.md

# Validar brand visual de un HTML
python scripts/validate_brand.py archivo.html

# Ver outputs canónicos pre-generados
open outputs/metodologia-brand-voice-v4.html
open outputs/metodologia-aesthetic-neo-swiss-v1.html

Ghost menu post-generación

Tras generar pieza · ofrecer:

Generado: pieza.md (1234 chars · voz validated · 0 lista roja)

Próximos pasos:
1) Validar voz: python scripts/validate_voice.py pieza.md
2) Convertir a HTML: python scripts/build_html.py spec.json --out pieza.html
3) Generar imagen: python scripts/build_image_prompt.py spec.json
4) Auditoría rigurosa: aplicar T2 con rúbrica /20
5) Compartir: copy a clipboard (pbcopy < pieza.md)

Out of scope (v1.0)

• Otras marcas (Sofka, JM Labs, AAD, etc.) · esta skill es MetodologIA-only
• Generación de DOCX/PPTX/XLSX nativo (usar skills dedicadas downstream)
• Generación de imagen real (devuelve prompts para Midjourney/DALL-E)
• React/Vue components (usar frontend-design o sofka-ui-pro-max)
• Multi-idioma simultáneo (es default · en bajo demanda)

Referencias cruzadas

• Brand Voice fuente: references/01-brand-voice-v4.md
• Estética fuente: references/02-aesthetic-neo-swiss-v1.md
• Nudges atómicos: references/03-nudge-phrases.md
• Templates de prompts: references/04-prompt-templates.md
• Skill compañera: aprender-aprehender-revolucionar (contenido educativo)

v1.0.0 · CC BY-NC-SA 4.0 · MetodologIA · Javier Montaño · 2026