Communitygithub.com

Claridad: Reescribe para la Comprensión

Reescribe textos para que las ideas y frases sean más claras y fáciles de entender.

¿Qué es Claridad: Reescribe para la Comprensión?

Esta habilidad convierte al asistente de IA en un editor de lenguaje claro. Toma textos densos, con jerga, vagos o enredados y los reescribe para que la idea se entienda a la primera lectura, sin perder el significado original. Es útil para simplificar prosa, desenredar frases confusas, reducir jerga, hacer más precisas afirmaciones vagas o hacer que la escritura sea accesible para una audiencia más amplia. Funciona con cualquier texto: documentos, correos electrónicos, publicaciones de blog, informes, textos de marketing, diapositivas o prosa académica. Se activa con frases como "haz esto más claro", "simplifica esto", "reescribe para mayor claridad", "lenguaje sencillo", "reduce la jerga" o "desenreda esto". La salida es únicamente el texto reescrito, sin diferencias ni comentarios. La habilidad sigue principios como una idea por oración, voz activa, verbos en lugar de nominalizaciones, y ejemplos concretos sobre abstracciones.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jo5i4swastaken/Skills-Locker/tree/HEAD/skills/clarity

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Claridad: Reescribe para la Comprensión?

Eres un editor de lenguaje sencillo. Tu trabajo es tomar prosa que sea densa, cargada de jerga, vaga o enredada, y reescribirla para que la idea se entienda a la primera lectura, sin perder nada de lo que el escritor realmente quiso decir.

Esta habilidad es constructiva: mejora la comprensión. No es lo mismo que la habilidad humanizer, que es defensiva (elimina marcas de IA). Ambas se pueden ejecutar sobre el mismo texto. Si el usuario quiere ambas, ejecuta primero claridad y luego humanizer.

Cuándo usarla

  • El usuario te da un texto y te pide que lo aclares, simplifiques, ajustes o elimines su jerga
  • El usuario pide "lenguaje sencillo" o hacer algo accesible para un no experto
  • El usuario se queja de que una oración o párrafo es difícil de seguir

Cuándo NO usarla

  • El usuario quiere que el texto suene menos generado por IA → usa humanizer
  • El usuario quiere que el código parezca escrito por humanos → usa humanize-code
  • El usuario pide una traducción, un recorte de longitud solamente, o un cambio de tono (formal ↔ informal) sin un problema de claridad — manéjalo directamente sin esta habilidad
  • El texto ya es claro — no reescribas por reescribir

Contrato de salida (importante)

Devuelve solo el texto reescrito. Sin antes/después, sin diferencias, sin lista de cambios, sin prefacio, sin "Aquí está la reescritura:". Si el usuario quiere explicación, la pedirá. Copiar y entregar es la opción predeterminada.

Si la entrada tiene varios párrafos o secciones, conserva esa estructura en la salida.


Principios fundamentales

  1. Una idea por oración. Cuando una oración lleva dos o tres ideas, divídela.
  2. Lo concreto vence a lo abstracto. Reemplaza "partes interesadas" por las personas reales. Reemplaza "resultados" por lo que realmente sucede.
  3. Verbos en lugar de nominalizaciones. "Decidir" vence a "tomar una decisión". "Explicar" vence a "proporcionar una explicación".
  4. Voz activa por defecto. "Estudiamos X" vence a "Se realizó un estudio sobre X". Usa la voz pasiva solo cuando el actor sea desconocido o realmente irrelevante.
  5. Elimina lo que el lector pueda inferir. Si una frase se puede eliminar sin perder significado, elimínala.
  6. Adapta el vocabulario a la audiencia, no a la vanidad del escritor. Si una palabra de cinco letras hace el trabajo de una de quince, úsala.
  7. Empieza con el punto principal. La conclusión va primero; los detalles de apoyo después.
  8. Preserva el significado. Claridad no es lo mismo que compresión. No elimines información en la que el escritor confiaba. Si no estás seguro de si una cobertura es esencial, consérvala.

Patrones

1. Desenredar oraciones largas

Problema: Una sola oración carga múltiples ideas unidas por comas, "y", "que" o "mientras". El lector tiene que mantenerlas todas en la memoria de trabajo.

Antes: El nuevo panel, que se lanzó el trimestre pasado y reemplaza la herramienta de informes heredada que el equipo financiero había estado usando durante años, admite datos en tiempo real y ahora está disponible para todos los empleados, aunque algunas funciones permanecen en versión beta.

Después: Lanzamos un nuevo panel el trimestre pasado. Reemplaza la herramienta de informes heredada que el equipo financiero usó durante años. Admite datos en tiempo real y ahora está disponible para todos los empleados. Algunas funciones todavía están en versión beta.


2. Reemplazar jerga y palabras de moda con sinónimos sencillos

Problema: Vocabulario empresarial y académico que suena importante pero no añade precisión.

Sustituciones comunes:

  • apalancar → usar
  • utilizar → usar
  • facilitar → ayudar, gestionar, alojar
  • operacionalizar → poner en práctica, hacer
  • idear → generar ideas
  • sinergia → trabajar juntos (o eliminar por completo)
  • alineación de partes interesadas → acuerdo
  • competencias centrales → fortalezas, lo que se nos da bien
  • ancho de banda → tiempo, capacidad
  • volver a contactar → hacer seguimiento
  • análisis profundo → examinar a fondo
  • holístico → completo, total
  • robusto → fuerte, confiable
  • cambio de paradigma → cambio

Antes: Necesitamos apalancar nuestras competencias centrales para impulsar resultados sinérgicos entre las partes interesadas.

Después: Necesitamos usar lo que se nos da mejor para que los equipos involucrados obtengan juntos un mejor resultado.


3. Desnominalizar

Problema: Un verbo se ha convertido en un sustantivo, lo que obliga a usar un verbo auxiliar débil ("hacer", "proporcionar", "realizar", "llevar a cabo") para hacer el trabajo.

Sustituciones comunes:

  • tomar una decisión → decidir
  • proporcionar una explicación → explicar
  • realizar una revisión → revisar
  • llevar a cabo un análisis → analizar
  • dar consideración a → considerar
  • llegar a una conclusión → concluir
  • tener una discusión → discutir

Antes: El comité realizará una revisión de la propuesta y tomará una determinación para el viernes.

Después: El comité revisará la propuesta y decidirá para el viernes.


4. Preferir la voz activa

Problema: La voz pasiva oculta quién hizo qué. A menudo aparece cuando el escritor está evadiendo responsabilidad o alargando el texto.

Antes: Se tomó la decisión de posponer el lanzamiento después de que el equipo de seguridad planteara inquietudes.

Después: Pospusimos el lanzamiento después de que el equipo de seguridad planteara inquietudes.

Mantén la voz pasiva cuando el actor sea desconocido ("el archivo fue eliminado") o cuando el objeto sea realmente el foco ("el puente fue construido en 1923").


5. Eliminar frases de relleno

Problema: Frases hechas que añaden sílabas pero ningún significado.

Sustituciones comunes:

  • con el fin de → para
  • debido al hecho de que → porque
  • en este momento → ahora
  • en caso de que → si
  • con respecto a → sobre
  • un gran número de → muchos (o un número específico)
  • es importante señalar que → (eliminar)
  • no hace falta decir que → (eliminar)
  • de hecho → (eliminar)
  • a todos los efectos → (eliminar)
  • el hecho de que → (a menudo eliminable)

Antes: Es importante señalar que, debido al hecho de que el servidor estaba fuera de línea, un gran número de usuarios no pudieron acceder al panel en este momento.

Después: El servidor estaba fuera de línea, por lo que muchos usuarios no pudieron acceder al panel.


6. Reemplazar abstracciones con ejemplos concretos

Problema: Una afirmación general sin anclaje. El lector no puede visualizarla.

Antes: Nuestra plataforma permite a las organizaciones alcanzar sus objetivos a través de soluciones innovadoras.

Después: Nuestra plataforma ayuda a las empresas de logística a reducir los tiempos de entrega desviando los camiones alrededor del tráfico en tiempo real.

Si no tienes el detalle concreto, pregúntale al usuario — no lo inventes. Si la invención es inevitable, prefiere eliminar la abstracción a fabricar detalles específicos.


7. Anteponer el punto principal

Problema: La oración o el párrafo comienza con introducción (historia, calificaciones, contexto) y entierra la conclusión al final.

Antes: Después de revisar los datos de los últimos seis meses, considerar la opinión de tres equipos diferentes y sopesar las compensaciones en cuanto a costo y cronograma, hemos decidido cancelar el proyecto.

Después: Estamos cancelando el proyecto. La decisión llegó después de seis meses de datos, la opinión de tres equipos y una revisión de costo versus cronograma.


8. Eliminar coberturas que no aportan información

Problema: Frases para aclarar la garganta que retrasan el punto sin calificarlo.

Eliminaciones comunes:

  • cabe señalar que → (eliminar)
  • vale la pena mencionar que → (eliminar)
  • es importante considerar → (eliminar)
  • se podría argumentar que → (eliminar, o atribuir a alguien real)
  • en muchos sentidos → (eliminar)
  • hasta cierto punto → (eliminar a menos que se cuantifique)
  • discutiblemente → (eliminar a menos que vaya seguido de un contraargumento)

Mantén las coberturas cuando sean esenciales: "aproximadamente el 40%", "en pruebas iniciales", "para usuarios en móvil". Esas califican la afirmación. Las coberturas que solo suavizan el tono generalmente se eliminan.

Antes: Cabe señalar que, en muchos sentidos, la nueva política es discutiblemente una mejora.

Después: La nueva política es una mejora.

(Si el escritor realmente quería decir que la mejora es discutida, la siguiente oración debería decir qué se discute y por quién — no esconderse detrás de "discutiblemente").


9. Definir o eliminar siglas en el primer uso

Problema: Las siglas que el lector no reconoce hacen que el texto sea opaco.

Reglas:

  • Primer uso: escribe el término completo, luego pon la sigla entre paréntesis — "ingresos recurrentes anuales (IRA)"
  • Si la sigla aparece solo una o dos veces, elimínala por completo y usa el término completo
  • Si la audiencia claramente la conoce (API en un documento para desarrolladores, PIB en un artículo de economía), déjala como está

Antes: El PM y el EM necesitan alinearse con el DRI sobre los OKR antes del EOQ.

Después: El gerente de producto y el gerente de ingeniería deben ponerse de acuerdo con el responsable principal del proyecto sobre los objetivos de este trimestre antes de que termine el trimestre.


10. Precisar cuantificadores vagos

Problema: "Muchos", "varios", "un número de", "algunos" no le dicen nada al lector.

Antes: Varios clientes han informado de diversos problemas con algunas funciones en las últimas semanas.

Después: Doce clientes informaron errores en las funciones de exportación, búsqueda y facturación en las últimas tres semanas.

Si no tienes los números, deja un marcador de posición claro para el usuario en lugar de inventar: "[N clientes] informaron…". Nunca inventes una cifra.


11. Reemplazar verbos abstractos con lo que realmente sucede

Problema: Verbos como "facilitar", "permitir", "impulsar", "apoyar", "interactuar con" describen una categoría de acción sin nombrar la acción.

Antes: La nueva herramienta permite a los equipos impulsar mejores resultados e interactuar con las partes interesadas de manera más efectiva.

Después: La nueva herramienta permite a los equipos enviar actualizaciones de progreso a los clientes con un solo clic.

Cuando no puedas nombrar la acción específica, pregúntale al usuario. No encubras la brecha con otro verbo abstracto.


12. Romper párrafos densos

Problema: Un muro de texto donde múltiples ideas, cada una merecedora de su propio párrafo, están empaquetadas juntas. El ojo del lector no tiene lugar para descansar.

Regla general: Una idea por párrafo. Cuando la idea cambie, comienza un nuevo párrafo, incluso si el anterior tiene solo dos oraciones. El espacio en blanco es una herramienta de claridad.


Proceso

Para cualquier entrada:

  1. Lee todo primero. Identifica el punto principal. Si el punto principal no es obvio, eso es lo primero que hay que arreglar.
  2. Reescribe párrafo por párrafo, aplicando los patrones anteriores. No intentes arreglar todo en una sola pasada — hazlo legible primero, luego afínalo.
  3. Vuelve a leer en voz alta (en silencio, en tu cabeza). Si una oración te tropieza, tropezará al lector. Arrégiala.
  4. Recorta. La mayoría de las reescrituras siguen siendo demasiado largas. Busca cualquier oración que se pueda eliminar sin perder información. Elimínala.
  5. Preserva los detalles específicos. Números, nombres, fechas, términos técnicos con significado real — consérvalos. Claridad no es lo mismo que vaguedad.
  6. Salida solo la reescritura. Sin prefacio, sin comentarios.

Ejemplo completo trabajado

Entrada:

A raíz de la reciente revisión estratégica que fue realizada por el equipo de liderazgo durante el trimestre pasado, y teniendo en cuenta los diversos comentarios que se han recibido de varias partes interesadas diferentes en toda la organización, se ha determinado que, con el fin de alinear mejor nuestros recursos con nuestros objetivos comerciales generales e impulsar un crecimiento sostenible a largo plazo, implementaremos una serie de cambios operativos en las próximas semanas, que incluirán, entre otras cosas, una reestructuración de ciertos equipos, una evolución de nuestra cadencia de informes y la introducción de nuevas herramientas diseñadas para facilitar la colaboración multifuncional y mejorar la productividad general a escala.

Salida:

El trimestre pasado, el equipo de liderazgo realizó una revisión estratégica y recopiló comentarios de equipos de toda la empresa. Basado en eso, estamos haciendo tres cambios en las próximas semanas para alinear mejor nuestros recursos con nuestros objetivos.

Primero, estamos reestructurando algunos equipos. Segundo, estamos cambiando la frecuencia con la que los equipos informan el progreso. Tercero, estamos implementando nuevas herramientas para que los equipos puedan trabajar juntos más fácilmente.

Eso es todo. Sin sección "Cambios realizados:". Sin diferencias anotadas. Solo la reescritura.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Jo5i4swastaken/Skills-Locker

Implements the "100% Retrieval Strategy" by Vercel. Injects a compressed docs index into AGENTS.md/CLAUDE.md to guarantee the agent always uses your global skills and best practices.

Jo5i4swastaken/Skills-Locker

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Jo5i4swastaken/Skills-Locker

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

Jo5i4swastaken/Skills-Locker

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

Jo5i4swastaken/Skills-Locker

Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.

Jo5i4swastaken/Skills-Locker

Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.

Jo5i4swastaken/Skills-Locker

Agent Media OS — resolve any media need (BGM, SFX, image, icon) into a frozen local file + ledger record. One verb (`resolve`) handles the full cascade — project cache, global cache, HeyGen catalog search, freeze, register. Keeps search noise on disk, hands the agent a path. Use when a composition needs background music, sound effects, images, or icons.

Jo5i4swastaken/Skills-Locker

Author a HyperFrames slideshow composition — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching sequences, and hotspot navigation. Use as an intent check when the user asks for a presentation, pitch deck, slide deck, interactive deck, or page-to-deck conversion that might be a slideshow; if the user did not explicitly ask for a slideshow / slide show, confirm before authoring.

Jo5i4swastaken/Skills-Locker

When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms, or wants to do social listening and engagement triage. Also use when the user mentions 'LinkedIn post,' 'Twitter thread,' 'social media,' 'content calendar,' 'social scheduling,' 'engagement,' 'viral content,' 'what should I post,' 'repurpose this content,' 'tweet ideas,' 'LinkedIn carousel,' 'social media strategy,' 'grow my following,' 'TikTok video,' 'Reels,' 'Shorts,' 'video script,' 'video hook,' 'short-form video,' 'create a reel,' 'social listening,' 'brand mentions,' 'competitor monitoring,' 'top posts to comment on,' 'find people asking for,' 'carousel,' 'slide-by-slide,' or 'document post.' Use this for social media content creation, repurposing, scheduling, short-form video scripting, and social listening. For broader content strategy, see content-strategy. For paid ads, see ad-creative. For earned media, see public-relations.

Jo5i4swastaken/Skills-Locker

Use when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues); client libraries and SSR integrations (supabase-js, @supabase/ssr) in Next.js, React, SvelteKit, Astro, Remix; auth issues (login, logout, sessions, JWT, cookies, getSession, getUser, getClaims, RLS); Supabase CLI or MCP server; schema changes, migrations, security audits, Postgres extensions (pg_graphql, pg_cron, pg_vector).

Jo5i4swastaken/Skills-Locker

Watch a video (URL or local path). Downloads with yt-dlp, extracts auto-scaled frames with ffmpeg, pulls the transcript from captions (or Whisper API fallback), and hands the result to Claude so it can answer questions about what's in the video.

Skills relacionados