read

Panorama general de la skill read

Qué hace read

La skill read obtiene una URL o un PDF y devuelve Markdown limpio, para que puedas revisar, citar o reutilizar contenido web sin tener que copiarlo manualmente desde el navegador. Está diseñada para el flujo read: tomar un enlace, convertirlo en texto legible y evitar el análisis salvo que lo pidas después.

Cuándo encaja mejor esta skill

Usa la skill read cuando tu tarea real sea “leer esta página” o “extraer este documento”, sobre todo en páginas de pago, sitios muy cargados de JavaScript, PDFs, enlaces de X/Twitter y plataformas chinas comunes como WeChat y Feishu. Encaja muy bien en Workflow Automation cuando necesitas una ingesta de contenido fiable antes de resumir, traducir, comparar o guardar.

Qué la diferencia

El principal diferenciador es el enrutamiento: read elige un método de obtención según el origen en vez de forzar un único prompt genérico. Eso importa porque GitHub, URLs de PDF, artículos de WeChat y archivos locales suelen requerir tratamientos distintos. También pone el foco en los niveles de privacidad y en un valor predeterminado sin análisis, lo que la hace más predecible para automatizaciones posteriores.

Cómo usar la skill read

Instala la skill read

Instala con npx skills add tw93/Waza --skill read. Después de instalarla, empieza leyendo SKILL.md y luego revisa references/read-methods.md y references/save-paths.md para ver las reglas reales de obtención y guardado. Si necesitas comportamiento específico por plataforma, inspecciona scripts/fetch.sh, scripts/fetch_weixin.py, scripts/fetch_feishu.py y scripts/fetch_local.py.

Dale a la skill la entrada correcta

La skill read funciona mejor con un único destino directo: una URL, un enlace a PDF o una ruta local a un PDF. Si quieres calidad de salida, especifica la fuente y el resultado que buscas, no solo “lee esto”. Los prompts más sólidos son del tipo: “Lee este artículo de WeChat y devuelve solo el Markdown”, o “Obtén este PDF y conserva los encabezados para poder citarlo”.

Usa bien la lógica de enrutamiento

Si el destino es contenido de GitHub, preferiblemente usa URLs de archivo sin procesar o gh cuando quieras una extracción limpia del origen. Para mp.weixin.qq.com, espera primero la cascada de proxy y luego, como respaldo, el script de WeChat. Para x.com o twitter.com, usa la ruta de proxy; para PDF locales, la vía correcta es la extracción. Este enrutamiento es la ventaja central de read usage frente a un prompt genérico de navegador.

Lee primero y decide después si guardar

Por defecto, read muestra el contenido en línea en lugar de guardar un archivo. Pide guardar solo cuando necesites explícitamente un artefacto Markdown, y entonces usa una ruta basada en el título como ~/Downloads/{title}.md. Si vas a encadenar read en un flujo de investigación o automatización, confirma si el siguiente paso espera solo visualización o un archivo guardado.

Preguntas frecuentes sobre la skill read

¿read es solo un prompt genérico de obtención?

No. Un prompt genérico puede pedir texto de una página, pero read incluye enrutamiento según la fuente, niveles de obtención con conciencia de privacidad y scripts específicos por plataforma. Eso reduce los fallos en páginas que la extracción estándar del navegador maneja mal.

¿Cuándo no debería usar read?

No uses read para texto plano que ya está en el repositorio y no necesita obtención web. Tampoco es la opción adecuada si quieres comentarios, interpretación o un resumen antes de que el texto fuente se haya capturado realmente.

¿read es apta para principiantes?

Sí, si tienes una URL y un objetivo claro. El error más común al empezar es dar una instrucción vaga como “revisa este enlace” sin decir si quieres la salida en Markdown, un archivo guardado o un análisis posterior. La guía de read es sencilla, pero la entrada debe ser específica.

¿read funciona bien para Workflow Automation?

Sí, especialmente cuando el siguiente paso depende de un texto fuente limpio. Encaja en pipelines de automatización que recopilan artículos, PDFs o publicaciones de plataformas antes de etiquetarlos, resumirlos, traducirlos o archivarlos. Si tu flujo necesita una captura determinista de la fuente, read es una skill de entrada muy práctica.

Cómo mejorar la skill read

Da mejor contexto de la fuente

La mejora de entrada más útil es la claridad sobre la fuente: incluye la URL exacta, indica si es un PDF o una página y di si esperas contenido difícil como muros de inicio de sesión, plataformas chinas o archivos de GitHub. Cuanto mejor describas la fuente, menos probable será que la skill elija una ruta menos eficaz.

Indica por adelantado las restricciones de salida

Si necesitas solo Markdown, menciónalo. Si quieres que se guarde el contenido, dilo antes de la obtención. Si necesitas un formato apto para citas, pide que se conserven los encabezados y los enlaces tanto como sea posible. Estas restricciones importan más que una explicación adicional porque read está diseñada para devolver texto fuente, no para interpretarlo.

Vigila los modos de fallo más comunes

Los principales fallos son usar la ruta equivocada, esperar que la obtención local cubra páginas muy cargadas de JavaScript o pedirle a read que resuma antes de capturar la fuente. Otro problema frecuente es intentar obtener páginas bloqueadas o vacías sin cambiar a la ruta de proxy. Cuando pasa eso, la solución suele ser elegir mejor la fuente, no escribir un prompt más largo.

Itera de la obtención al seguimiento

Un buen flujo read consiste en obtener primero y luego hacer un segundo prompt para análisis, extracción o comparación. Si la primera salida es demasiado ruidosa, ajusta la fuente o especifica la plataforma; si falta estructura, pide otro método de obtención o una ruta de guardado distinta. Para read usage, pequeños cambios en el prompt suelen mejorar más los resultados que reformular la misma petición.