copy-editing

Descripción general de copy-editing skill

Qué hace copy-editing skill

La copy-editing skill es un flujo de edición enfocado en marketing para mejorar textos existentes sin sustituir el mensaje original. Está pensada para solicitudes como “edita esto”, “revisa este texto”, “hazlo más claro”, “revisa mi landing page” y casos similares en los que ya existe un borrador y el objetivo es lograr un copy más claro, legible y persuasivo.

A diferencia de un único prompt genérico de reescritura, esta copy-editing skill trabaja con pasadas editoriales específicas. El SKILL.md original se basa en un marco de siete revisiones que cubre claridad, voz, tono, concisión, fluidez, persuasión y pulido final, con el recordatorio de volver atrás cuando una edición debilita otra.

Mejor encaje para equipos de Copywriting y marketing

Es una muy buena opción para copywriters, marketers, founders, product marketers y equipos de contenido que editan landing pages, campañas de email, anuncios, secciones web, textos de lanzamiento, páginas de ventas o mensajes de marketing dentro del producto. Resulta especialmente útil cuando quieres recibir feedback práctico sobre el copy antes de reescribirlo todo.

La skill también revisa primero si hay contexto de product marketing: si existe .claude/product-marketing-context.md, debe usar esa información de marca, posicionamiento y lenguaje del cliente antes de editar. Eso la hace más práctica para equipos que ya tienen una guía de voz o una fuente de referencia para su messaging.

Por qué es más que una simple corrección

Su principal diferencia está en la disciplina de trabajar por pasadas separadas. En lugar de corregir gramática, tono y lógica de conversión al mismo tiempo, la skill pide al agente que revise una dimensión por vez y explique por qué importan los cambios. Los archivos de apoyo aportan profundidad práctica: references/plain-english-alternatives.md ayuda a sustituir formulaciones infladas, mientras que scripts/readability_scorer.py y scripts/ai_content_detector.py pueden señalar problemas de legibilidad, relleno, voz pasiva, ritmo plano y frases comunes que suenan a IA.

Cuándo esta skill no es la opción adecuada

No instales copy-editing si lo que necesitas principalmente es generación de primeros borradores, estrategia SEO de largo formato, revisión legal, arquitectura de documentación técnica o posicionamiento de marca desde cero. Funciona mejor cuando el mensaje, la audiencia y el borrador ya existen. Si faltan esos elementos, obtendrás mejores resultados creando primero un brief y usando después esta skill para la fase de edición.

Cómo usar copy-editing skill

Instalación de copy-editing y ruta del repositorio

Instala la skill desde el repositorio de GitHub con:

npx skills add alirezarezvani/claude-skills --skill copy-editing

El código fuente está en marketing-skill/skills/copy-editing, en https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/copy-editing. Empieza leyendo SKILL.md y después revisa los dos archivos de referencia y los dos scripts:

• references/plain-english-alternatives.md
• references/ai-detection-patterns.md
• scripts/readability_scorer.py
• scripts/ai_content_detector.py

El archivo propio de la skill es la guía operativa principal; los archivos de apoyo son útiles cuando quieres comprobaciones medibles o una revisión más sólida en lenguaje claro.

Inputs que mejoran el uso de copy-editing

Para obtener mejores resultados, dale al agente el borrador, el lector objetivo, la oferta, el canal, la acción deseada, las restricciones de tono y lo que no debe cambiar. Un prompt débil sería: “Pulir este copy”. Un prompt más sólido sería:

Use the copy-editing skill to edit this homepage hero for startup founders evaluating accounting software. Keep the core promise and product name unchanged. Improve clarity, reduce hype, make the CTA more specific, and preserve a confident but plain-spoken tone. Show the revised copy first, then list the top five edits and why they matter.

Esto le da a la skill contexto suficiente para conservar la intención mientras mejora la ejecución.

Flujo recomendado para sesiones reales de edición

Usa la guía de copy-editing por etapas. Primero, pide solo un diagnóstico: qué resulta poco claro, exagerado, fuera de marca o débil desde el punto de vista de conversión. Segundo, solicita una versión revisada con el enfoque de siete pasadas. Tercero, pide un registro de cambios para poder aceptar o rechazar ediciones con criterio.

Para piezas más grandes, divide el trabajo por secciones: hero, puntos de prueba, funcionalidades, objeciones, FAQ, CTA. Esto reduce el riesgo de sobreeditar y ayuda al agente a conservar la función de cada sección. Si tu proyecto tiene .claude/product-marketing-context.md, indícale al agente que lo lea y lo aplique antes de editar.

Uso de los scripts de apoyo

Si trabajas en local, los scripts pueden convertir una edición subjetiva en una revisión más repetible. Ejecuta comprobaciones de legibilidad con:

python3 scripts/readability_scorer.py --file copy.txt

Usa el detector de patrones de IA como una heurística, no como un veredicto:

python3 scripts/ai_content_detector.py copy.txt

El detector analiza la variación en la longitud de las frases, la diversidad de vocabulario y frases conocidas de estilo IA. Trata los pasajes marcados como lugares donde añadir especificidad, ritmo, lenguaje del cliente o verbos más precisos, no como prueba de que el texto sea “malo”.

Preguntas frecuentes sobre copy-editing skill

¿copy-editing es solo para copy de marketing?

En su mayoría, sí. El enfoque, los ejemplos y las comprobaciones de la skill están orientados al marketing y al copy de conversión. Aun así, puede mejorar escritura empresarial general, pero donde aporta más valor es en textos que deben persuadir a un lector para que entienda, confíe, haga clic, se registre, responda o compre.

¿En qué se diferencia de pedir una reescritura?

Un prompt de reescritura suele sustituir tu voz y puede optimizar la fluidez por encima de la intención. La copy-editing skill prioriza explícitamente conservar el mensaje central, hacer pasadas enfocadas y explicar las razones de los cambios. Eso la hace más adecuada cuando necesitas mejoras controladas, no una versión completamente nueva.

¿copy-editing skill es apta para principiantes?

Sí, siempre que aportes contexto. Quienes están empezando se benefician de pedir “ediciones más justificación”, porque el resultado se convierte en una pequeña lección de edición. Si solo pegas el texto sin audiencia, oferta ni objetivo, el agente puede hacer cambios seguros pero genéricos.

¿Cuándo debería evitar esta skill?

Evítala cuando necesites revisión legal, médica, de cumplimiento normativo o de verificación de claims. Tampoco la uses como sustituto de la investigación con clientes. La skill puede hacer que el copy sea más claro y persuasivo, pero no puede verificar si tu promesa, posicionamiento o evidencia son verdaderos.

Cómo mejorar copy-editing skill

Mejora los resultados de copy-editing con briefs más completos

El fallo más común es dar poco contexto. Añade el nivel de conciencia del lector, su dolor principal, objeciones, acción deseada, voz de marca, claims prohibidos y ejemplos de copy que te gusten. Si tienes citas de clientes, inclúyelas. Los inputs específicos ayudan a la skill a sustituir lenguaje genérico por lenguaje que tu audiencia reconoce de verdad.

Un formato de brief útil es:

• Audience:
• Channel:
• Goal:
• Current draft:
• Must keep:
• Must avoid:
• Tone:
• Proof or evidence available:

Pide ediciones acotadas, no el máximo pulido posible

“Mejóralo” puede llevar a un texto demasiado suavizado. Las instrucciones más fuertes son más selectivas: “shorten by 20%,” “keep the founder’s direct tone,” “remove jargon,” “make the CTA outcome-led,” o “preserve all technical claims.” Las restricciones protegen la voz y evitan que el editor convierta un copy distintivo en lenguaje SaaS genérico.

Itera después de la primera versión editada

Después de la primera pasada, pregunta qué tradeoffs introdujo la edición. Por ejemplo: “Did the shorter version lose credibility?” o “Where did persuasion improve but voice become less distinctive?” Esto funciona bien con el modelo de siete pasadas porque claridad, concisión, tono y persuasión pueden competir entre sí. A menudo, el mejor resultado llega tras dos o tres revisiones dirigidas, no con una única pasada amplia.

Usa las referencias para reducir el copy genérico de IA

Para limpiar el texto con lenguaje sencillo, pide al agente que aplique references/plain-english-alternatives.md y explique los reemplazos de mayor impacto. Para copy que suena a IA, usa references/ai-detection-patterns.md y el script detector para identificar ritmo plano, vocabulario repetido y frases de plantilla. Después, pide correcciones concretas: variación entre frases más cortas y más largas, sustantivos más específicos, verbos más fuertes, frases de clientes y menos afirmaciones abstractas.