Pular para o conteúdo
Skillpedia
Documentação103 mil · #372

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

https://github.com/paperclipai/paperclip/blob/master/packages/plugins/plugin-llm-wiki/skills/wiki-lint/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/paperclipai/paperclip/blob/master/packages/plugins/plugin-llm-wiki/skills/wiki-lint/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
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-lint

Ou 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.md
Conteú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, spaceSlug e 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

  1. Percorra a wiki/index.md do espaço alvo e a árvore da wiki com wiki_search e wiki_read_page, sempre passando a wikiId e a spaceSlug do problema de operação. Construa um mapa mental de: páginas existentes, páginas referenciadas a partir de index.md, páginas referenciadas de outras páginas e fontes brutas.
  2. Verifique os sete problemas recorrentes, nesta ordem:
    1. 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.
    2. 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.
    3. Páginas órfãs — uma página wiki/ não está vinculada a partir de index.md e não é referenciada de nenhuma outra página da wiki. Ou ela deve ser vinculada, removida ou mesclada.
    4. Lacunas de conceito — um termo aparece em três ou mais páginas, mas não tem uma wiki/concepts/<slug>.md dedicada. Recomende a criação de uma.
    5. [[wiki-links]] quebrados — um arquivo de destino de link não existe.
    6. 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.
    7. Derivação de índice / log — existem páginas que não estão em index.md, ou index.md lista páginas que não existem mais. Operações recentes em wiki/log.md que não produziram uma alteração de página correspondente.
  3. 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).
  4. Não escreva em wiki/. O lint é somente leitura por design — o mantenedor ou a rotina que segue decide quais achados serão acionados.
  5. 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 sob wiki/ foi modificado, exceto wiki/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

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas