wiki-lint
Faz seu agente verificar a saúde da Wiki do LLM. Ele procura por erros, links quebrados ou informações que não fazem sentido.
O que ela faz
Esta ferramenta verifica se as informações em uma base de conhecimento (wiki) estão corretas e organizadas. Ela procura por erros como informações contraditórias, links quebrados ou páginas que não estão conectadas a outras.
Quando usar
- ✓Quando você suspeita que há informações erradas ou desatualizadas em uma wiki.
- ✓Antes de fazer grandes mudanças em uma wiki para entender os problemas existentes.
- ✓Para garantir que todos os links e páginas importantes estejam funcionando corretamente.
Exemplo do que pedir para a IA
“Verifique a wiki do projeto 'Alfa' por inconsistências e links quebrados.”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
A ferramenta lê todas as páginas da wiki e compara as informações. Ela procura por problemas específicos como links que não levam a lugar nenhum ou informações que se contradizem.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add paperclipai/paperclip --skill wiki-lintOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/paperclipai/paperclip/master/packages/plugins/plugin-llm-wiki/skills/wiki-lint/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Lint da Wiki
Audite, não edite. Retorne os achados para que o mantenedor (humano ou agente) possa triar.
Entradas
- Um problema de operação com
operationType: "lint". - O destino do problema de operação
wikiId,spaceSluge a raiz do espaço. Faça o lint apenas desse espaço, a menos que o problema diga explicitamente que é uma varredura multi-espaço.
Fluxo de Trabalho
- Percorra a
wiki/index.mddo espaço alvo e a árvore da wiki comwiki_searchewiki_read_page, sempre passando awikiIde aspaceSlugdo problema de operação. Construa um mapa mental de: páginas existentes, páginas referenciadas a partir deindex.md, páginas referenciadas de outras páginas e fontes brutas. - Verifique os sete problemas recorrentes, nesta ordem:
- Contradições — duas páginas fazendo afirmações incompatíveis sobre a mesma entidade, decisão ou status. Marque ambas as páginas, nomeie as afirmações conflitantes e cite evidências.
- Afirmações desatualizadas — uma página afirma X, mas uma fonte mais nova sob
raw/a substituiu. Marque a página mais antiga; nunca sobrescreva. - Páginas órfãs — uma página
wiki/não está vinculada a partir deindex.mde não é referenciada de nenhuma outra página da wiki. Ou ela deve ser vinculada, removida ou mesclada. - Lacunas de conceito — um termo aparece em três ou mais páginas, mas não tem uma
wiki/concepts/<slug>.mddedicada. Recomende a criação de uma. [[wiki-links]]quebrados — um arquivo de destino de link não existe.- Proveniência fraca — uma afirmação não trivial não é citada ou cita apenas a própria wiki em um ciclo. A fonte original de referência deve ser localizável.
- Derivação de índice / log — existem páginas que não estão em
index.md, ouindex.mdlista páginas que não existem mais. Operações recentes emwiki/log.mdque não produziram uma alteração de página correspondente.
- Retorne uma lista de triagem, agrupada por gravidade:
- crítico: contradições, links quebrados para páginas ativas, citações fabricadas.
- médio: afirmações desatualizadas, proveniência fraca, grandes lacunas de conceito.
- baixo: órfãs, derivação de log, pequenas lacunas de índice.
Cada item tem: caminho do arquivo, evidência (uma citação de 1-2 linhas), correção sugerida e a operação que deve dar seguimento (
ingest,paperclip-distill,index-refresh, revisão manual).
- Não escreva em
wiki/. O lint é somente leitura por design — o mantenedor ou a rotina que segue decide quais achados serão acionados. - Anexe uma entrada de log descrevendo a execução:
## [YYYY-MM-DD] lint | <N findings, M critical> - operation issue: <issue identifier> - critical: <count> - medium: <count> - low: <count>
Voz
- Comece com a contagem por gravidade.
- Cada achado é um item de lista. Evite comentários.
- Em caso de dúvida sobre a gravidade, diga isso e apresente como médio com uma nota de "verificar".
Verificação
Antes de fechar o problema de operação:
- Achados estão agrupados por gravidade com caminhos de arquivo, evidências e correção sugerida por item.
- Nenhum arquivo sob
raw/foi modificado. Nenhum arquivo sobwiki/foi modificado, excetowiki/log.md. - Se a execução não encontrou nada, o problema é fechado com "nenhum achado" e a entrada de log ainda existe para que auditorias futuras possam ver que esta execução ocorreu.
Ferramentas
wiki_search, wiki_read_page, wiki_list_sources, wiki_read_source, wiki_write_page (apenas wiki/log.md). Sempre inclua a wikiId e a spaceSlug do problema de operação.
Perguntas frequentes
A ferramenta corrige os problemas automaticamente?
Não, ela apenas aponta os problemas encontrados. Um humano ou outro agente de IA precisa revisar e corrigir os erros.
O que são 'links órfãos'?
São páginas que existem na wiki, mas não são mencionadas ou conectadas a partir de nenhuma outra página, tornando difícil encontrá-las.
O que significa 'proveniência fraca'?
Significa que uma informação importante não tem uma fonte clara ou confiável citada, ou a fonte é a própria wiki, criando um ciclo.
Detalhes
Descrição original do autor
Use when an LLM Wiki operation issue is a lint or health check. Audit for contradictions, orphans, weak provenance, broken links, missing concept pages, and index/log drift; return triage findings without auto-fixing.
repo: paperclipai/paperclip
Popularidade
- Estrelas no GitHub
- 103 mil
- Posição no ranking
- #372
- Licença
- MIT
- Atualizada em
- 16/10/2026
Comentários
- …
Mais skills deste repositório
delegate-work
Ajuda seu agente a delegar trabalho para outro agente. É útil para dividir tarefas complexas e acompanhar o progresso de forma organizada.
paperclipai/paperclip
follow-up-results
Faz seu agente verificar resultados de trabalhos anteriores. É útil para acompanhar o andamento de tarefas e adicionar feedback humano.
paperclipai/paperclip
review-my-team
Ajuda seu agente a revisar a equipe conectada. É útil para ter um resumo do time, tarefas, bloqueios e aprovações pendentes.
paperclipai/paperclip
paperclip-task-bridge
Faz seu agente criar e gerenciar tarefas em outra plataforma. É útil para interagir com sistemas de gerenciamento de projetos diretamente.
paperclipai/paperclip
Skills parecidas
architecture-decision-records
Faz seu agente registrar decisões importantes sobre a estrutura do projeto. Ajuda a entender o porquê das escolhas feitas e a manter um histórico claro das mudanças.
affaan-m/ECC
code-tour
Faz seu agente criar guias passo a passo no código, com locais exatos em arquivos e linhas. É útil para apresentar um projeto, explicar código ou revisar mudanças. Ajuda a entender como um sistema funciona.
affaan-m/ECC
codebase-onboarding
Ajuda seu agente a analisar um código desconhecido e criar um guia de integração. Ele inclui um mapa da arquitetura, pontos de entrada e convenções. Ideal para quem está começando em um novo projeto.
affaan-m/ECC