CommunityRedacción y edicióngithub.com

barryallen16/agent-skills

Redacta prosa empresarial que genera acción. Úsalo para redactar, editar, correos electrónicos, memorandos, cartas, presentaciones, discursos, planes, informes, propuestas, ventas/captación de fondos, currículums. Combina la claridad de Thompson, la eficacia de Roman/Raphaelson, la persuasión de Ogilvy.

¿Qué es agent-skills?

Esta habilidad transforma la escritura empresarial en un motor de acción, no solo de claridad. Se basa en los principios de grandes maestros como Ogilvy, Thompson, Roman y Raphaelson para asegurar que cada palabra impulse al lector a actuar: saber qué hacer, cuándo y por qué. Es ideal para desarrolladores, agentes de IA y profesionales que necesitan redactar correos, informes, propuestas, presentaciones o cualquier documento que busque resultados concretos. La habilidad cubre desde la fase de pensar y estructurar (con tarjetas de ideas y pirámides de argumentos) hasta el borrador (lenguaje directo, activo, preciso, sin jerga) y los formatos específicos (correo, memo, carta, presentación, plan, propuesta, ventas, currículum). Incluye reglas de edición y legibilidad (leer en voz alta, cortar palabras innecesarias, revisar con ojos frescos) y pautas para la escritura inclusiva. Además, reconoce cuándo es mejor no escribir y hablar en persona. Funciona en cualquier plataforma que soporte instrucciones de escritura (Claude Code, Cursor, Codex) y su markdown detalla cada paso con ejemplos prácticos y reglas concretas.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/barryallen16/agent-skills/tree/HEAD/writing-that-works

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Escritura que Funciona

Objetivo: acción, no solo claridad. El lector debe saber qué hacer, para cuándo, por qué. Segundo objetivo, cuando el lector no puede actuar: mantenerlo leyendo (Ogilvy: conectar, involucrar, actuar). Elige para cuál estás redactando. Premisa: Las personas que piensan bien, escriben bien. La buena escritura se aprende, no es un don. (Ogilvy)

Prueba principal antes de enviar: ¿qué acción debe tomar el lector? Si no está claro, reescribe.

1. Piensa primero

  • Esquema de tarjetas: un punto por viñeta, agrupa relacionados, ordena pilas (¿qué debe ir primero? ¿qué es más importante?), ordena dentro de las pilas. Introducción + conclusión al final.
  • Pirámide: los hechos se agrupan hacia arriba hasta un único pensamiento superior. Documentos largos empiezan con Resumen Ejecutivo.
  • Empieza donde están los lectores: adecúa el conocimiento, explica no presumas, nunca escribas por encima de ellos.
  • Prueba de la frase bonita (Thompson): conserva la frase dramática solo si no resta claridad. Si es así, córtala.

2. Redacta: no farfulles

  • Directo, lo más parecido a hablar: No farfulles > Generalmente es deseable.... Si no lo dirías cara a cara, no lo escribas.
  • Unidades cortas: párrafos cortos (1-3 oraciones), oraciones, palabras. Prefiere ahora/empezar/usar/terminar a actualmente/iniciar/utilizar/finalizar.
  • Activo y personal: Recomendamos no Se recomienda. Usa yo/tú/nosotros.
  • Preciso y específico: Gastamos de más por $10,000 no Muy por encima del presupuesto; La inscripción se duplicó a 560 desde 27 estados no gran éxito. Adjetivos vigorosos (nítido, lúcido) no perezosos (muy bueno, vitalmente importante).
  • Palabras de primer grado (Thompson): imagen inmediata, sin traducción. Todos los peces murieron no la biota presentó 100% de mortalidad. Combinaciones familiares: Estamos construyendo un país del que nadie quede fuera no buscando construir una sociedad inclusiva. La gramática debe desambiguar (El padre de Juan dice que no puede... - ¿quién?).
  • Con los pies en la tierra, sin jerga: discutir no interfazar, no hay suficiente personal no con restricciones de recursos, nunca reconceptualizar, desmasificación, actitudinalmente. La jerga es pretenciosa (Ogilvy). Dos excepciones: las palabras clave de ATS sobreviven tal cual, y la jerga nativa del público en una transmisión es el objetivo principal: recortarla allí te hace sonar genérico.
  • Corta palabras innecesarias: plan anticipado->plan, tomar acción->actuar, realizar una reunión->reunirse, en este momento->ahora, en vista de->porque, en el caso de que->si, a pesar del hecho de que->aunque, con respecto a->sobre.
  • La palabra correcta: afectar/efecto, su/su, i.e./e.g., principal/principio, implicar/inferir, mitigar/militar, definido/definitivo, desinteresado/no interesado.
  • Sin abogados/burócratas: oraciones cortas, sin cláusulas anidadas, sin re:, mínimo latín.
  • Asume ignorancia: define abreviaturas en el primer uso (costo por mil (CPM)). Cuidado con diferencias K/M, 9/12 US/UK.
  • Puntúa como señales de tráfico. Nunca "comillas" para énfasis.
  • Atenúa: más de seis y medio no casi siete para 6,7. Una exageración arruina el caso.
  • Inmalinterpretable: divide oraciones sobrecargadas. Inglés sencillo incluso para temas técnicos (escribe para los abuelos; lo explotó no anomalía... secuencia de destrucción).
  • Máximo 2 páginas (Ogilvy). Si acortar mantiene el significado, acorta. Correo electrónico: una pantalla o archivo adjunto.

3. Formatos

  • Correo electrónico: asunto = titular (Aprobación del cliente conseguida + etiqueta de grupo, nunca en blanco). Corta al 50%. Contexto no etiqueta (disponible para reunión el 14). Tono: Hola/Hola apertura, Gracias/Saludos cierre, sin emoticonos. PARA: = única persona actora. Sin difusión/Responder a todos. Urgente/reunión <2h por teléfono. Archivos adjuntos anunciados y comprimidos. Nunca asuntos legales/introductorios/sensibles-negativos por correo. Nada privado (Eliminar no elimina).
  • Memorando: título centrado en MAYÚSCULAS (AUMENTO PARA TONY ANDRINO). Para: solo la persona actora, copias: alfabético. Puntos numerados si >media página. Final: quién/qué/cuándo. Escrito a mano para elogios. Sin humor/sarcasmo. Enojado: envía mañana. A veces mejor ir a hablar.
  • Carta: nombres exactos, Estimado/a X (o Estimada Joan Larson punto medio), título opcional (TARJETA PERDIDA - CTA #3729). Primera oración = asunto, sin charla trivial. Termina cuando termines (corta Llame si tiene preguntas). Cierra con el siguiente paso fechado (decidir antes del 1 de agosto, ¿almuerzo el viernes? Llamaré por la mañana). Pregunta: qué->quién/por qué->gracias. No: prueba cara a cara, empatiza, razones, dejar puerta abierta. Cobro: firmeza acorde a la edad, nunca moroso/usted afirma. Queja: queja+lo que quieres en la oración 1 + cuenta/fechas + fecha de respuesta. Respuesta: nunca a la defensiva (admite, arregla, el dueño llama, disculpa).
  • Presentación/discurso: flujo Objetivo->Antecedentes->Hechos->Conclusiones->Recomendaciones->Próximos pasos. Un tema principal, agenda+tiempo (promete 30 cumple 25), sobre ellos no sobre ti, titulares no etiquetas (La competencia de bajo precio gana terreno no Tendencias), lee la diapositiva textual luego amplía, involucra (gráficos, suposiciones, video de cliente), termina fuerte + preguntas y respuestas, ensaya 2 veces. Discurso: una idea principal, escribe para una persona, elimina los primeros párrafos, empieza rápido (sin honor/privilegio), bromas solo si están probadas, lee en voz alta hasta que suene natural, <20 minutos.
  • Plan/informe: plan = oración de propósito primero, hechos selectivos->lecciones->propuesta vinculada, pasos+riesgos+pros y contras honestos, llamado resonante (Creo que...). Informe = propósito oración 1, Propósito-Resumen-Hallazgos-Conclusiones-Recomendaciones-Próximos pasos, 5W incluyendo malas noticias, visita de campo > estadísticas, hecho vs opinión etiquetado. Anual: carta del propietario en lenguaje llano (Buffett: escribe para tus hermanas). Venture: equipo + cliente real que paga, sin pequeño porcentaje de un mercado enorme, cero errores tipográficos.
  • Propuesta: vender no presentar, título de beneficio, asunto+alcance párrafo 1, antecedentes exhaustivos, recomendar pronto, solo detalles específicos (un eslabón débil lo arruina), reformular la pregunta, responder ¿Qué gano yo?. Subvenciones: $+propósito párrafos 1-2, ajustarse a criterios, urgente + continuación, apertura vívida.
  • Ventas/captación de fondos: prueba una variable, el valor de vida decide el gasto, oferta (cupón) primero, oración rápida 1 (AmEx no es para todos, sin preámbulos), teaser en sobre (AVISO ANTICIPADO / ABRIR DE INMEDIATO / REGALO GRATIS), un beneficio principal, diseño atractivo, fuerza ahora (SUSCRÍBETE AHORA + PD reafirmando la oferta). El PD es la línea más leída en cualquier mensaje: úsalo siempre. Lo largo a menudo gana a lo corto si mantienes la atención + hechos + oferta; no cambies un ganador, un precio más alto o un día de envío impar pueden ganar: prueba. Captación de fondos: gracias-luego-por favor, menú de montos con nombre (computadora de $800 / zapatos de $75), personal + qué muere sin donación, nunca exageres (confianza = dinero).
  • Currículum = guion de entrevista, no para conseguir trabajo. El 70%+ de los trabajos llegan a través de contactos: encuentra al presentador (Adjunto currículum que deberías conocer). Personaliza la carta por empleador; el currículum puede ser el mismo.
  • Incluir: nombre/contacto arriba; objetivo factual (sin puesto desafiante); trabajos en orden cronológico inverso con ubicación, fechas, tamaño del equipo, alcance; logros como resultados (moví la roca qué tan lejos, no tiempo empujando); lagunas explicadas (1997-99 Proyectos Personales); títulos/fechas; juntas/directivas/asociaciones/publicaciones; recién graduado: actividades extracurriculares; breve personal: tecnología/idiomas al final. 1-2 páginas, tú lo escribes.
  • Excluir: edad/género, altura/peso, raza/religión, foto, clubes, pasatiempos, viajes/salario, Referencias disponibles a pedido, trivialidades, video, formato llamativo.
  • ATS/currículum electrónico: texto plano, Arial/Times, sin negritas/cursivas/viñetas/símbolos, escaneable. La fuerza de las palabras clave importa: Dominé el Programa X no familiarizado con software. Repite los sustantivos de la oferta de trabajo textualmente.
  • Perfecto: cero errores tipográficos, impresión láser, nombres completos de la empresa (sin acrónimos misteriosos), telegráfico en tercera persona (Gestioné dpto. de 64 personas - sin yo, sin artículos).
  • Ojos nuevos dos veces, luego corta: ¿Es relevante? ¿Y qué?
  • Carta de presentación <1 página, media página ideal: beneficio para el lector primero (no Yo...Yo...Yo), puesto nombrado de inmediato, intriga no halago, a una persona nombrada y deletreada correctamente (¿Campos? ¿Ana/Ann?), evidencia específica + herramientas, siguiente paso por ti (Llamaré el miércoles por la mañana; estoy libre hasta las 8:45). Nunca Esperando tener noticias. Envía a muchas personas en la organización; reenvía después de semanas; seguimiento de agradecimiento con detalles, sin exageraciones.

4. Edita + legibilidad

  • Nunca envíes el primer borrador (Ogilvy: nunca el mismo día). Pase 1: corta (tacha cada tercera palabra - Twain). Pase 2: ¿farfullos? ¿orden? ¿huecos? ¿hechos/citas verificadas incluso cuando estás seguro? ¿tono?
  • Dos consejos: deja reposar una noche (lee en voz alta por la mañana), colega (Por favor mejora).
  • Legible: encabezado centrado en MAYÚSCULAS, divide párrafos largos, cursivas para énfasis (sin negritas/subrayados spam), viñetas/números colgantes, sin MAYÚSCULAS en el cuerpo, subtítulos con espacio, espacio entre párrafos, números consistentes ($60 millones), gráficos al apéndice/horizontal, numera páginas siempre.
  • Computadora: escribe primero formato después, guarda dos veces + AutoGuardar 15 + marca de fecha en borradores, nombres de archivo lógicos, corrige en papel, una fuente serif, alineación a la izquierda, entrégalo (perfeccionismo = parálisis).

5. Inclusivo y cuándo no escribir

  • Sensible no hipersensible; usa la preferencia actual del grupo. Corrige el él genérico: pluraliza (Todos los novelistas esperan ganar) o segunda persona (Cuando recibes...).
  • ¿Quieres ACCIÓN en lo que importa? No escribas. Ve y diles. La confianza cara a cara supera al texto. Alcance: esto aplica cuando el lector es alcanzable. La transmisión (publicaciones, boletines, texto de aterrizaje) está exenta: no hay a quién ir a decirle.

Skills relacionados