Communitygithub.com

moshuying/pitchcraft

Habilidad de informe · pitchcraft — Persuasión estructurada para líderes técnicos, PMs y fundadores: inicio, estado, cierre, presentación y venta de soluciones en un marco de 5 partes (Gancho→Contexto→Propuesta→Evidencia→Solicitud), con ingesta de material de IA y lista de verificación previa al envío. Funciona con Claude Code, Cursor, Codex y más.

¿Qué es pitchcraft?

Pitchcraft es una habilidad de agente de IA diseñada para ayudar a desarrolladores, líderes técnicos, gerentes de producto y fundadores a elaborar informes persuasivos y presentaciones estructuradas. A diferencia de la redacción de informes tradicional, se centra en la persuasión: ayudar a una audiencia específica a comprender el contexto, confiar en el juicio del presentador y brindar el apoyo necesario en un tiempo limitado. La habilidad se basa en un marco central de 5 partes (Gancho, Contexto, Propuesta, Evidencia, Solicitud) que se adapta a cinco tipos de escenarios: inicio de proyecto, actualización de estado, cierre/revisión anual, presentación para inversores y venta de soluciones. Pitchcraft ofrece plantillas detalladas para cada escenario, junto con reglas de escritura claras (como priorizar las preocupaciones de la audiencia, respaldar métricas con fuentes y no dejar tareas abiertas para la audiencia). El flujo de trabajo integra la carga de memoria, la selección de escenarios, la ingesta de material, el borrado basado en plantillas, una lista de verificación final y la confirmación del usuario. Es compatible con Claude Code, Cursor, Codex y otras plataformas similares.

Compatible con✓Claude Code✓Codex CLI✓Cursor
npx skills add moshuying/pitchcraft

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Idiomas: English (this file) · 简体中文 → SKILL.zh-CN.md

Informes persuasivos · Flujo de trabajo

Esencia

Esto no es escribir informes, es persuasión. En cada escenario haces lo mismo:

En tiempo limitado, ayuda a una audiencia específica a entender el contexto, confiar en tu criterio y proporcionar el apoyo que necesitas.

Usuarios y escenarios

RolEscenariosAudiencia
Líder técnico / gerente de ingenieríaInicio, revisión de hitos, cierreLíderes empresariales, CTO, PMO
PM / líder de productoRevisión trimestral, resumen anual, revisión de requisitosDirector, VP
Fundador / dueño de negocioPresentación a inversoresInversores, socios
Preventa / solucionesVenta de solucionesEjecutivos de clientes, evaluadores técnicos

Núcleo: Marco de persuasión en 5 partes

Todos los tipos de informes comparten una columna vertebral; el énfasis de la sección varía.

Parte 1 · Gancho
  → ¿Por qué deberían seguir escuchando?
  → Oportunidad / dolor / urgencia

Parte 2 · Contexto
  → ¿Cuál es la situación?
  → Lo que hemos hecho y lo que tenemos

Parte 3 · Propuesta
  → ¿Qué haremos / hicimos?
  → Alcance, camino, ritmo

Parte 4 · Evidencia
  → ¿Por qué podemos tener éxito / tuvimos éxito?
  → Datos, ventaja competitiva, equipo, casos

Parte 5 · Solicitud
  → ¿Qué necesitamos de ellos?
  → Decisión / recursos / asociación / inversión

Tipos de informes y plantillas

Cada tipo es una instancia del marco de 5 partes.

Inicio de proyecto

Objetivo: Conseguir que el liderazgo apruebe el inicio y asigne personas y presupuesto.

ParteSecciónEnfoque
GanchoAntecedentes y oportunidadMercado, dolor, competencia, por qué ahora
ContextoLo que ya tenemosEquipo, tecnología, datos, activos previos
PropuestaObjetivos y alcanceDentro/fuera del alcance, hitos
EvidenciaPor qué nosotrosDiferenciación, ventaja competitiva
SolicitudRecursos y riesgosApoyo necesario, riesgos principales y mitigación
# {Proyecto} · Inicio

## Antecedentes y oportunidad

{Por qué ahora: mercado, dolor, competencia—2–4 oraciones.

Esta es la entrada de persuasión: crea "deberíamos hacer esto".}

## Lo que ya tenemos

{Equipo, tecnología, datos, activos comerciales—no para presumir, sino para generar confianza.

Patrón: "Ya tenemos X, por lo que esto no empieza de cero."}

## Objetivos y alcance

**Dentro del alcance**: {capacidades}
**Fuera del alcance**: {exclusiones explícitas—evitar la expansión del alcance}

{Hitos y cronograma}

## Por qué nosotros

{Diferencia principal frente a alternativas. Ventaja competitiva: por qué otros no pueden o no quieren igualar.}

## Recursos y riesgos

{Personas / presupuesto / necesidades entre equipos
Riesgo principal y mitigación}

Actualización de estado

Objetivo: Convencer a los líderes y partes interesadas de que el trabajo va por buen camino y vale la pena continuar invirtiendo.

ParteSecciónEnfoque
GanchoResumen de una línea1–2 hechos más importantes de este período
ContextoContexto del períodoPosición respecto al período anterior
PropuestaProgreso clavePor hito o módulo
EvidenciaMétricas claveProgreso, calidad, eficiencia
SolicitudRiesgos y decisionesDecisiones y coordinación necesarias
# {Proyecto} · Actualización de estado

## Resumen de una línea

{1–2 hechos; la audiencia capta lo esencial en 10 segundos}

## Progreso clave

{Elementos completados y métricas por hito o módulo}

## Riesgos y respuesta

Fórmula por elemento: {síntoma} → {causa raíz} → {mitigación} → {estado}

Decisiones: opciones + recomendación—sin tareas abiertas:
❌ "La dependencia X es incierta—por favor, aconseje"
✅ "La dependencia X se retrasó 2 semanas. Opción A (agregar personas) vs B (mover hito). Recomiendo A; necesito apoyo del equipo Y."

## Próxima fase

| Elemento | Fecha estimada | Dependencias | Riesgo |
|---|---|---|---|

Cierre / Revisión anual

Objetivo: Mostrar el valor entregado y los activos retenidos.

ParteSecciónEnfoque
GanchoResumen de cumplimiento de objetivos¿Tuvimos éxito en general?
ContextoObjetivos originalesA lo que nos comprometimos
EvidenciaResultados cuantificadosBasado en datos
PropuestaLecciones y activosLo que queda
SolicitudPróxima fase o transferencia¿Qué sucede después?
# {Proyecto} · Cierre / Revisión anual {Año}

## Cumplimiento de objetivos

| Objetivo | Meta | Real | % | Notas |
|---|---|---|---|---|

Bajo rendimiento: causa raíz y mejora—dilo antes de que pregunten.

## Entregables principales

3–5 elementos, cada uno: {qué} + {métrica} + {impacto comercial}

## Lecciones

- **Lo que funcionó**: métodos / arquitectura / proceso reutilizables
- **Lo que falló**: causa raíz + prevención
- **Activos dejados**: código / datos / documentación / capacidad del equipo

## Siguiente

Si continúa → dirección, objetivos, resultados clave, recursos
Si termina → transferencia para que nada quede sin soporte

Presentación para inversores

Objetivo: Despertar interés para una conversación más profunda.

ParteSecciónEnfoque
GanchoFrase de presentaciónDiscurso de ascensor
ContextoOportunidad de mercadoTamaño, dolor, por qué ahora
PropuestaProductoSolución, características principales, etapa
EvidenciaVentaja competitiva y tracciónTecnología, datos, crecimiento, equipo
SolicitudFinanciación / asociaciónMonto, uso, hitos
# {Proyecto} · Presentación

## Frase de presentación

{Qué hacemos, para quién, qué valor}

## Oportunidad de mercado

{Tamaño, persona, dolor, por qué ahora}

## Producto

{Cómo solucionamos, características principales, arquitectura (breve), etapa}

## Ventaja competitiva y tracción

**Ventaja competitiva**: {tecnología / datos / red / equipo—por qué otros no pueden}
**Métricas**: {usuarios, crecimiento, retención, ingresos}
**Equipo**: {por qué este equipo puede ejecutar}

## Solicitud de financiación

{Monto, uso de fondos, hitos, objetivo de la siguiente ronda}

Venta de soluciones

Objetivo: Convencer a los ejecutivos del cliente de que tu solución es la mejor opción.

ParteSecciónEnfoque
GanchoAlineación del dolorSu problema en sus palabras
ContextoEstado actualBrechas en el statu quo
PropuestaSoluciónCómo solucionamos
EvidenciaCasos y datosPrueba
SolicitudAsociaciónCómo empezar
# {Proyecto} · Propuesta

## Alineación del dolor

{Lenguaje del cliente para el problema—la precisión genera confianza rápidamente}

## Estado actual

{Por qué el statu quo falla: características, costo, eficiencia, riesgo}

## Nuestra solución

{Cómo solucionamos; capacidades y diferenciación}

## Prueba

{Casos de la misma industria con métricas}
{Si no hay caso: plan de prueba de concepto o hoja de ruta de demostración}

## Asociación

{Modelo de participación, cronograma, qué necesitamos de ellos}

Reglas de escritura

1. Sus preocupaciones primero, tu historia después

❌ Cinco minutos sobre lo duro que trabajó el equipo y lo inteligente que es la arquitectura ✅ La primera oración responde "¿por qué debería importarme?"

2. Los riesgos necesitan criterio

❌ "Los servidores a veces se agotan—por favor, monitoree" ✅ "Agotamiento del grupo de conexiones; escalando en progreso; recuperación esperada mañana"

3. Reconoce primero a los equipos pares

❌ "Llenamos un vacío que nadie más abordó" ✅ "El equipo X tiene un Y maduro; nosotros extendemos con Z"

4. Las métricas necesitan fuente y definición

❌ "La conversión mejoró un 20%" ✅ "Conversión +20% (junio vs mayo, mismo grupo de cuentas)"

5. Malas noticias temprano cuando importan

❌ Victorias primero, luego enterrado "pero nos retrasamos" ✅ Lidera con riesgos materiales, luego el progreso

6. Sin tareas para la audiencia

❌ "Siguiente: seguir avanzando" ✅ "Integración el miércoles; el riesgo es la dependencia Y—propietario alineado"


Flujo de trabajo

Paso 1 — Cargar memoria
  Lee el contexto del líder, posicionamiento comercial, preferencias de formato.
  Si falta → pide al usuario que lo proporcione.

Paso 2 — Escenario y audiencia
  El usuario elige el tipo (inicio / estado / cierre·anual / presentación / venta de soluciones).
  Indaga sobre la audiencia:
  □ ¿Rol y nivel?
  □ ¿Cuánto saben ya?
  □ ¿Principales preocupaciones (tecnología / negocio / costo / tiempo)?

Paso 3 — Ingesta de material
  Verifica la integridad por tipo; pregunta por las faltantes:

  Inicio:
  □ Antecedentes / análisis de mercado
  □ Panorama competitivo
  □ Capacidades del equipo
  □ Objetivos e KPIs
  □ Recursos y presupuesto
  □ Cronograma

  Estado:
  □ Trabajo completado este período
  □ Métricas clave (progreso / calidad / eficiencia)
  □ Lista de riesgos con criterio y mitigación
  □ Plan de la próxima fase
  □ Decisiones necesarias del liderazgo

  Cierre / anual:
  □ Objetivos originales
  □ Resultados cuantificados
  □ Lecciones aprendidas
  □ Próximo plan o transferencia

  Presentación:
  □ Datos e informes de mercado
  □ Demostración del producto o estado del MVP
  □ Competencia
  □ Presentación del equipo
  □ Financieros y pronóstico
  □ Solicitud de financiación y uso de fondos

  Venta de soluciones:
  □ Antecedentes del cliente y dolor
  □ Soluciones alternativas
  □ Nuestra solución y capacidades
  □ Casos o plan de prueba de concepto
  □ Precios o modelo de participación

  Si el usuario dice "lo sabes todo—solo escribe":
  → Extrae de la memoria y el contexto previo
  → Abre con "Basado en la información disponible; puede faltar XX"

Paso 4 — Borrador en la plantilla
  Elige la plantilla; aplica las reglas de escritura.
  Después de cada parte, pregunta: "¿Esto responde lo que les importa?"

Paso 5 — Verificación final
  □ ¿Los primeros 10 segundos se sienten relevantes?
  □ ¿Cada número tiene fuente y está definido?
  □ ¿Cada riesgo tiene causa raíz + respuesta?
  □ ¿Sin "necesita atención" vago sin criterio?
  □ ¿Las menciones entre equipos reconocen a otros primero?

Paso 6 — Confirmación del usuario
  Presenta → "¿Qué debemos ajustar?"
  Problemas de formato → agrega a la memoria de formato

Migración entre escenarios

De → ACambioMantener
Inicio → PresentaciónGancho: dolor comercial → oportunidad de mercado; Evidencia: ventaja tecnológica → tracciónEstructura de 5 partes, lógica de riesgo
Estado → Inicio (siguiente fase)El progreso se convierte en Contexto; los riesgos acumulados alimentan el RiesgoDefiniciones de métricas, narrativa del equipo
Cierre → Caso de estudioDesidentificar internos; enfatizar valor para el clienteMétodos cuantitativos, criterios de aceptación
Venta de soluciones → InicioDolor del cliente → oportunidad de mercado; casos → evidenciaEstructura, previsión de riesgos

Skills relacionados