read

Visão geral do skill read

O que o read faz

O skill read busca uma URL ou PDF e devolve um Markdown limpo, para você inspecionar, citar, referenciar ou reutilizar conteúdo da web sem precisar copiar tudo manualmente do navegador. Ele foi criado para o fluxo read: pegar um link, transformar em texto legível e evitar análise até que você peça isso depois.

Melhor uso para este skill

Use o skill read quando a sua tarefa real for “ler esta página” ou “extrair este documento”, especialmente em páginas com paywall, sites pesados em JS, PDFs, links do X/Twitter e plataformas chinesas comuns como WeChat e Feishu. Ele é uma boa escolha para Workflow Automation quando você precisa de ingestão confiável de conteúdo antes de resumir, traduzir, comparar ou salvar.

O que o diferencia

O principal diferencial é o roteamento: o read escolhe o método de busca com base na origem, em vez de forçar um único prompt genérico. Isso faz diferença porque GitHub, URLs de PDF, artigos do WeChat e arquivos locais muitas vezes exigem tratamentos diferentes. Ele também enfatiza níveis de privacidade e um padrão sem análise, o que o torna mais previsível para automações a jusante.

Como usar o skill read

Instale o skill read

Instale com npx skills add tw93/Waza --skill read. Depois da instalação, comece lendo SKILL.md e, em seguida, consulte references/read-methods.md e references/save-paths.md para entender as regras reais de busca e salvamento. Se você precisar de comportamento específico por plataforma, inspecione scripts/fetch.sh, scripts/fetch_weixin.py, scripts/fetch_feishu.py e scripts/fetch_local.py.

Dê a entrada certa ao skill

O skill read funciona melhor com um único alvo direto: uma URL, um link de PDF ou um caminho local para PDF. Se você quer qualidade de saída, especifique a origem e o resultado desejado, não apenas “leia isso”. Prompts mais fortes soam como: “Leia este artigo do WeChat e retorne apenas o Markdown” ou “Busque este PDF e mantenha os títulos intactos para citação.”

Use bem a lógica de roteamento

Se o alvo for conteúdo do GitHub, prefira URLs de arquivos raw ou gh quando quiser extração limpa da fonte. Para mp.weixin.qq.com, espere primeiro a cascata de proxy e, como fallback, o script do WeChat. Para x.com ou twitter.com, use a rota de proxy; para PDFs locais, a extração é o caminho certo. Esse roteamento é a principal vantagem do read usage em relação a um prompt genérico de navegador.

Leia primeiro, depois decida se vai salvar

Por padrão, o read exibe o conteúdo inline em vez de salvar um arquivo. Peça para salvar apenas quando você realmente precisar de um artefato em Markdown e, nesse caso, use um caminho baseado no título como ~/Downloads/{title}.md. Se você estiver encadeando o read em um fluxo de pesquisa ou automação, confirme se a próxima etapa espera apenas exibição ou um arquivo salvo.

FAQ do skill read

O read é só um prompt genérico de busca?

Não. Um prompt genérico pode pedir o texto de uma página, mas o read inclui roteamento baseado na origem, níveis de busca com consciência de privacidade e scripts específicos por plataforma. Isso reduz falhas em páginas que a extração padrão do navegador lida mal.

Quando eu não devo usar o read?

Não use o read para texto simples que já está no repositório e não precisa de busca na web. Ele também não é a melhor escolha se você quer comentário, interpretação ou resumo antes que o texto-fonte tenha sido realmente buscado.

O read é amigável para iniciantes?

Sim, se você tiver uma URL e um objetivo claro. O erro mais comum de quem está começando é dar uma instrução vaga como “verifique este link” sem dizer se quer a saída em Markdown, um arquivo salvo ou uma análise de acompanhamento. O guia do read é simples, mas a entrada precisa ser específica.

O read funciona bem para Workflow Automation?

Sim, especialmente quando a próxima etapa depende de texto-fonte limpo. Ele se encaixa bem em pipelines de automação que coletam artigos, PDFs ou posts de plataformas antes de marcar, resumir, traduzir ou arquivar. Se o seu fluxo precisa de captura determinística da fonte, o read é um skill de front-end prático.

Como melhorar o skill read

Dê um contexto de origem melhor

A melhoria mais útil na entrada é deixar a origem clara: inclua a URL exata, indique se é um PDF ou uma página e diga se espera conteúdo problemático, como login wall, plataformas chinesas ou arquivos do GitHub. Quanto melhor você descrever a origem, menor a chance de o skill escolher uma rota mais fraca.

Declare as restrições de saída logo de início

Se você precisa apenas de Markdown, diga isso. Se quiser salvar o conteúdo, informe antes da busca. Se precisa de formatação amigável para citação, peça para manter títulos e links o máximo possível. Essas restrições importam mais do que explicações extras porque o read foi projetado para devolver texto-fonte, não para interpretá-lo.

Fique atento aos modos de falha comuns

Os principais modos de falha são usar a rota errada, esperar que a busca local dê conta de páginas pesadas em JS ou pedir para o read resumir antes de capturar a fonte. Outro problema comum é tentar buscar páginas bloqueadas ou vazias sem trocar para o caminho de proxy. Quando isso acontece, a correção costuma ser uma escolha melhor da origem, não um prompt mais longo.

Itere da busca para o passo seguinte

Um bom fluxo com read é buscar primeiro e, depois, fazer um segundo prompt para análise, extração ou comparação. Se a primeira saída estiver poluída, refine a origem ou especifique a plataforma; se estiver faltando estrutura, peça um método de busca diferente ou um caminho de salvamento. Para read usage, pequenas mudanças no prompt costumam melhorar mais os resultados do que reescrever a mesma solicitação.