CtrlK
BlogDocsLog inGet started
Tessl Logo

metodologia-copywriting

Persuasive writing for executive audiences — value propositions, calls to action, cost-of-inaction narratives, and compelling summaries. Use when generating executive summaries, pitch narratives, scenario value propositions, recommendation justifications, or any prose that must drive a decision.

SKILL.md
Quality
Evals
Security

Copywriting — Persuasive Executive Communication

Transforms technical findings into decision-driving prose. Owns value propositions, calls to action, cost-of-inaction narratives, executive summaries, and recommendation justifications across all discovery deliverables.

Guiding Principle

The best copy does not convince — it reveals what the reader already knows but has not articulated. A C-level executive knows they have technical debt. They do not need to be told. They need the cost of inaction quantified and a clear path shown with options. Copy transforms data into decisions.

Persuasion Philosophy

  1. Evidence before assertion. Never "we believe that" — always "the data shows that." Every claim carries a number, a source, or an explicit assumption.
  2. Demonstrated urgency, not declared. Not "it is urgent to act." Instead "the cost of inaction is X FTE-months/quarter, equivalent to..."
  3. Options, not mandates. The decision-maker chooses. The consultant recommends with evidence and trade-offs.
  4. Radical conciseness. Every word must earn its place. If a sentence does not add information or move the reader, it is eliminated.

Inputs

  • $1 — Target audience: ceo, cto, cfo, board, mixed (default: mixed)
  • $2 — Deliverable context: pitch, scenario, roadmap, summary, recommendation (default: summary)

Parse from $ARGUMENTS.

Techniques Arsenal

Value Proposition Construction

Structure: [Quantified benefit] + [for whom] + [eliminating what pain] + [in what timeframe]

Example:
  BAD: "Improve the system architecture"
  GOOD: "Reduce time-to-market from 12 to 4 weeks, freeing 3 FTE-months/quarter
      currently consumed by workarounds in the legacy system"

Cost-of-Inaction (COI) Narrative

Pattern: [Quantified current state] → [Trend if no action] → [Cumulative impact] → [Point of no return]

Framing: "Each quarter without action costs [X] and accumulates [Y] of additional technical debt.
          In [Z] months, the remediation cost exceeds the transformation cost."

Problem-Agitate-Solve (PAS)

PhasePurposeTechnique
ProblemState pain with dataMetrics, benchmarks, evidence tags
AgitateShow consequences of inactionCOI projection, trend extrapolation
SolvePresent solution with options3 scenarios, recommended path highlighted

Call to Action Design

Structure: [Specific action] + [concrete timeline] + [immediate next step] + [what happens if not]

Example:
  BAD: "It is recommended to proceed with modernization"
  GOOD: "Approving scenario B (incremental modernization) this week allows
      starting Sprint 0 in Q2 and capturing the first quick win (API gateway)
      before July. → Next step: alignment workshop with technical team."

Tone Calibration by Audience

AudienceToneLead WithAvoid
CEOStrategic, visionaryCompetitive advantage, positioningTechnical jargon, implementation details
CTOTechnical-strategicTechnical risk, modernizationExcessive simplifications
CFOFinancial, quantitativeNPV, payback, cost avoidanceNarratives without numbers
BoardGovernance, fiduciaryRisk-adjusted ROI, complianceOperational detail
MixedProgressive: impact → technicalImpact headline + progressive depthAssuming a single profile

Anti-Patterns

Anti-PatternCorrection
"It is worth noting that..."Eliminate — go straight to the point
"It is important to highlight..."Eliminate — if it were important, it needs no announcement
"It is recommended to consider..."Recommend directly with evidence
Passive voice without agentActive voice: who does what
Numbers without contextAlways compare: vs baseline, vs industry, vs target
Assertions without evidenceMandatory tag: [CÓDIGO], [CONFIG], [DOC], [INFERENCIA]
Superlatives without support"The best" → "Superior by X% according to [metric]"

Output Configuration

  • Language: Spanish (Latin American, business register — simple, clear, concise, direct)
  • Attribution: Expert committee of the MetodologIA Discovery Framework
  • Tagline: "Construido por profesionales, potenciado por la red agéntica de MetodologIA."

Validation Gate

Before delivery, every copy section must pass:

CriterionCheck
Every claim has evidence tag[CÓDIGO], [CONFIG], [DOC], [INFERENCIA], [SUPUESTO]
Every number has contextvs baseline, vs benchmark, vs target
COI is quantifiedFTE-months, cost/quarter, trend projection
CTA is specificAction + timeline + next step
Zero filler phrasesNo filler constructions, no "undoubtedly"
Audience tone matchCalibrated per target audience

Supuestos y Limites

  • El input contiene hallazgos tecnicos ya validados; esta skill transforma, no investiga.
  • El copy se produce en espanol (registro empresarial latinoamericano) salvo indicacion explicita.
  • NUNCA producir precios. Solo FTE-meses, magnitudes, cost drivers.
  • NUNCA usar verde (#00FF00) para exito. Usar gold (#22D3EE) en contexto MetodologIA.
  • Esta skill posee calidad de prosa y persuasion. NO posee arco narrativo entre entregables (eso es storytelling) ni visualizacion de datos (eso es data-storytelling).

Casos Borde

Caso BordeEstrategia de Manejo
No hay datos cuantitativos disponiblesUsar evidencia cualitativa con tags [INFERENCIA] explicitos. Enmarcar como "basado en patrones observados en [N] archivos/modulos/entrevistas". Declarar limitacion en la primera linea del entregable.
Multiples audiencias en el mismo documentoAplicar progressive disclosure: headline ejecutivo + detalle tecnico expandible. Usar callouts diferenciados por audiencia. Nunca asumir un solo perfil de lector.
Recomendacion controversial o con riesgo politicoPresentar todas las opciones con igual rigor. Recomendar con evidencia explicita. Documentar dissent en registro de riesgos. Incluir seccion "Consideraciones Alternativas" antes del CTA.
El cliente solicita copy en idioma diferente al espanolProducir en el idioma solicitado manteniendo la estructura y tecnicas. Documentar terminologia clave en ambos idiomas. Priorizar claridad sobre estilo literario.

Decisiones y Trade-offs

DecisionJustificacionAlternativa Descartada
Evidencia antes que afirmacion como regla absolutaCredibilidad con audiencias ejecutivas requiere datos primero. Un C-level detecta copy sin sustento en segundos.Afirmar y luego justificar: percibido como opinion no fundamentada.
Opciones sobre mandatos (3 escenarios)El decision-maker elige; el consultor recomienda con evidencia. Aumenta ownership de la decision.Recomendacion unica: percibida como imposicion, genera resistencia.
Conciseness radical sobre exhaustividadTiempo de atencion ejecutivo es limitado. Cada palabra debe aportar informacion o mover al lector.Prosa exhaustiva: pierde la audiencia ejecutiva en el segundo parrafo.
COI cuantificado sobre urgencia declarada"El costo de inaccion es X FTE-meses/trimestre" es verificable y accionable. "Es urgente actuar" es opinion.Urgencia declarada: no diferencia de cualquier otra recomendacion.

Knowledge Graph

graph TD
    subgraph Core["Core: Copywriting"]
        VP[Value Proposition]
        COI[Cost-of-Inaction]
        CTA[Call to Action]
        PAS[Problem-Agitate-Solve]
    end

    subgraph Inputs["Inputs"]
        AUD[Audiencia Target]
        FIND[Hallazgos Tecnicos]
        METRICS[Metricas y Datos]
        CTX[Contexto del Entregable]
    end

    subgraph Outputs["Outputs"]
        EXEC_SUM[Executive Summary]
        PITCH[Pitch Narrative]
        SCENARIO[Scenario Value Props]
        RECO[Recommendation Copy]
    end

    subgraph Related["Related Skills"]
        STORY[storytelling]
        DATASTORY[data-storytelling]
        TECHWRITE[technical-writing]
        EDITORIAL[editorial-director]
    end

    AUD --> VP
    FIND --> PAS
    METRICS --> COI
    CTX --> CTA
    VP --> EXEC_SUM
    COI --> PITCH
    PAS --> SCENARIO
    CTA --> RECO
    STORY --> Core
    DATASTORY --> METRICS
    TECHWRITE --> FIND
    EDITORIAL --> Core

Output Templates

Template 1: Executive Summary (Markdown)

Filename: Executive_Summary_{project}_{WIP|Aprobado}.md

# Resumen Ejecutivo: {project}

## Headline
{Una linea: beneficio cuantificado + para quien + eliminando que dolor}

## Situacion Actual
{2-3 parrafos: estado actual con evidencia [TAGS], metricas con contexto}

## Costo de Inaccion
{Proyeccion cuantificada: FTE-meses/trimestre, tendencia, punto de no retorno}

## Opciones
| Escenario | Inversion (FTE-meses) | Beneficio | Timeline | Riesgo |
|---|---|---|---|---|

## Recomendacion
{Escenario recomendado con justificacion basada en evidencia}

## Siguiente Paso
{Accion especifica + timeline + que pasa si no se actua}

Template 1b: Executive Summary (HTML, bajo demanda)

Filename: Executive_Summary_{project}_{WIP|Aprobado}.html

HTML self-contained branded (Design System MetodologIA v5). Dark-First Executive. Incluye headline hero con metricas de impacto, COI projection visual, y comparativa de escenarios con CTA destacado. WCAG AA, responsive.

Template 1c: Executive Summary (DOCX, bajo demanda)

Filename: {fase}_Executive_Summary_{project}_{WIP}.docx Via python-docx con Design System MetodologIA v5. Cover page, TOC auto, headers/footers branded, tablas zebra. Poppins headings (navy), Montserrat body, gold accents.

Template 1d: Executive Summary (XLSX, bajo demanda)

Filename: {fase}_Executive_Summary_{cliente}_{WIP}.xlsx Via openpyxl con MetodologIA Design System v5. Headers con fondo navy y tipografía Poppins en blanco, conditional formatting por escenario y prioridad, auto-filters en todas las columnas, valores directos sin fórmulas.

Template 1e: Executive Summary (PPTX, bajo demanda)

Filename: {fase}_{entregable}_{cliente}_{WIP}.pptx Via python-pptx con MetodologIA Design System v5. Slide master con gradiente navy, titulos Poppins, cuerpo Montserrat, acentos gold. Max 20 slides (ejecutiva) / 30 slides (tecnica). Speaker notes con referencias de evidencia. Para comites directivos y presentaciones C-level.

Template 2: Pitch Narrative (HTML)

Filename: Pitch_{project}_{WIP|Aprobado}.html

Estructura HTML con secciones:
- Hero: headline con metricas de impacto
- Problem: estado actual con datos y evidencia visual
- Agitate: costo de inaccion con proyeccion temporal
- Solve: 3 escenarios con comparativa visual
- CTA: accion recomendada con timeline y siguiente paso
- Footer: atribucion MetodologIA + evidencia tags summary
Estilo: colores MetodologIA (#6366F1 primary, #0F172A background)

Evaluacion

DimensionPesoCriterio
Trigger Accuracy10%Se activa ante solicitudes de copy ejecutivo, pitch, value proposition, CTA, o resumen persuasivo
Completeness25%Incluye value proposition construida, COI cuantificado, CTA especifico, y tono calibrado por audiencia
Clarity20%Cero frases de relleno; cada afirmacion tiene evidencia; voz activa predominante
Robustness20%Produce copy efectivo con datos parciales, multiples audiencias, y recomendaciones controversiales
Efficiency10%Genera copy listo para entrega con parametros minimos (audiencia + contexto)
Value Density15%Cada parrafo contiene informacion accionable; ratio de conversion dato-a-decision es alto

Umbral minimo: 7/10

Cross-References

  • metodologia-storytelling — Arco narrativo cross-deliverable que el copy apoya
  • metodologia-data-storytelling — Metricas interpretadas que el copy consume
  • metodologia-technical-writing — Precision documental que el copy transforma en prosa ejecutiva
  • metodologia-editorial-director — Coordinacion editorial cross-entregable

Limits

  • This skill owns prose quality and persuasion. It does NOT own narrative arc across deliverables (that's editorial-director) or data visualization (that's metodologia-data-viz-storytelling).
  • NEVER produce prices. Only FTE-months, magnitudes, cost drivers.
  • NEVER use green (#00FF00) for success in any output. Use gold (#22D3EE).
Repository
JaviMontano/mao-discovery-framework
Last updated
First committed

Also appears in

JaviMontano/mao-pm-apex
In sync

since Aug 28, 2026

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.