index-refresh
Ajuda seu agente a atualizar índices de documentação. É útil para garantir que a navegação e a organização de wikis estejam sempre corretas.
O que ela faz
Esta ferramenta organiza e atualiza um índice (uma lista de páginas) de um sistema de anotações chamado Wiki. Ela garante que a lista esteja sempre correta, refletindo as páginas que existem e removendo as que foram apagadas.
Quando usar
- ✓Quando a lista de páginas do Wiki está desatualizada.
- ✓Após apagar ou adicionar novas páginas importantes.
- ✓Para garantir que a navegação no Wiki seja fácil e rápida.
Exemplo do que pedir para a IA
“Atualize o índice do Wiki para que ele mostre todas as páginas existentes e remova as que foram deletadas.”
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 compara a lista de páginas atual com o que realmente existe no Wiki. Ela adiciona novas páginas à lista e remove as que não existem mais, registrando tudo no histórico.
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 index-refreshOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/paperclipai/paperclip/master/packages/plugins/plugin-llm-wiki/skills/index-refresh/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.
Atualização do Índice
Mantenha wiki/index.md preciso e fácil de pesquisar. O índice é o primeiro ponto de parada do mantenedor para navegação — sua qualidade determina o quão barata se torna cada operação subsequente.
Entradas
- Um problema de operação com
operationType: "index"(ou o título da rotinaindex-refresh). - O
wikiId,spaceSluge a raiz do espaço de destino do problema da operação. Atualize apenas esse espaço, a menos que o problema diga explicitamente que se trata de uma varredura em múltiplos espaços.
Fluxo de Trabalho
- Leia o
wiki/index.mddo espaço de destino como ele está atualmente. - Percorra o
wiki/do espaço de destino. As entradaswiki/projects/<slug>/standup.mdsão companheiras do estado atual para páginas duráveis dewiki/projects/<slug>/index.md; indexe-as apenas como links anexados à entrada do projeto correspondente. Percorrawiki/por categoria (sources/,projects/,entities/,concepts/,synthesis/, mais quaisquer subdiretórios personalizados que o esquema da wiki adicionou). - Leia as últimas ~50 entradas de
wiki/log.mddo espaço de destino para identificar páginas que foram criadas ou substancialmente alteradas, mas nunca chegaram ao índice. - Por categoria, produza entradas ordenadas no formato:
O resumo é uma frase factual extraída do primeiro parágrafo da página ou de seu título. Sem status, sem datas no índice — essas pertencem à própria página ou ao log.- [[<path>]] — <one-line summary> - Remova entradas cujas páginas não existem mais. Anote a exclusão no log:
## [YYYY-MM-DD] index-refresh | reconciled - removed: [[wiki/old-page]] (page deleted) - added: [[wiki/new-page]] — <summary> - Adicione entradas para páginas que existem no disco, mas estavam ausentes do índice. Ignore
wiki/log.mdewiki/index.mdem si. Parawiki/projects/<slug>/standup.mdautônomos sem uma página de projeto durável correspondente, adicione-a em Projetos e marque-a para posterior destilação de página durável. - Escreva as entradas de projeto editorialmente. A seção Projetos deve agrupar o trabalho pelo conceito e propósito do projeto, não por IDs de problemas, datas, status, UUIDs ou metadados de origem. Vincule identificadores de tarefas apenas como evidência de apoio.
- Preserve categorias personalizadas. Se a wiki adicionou, por exemplo,
wiki/papers/ouwiki/runbooks/, mantenha sua seção de índice. Não colapse para as cinco categorias padrão. - Anexe uma entrada de log com contagens:
Se o índice já estava preciso, a entrada do log diz## [YYYY-MM-DD] index-refresh | added=N removed=M - operation issue: <issue identifier>added=0 removed=0— ainda assim, escreva-a para que auditorias futuras possam ver que a execução ocorreu.
O que esta habilidade NÃO faz
- Não altera o conteúdo das páginas.
- Não resolve contradições, corrige links quebrados ou preenche lacunas conceituais. Isso vai para a próxima execução de
wiki-lint. - Não escreve resumos que já não sejam suportados pela própria página. Se uma página não tiver um primeiro parágrafo claro para resumir, marque-a para
wiki-lint.
Voz
- As entradas do índice são uma linha factual por página, no tempo presente.
- Sem emojis, sem status, sem datas em
wiki/index.md. As datas ficam no log.
Verificação
Antes de fechar o problema da operação:
-
wiki/index.mdcorresponde ao conteúdo real dewiki/— sem páginas faltando, sem entradas pendentes. - As entradas de projeto incluem links de
wiki/projects/<slug>/standup.mdatuais quando existem reuniões de acompanhamento. - Cada linha do índice tem o formato
- [[path]] — <summary>. - As seções de categoria personalizadas são preservadas.
-
wiki/log.mdtem a entrada de atualização do índice com contagens (mesmo que as contagens sejam zero). - Nenhum corpo de página foi modificado. Nenhum arquivo sob
raw/foi modificado.
Ferramentas
wiki_search, wiki_read_page, wiki_write_page (apenas para wiki/index.md e wiki/log.md). Sempre inclua o wikiId e o spaceSlug do problema da operação.
Perguntas frequentes
A ferramenta altera o conteúdo das minhas anotações?
Não, ela apenas organiza a lista de páginas (o índice) e não mexe no conteúdo das suas anotações.
O que acontece se uma página for apagada?
A ferramenta remove a página apagada do índice e registra essa ação no histórico.
A ferramenta cria resumos para as páginas?
Ela usa um resumo curto da própria página ou do título dela para o índice. Se a página não tiver um resumo claro, ela pode pedir ajuda para outra ferramenta.
Detalhes
Descrição original do autor
Use when an LLM Wiki operation issue requests an index refresh. Rebuild `wiki/index.md` from the actual wiki tree, reconcile missing/deleted entries, and log counts without editing page bodies.
repo: paperclipai/paperclip
Popularidade
- Estrelas no GitHub
- 103 mil
- Posição no ranking
- #369
- 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