copy-review
$
npx mdskill add 686f6c61/alfred-dev/copy-reviewRefine public text for clarity, tone, and impact.
- Eliminates errors and improves communication effectiveness.
- Analyzes grammar, style, and call-to-action strength.
- Prioritizes objective fixes before subjective refinements.
- Delivers corrected text with actionable improvement notes.
SKILL.md
.github/skills/copy-reviewView on GitHub ↗
---
name: copy-review
description: "Revisar textos publicos: claridad, tono, ortografia y CTAs. Activar ante: revisar textos, mejorar copy, tono de comunicacion, textos de la web, landing page copy"
---
# Revisar textos publicos
## Resumen
Este skill revisa textos orientados al publico (paginas web, landing pages, emails, descripciones de producto) con foco en cinco dimensiones: ortografia, claridad, tono, llamadas a la accion y estructura visual. Una revision de copy no es solo corregir faltas: es asegurarse de que el texto cumple su objetivo comunicativo.
La revision sigue un orden deliberado: primero se corrigen los errores objetivos (ortografia, gramatica) y despues se mejoran los aspectos subjetivos (claridad, tono, CTAs). Esto evita perder tiempo refinando un parrafo que luego se reescribe por un error ortografico.
## Proceso
1. **Corregir ortografia y gramatica.** Esta es la base imprescindible. Un texto con faltas pierde credibilidad independientemente de lo bueno que sea el contenido:
- Tildes: en castellano son obligatorias y su ausencia es una falta. Revisar especialmente las palabras que cambian de significado con o sin tilde (si/si, el/el, mas/mas).
- Concordancia: sujeto-verbo, genero y numero.
- Puntuacion: comas, puntos, punto y coma usados correctamente.
- Anglicismos innecesarios: si hay un equivalente natural en castellano, preferirlo.
2. **Evaluar la claridad.** El texto debe ser comprensible para el publico objetivo sin necesidad de conocimientos especializados, salvo que el contexto lo justifique:
- Cada parrafo transmite una idea principal?
- Las frases son directas o hay rodeos innecesarios?
- Se usan terminos tecnicos sin explicacion para un publico no tecnico?
- Hay ambiguedades que puedan causar malentendidos?
3. **Evaluar el tono.** El tono debe ser coherente con la identidad de marca a lo largo de todo el texto:
- Es profesional sin ser frio?
- Es cercano sin ser informal en exceso?
- Se mantiene el mismo registro a lo largo de todo el texto, sin saltos entre formal e informal?
- Evita la condescendencia y el lenguaje paternalista?
4. **Revisar las llamadas a la accion (CTAs).** Los CTAs son el puente entre el contenido y la conversion:
- Cada pagina tiene al menos un CTA claro?
- Los CTAs usan verbos activos orientados al beneficio ("Empieza gratis", no "Haz clic aqui")?
- Son especificos sobre lo que ocurrira al hacer clic?
- Estan posicionados en puntos logicos del flujo de lectura?
5. **Evaluar la estructura visual.** En web, la gente escanea antes de leer. El texto debe facilitar ese escaneo:
- Parrafos cortos (3-4 lineas en pantalla).
- Titulos y subtitulos que cuenten la historia por si solos: un lector que solo lea los encabezados deberia entender el mensaje principal.
- Listas para enumeraciones de tres o mas elementos.
- Negrita para los conceptos clave (sin abusar).
6. **Generar el informe de revision.** Organizar los hallazgos en tres categorias:
- **Errores**: problemas objetivos que deben corregirse (ortografia, gramatica, datos incorrectos).
- **Mejoras recomendadas**: cambios que mejorarian la calidad del texto (claridad, tono, estructura).
- **Sugerencias opcionales**: refinamientos menores o alternativas estilisticas.
Para cada hallazgo, incluir el texto original y la propuesta de correccion.
## Que NO hacer
- No reescribir el texto completo: el objetivo es mejorar lo que hay, no sustituirlo.
- No imponer un tono que no se haya consensuado con el usuario.
- No ignorar las tildes en castellano bajo ningun concepto.
- No priorizar la creatividad sobre la claridad en textos informativos.
More from 686f6c61/alfred-dev
- acceptance-criteriaGenerar criterios de aceptación en formato Given/When/Then. Activar cuando el usuario quiera definir criterios de aceptacion, usar formato Given When Then, escribir en Gherkin, saber como determinar que algo esta terminado o establecer una definicion de hecho.
- architecture-docsUsar para documentar la arquitectura del sistema. Activar ante: documentar arquitectura, diagrama del sistema, como funciona el proyecto, vision general tecnica
- bundle-sizeAnalizar y reducir el tamaño de bundles frontend. Activar cuando el bundle sea grande, se quiera reducir tamaño, aplicar tree shaking, configurar lazy loading, usar webpack analyzer o analizar el peso de la aplicacion.
- choose-stackUsar para evaluar y elegir tecnologías con matriz de decisión ponderada. Activar cuando el usuario quiera elegir tecnología, comparar frameworks, decidir entre alternativas técnicas, construir una matriz de decisión, evaluar stack, seleccionar base de datos, elegir lenguaje o comparar herramientas.
- ci-cd-pipelineConfigurar pipeline CI/CD adaptado al proyecto. Activar cuando el usuario quiera configurar CI, crear GitHub Actions, configurar GitLab CI, montar un pipeline de despliegue, automatizar tests o implementar integracion continua.
- code-review-responseUsar al recibir feedback de code review para responder técnicamente. Activar cuando el usuario quiera responder a comentarios de PR, gestionar feedback de code review, resolver comentarios de un revisor, o cuando el revisor pide cambios en el código.
- compliance-checkUsar para verificar cumplimiento RGPD, NIS2 y CRA. También: verificar RGPD, cumplimiento normativo, NIS2, CRA, Cyber Resilience Act, protección de datos, regulación europea.
- dependency-strategyEstrategia integral de gestion de dependencias: inventario, evaluacion de riesgo, politica de actualizaciones y documentacion. Usar para auditar el estado global de las dependencias del proyecto.
- dependency-updateRevisar dependencias desactualizadas, con CVEs o end-of-life, y proponer actualizaciones seguras. También: actualizar paquetes, actualizar dependencias, Dependabot, Renovate, versión desactualizada, breaking changes.
- deploy-configConfigurar despliegue según hosting. Activar cuando el usuario quiera desplegar en Vercel, Railway, AWS, configurar hosting, preparar para produccion o gestionar variables de entorno de despliegue.