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

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

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

Ou 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.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.

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 rotina index-refresh).
  • O wikiId, spaceSlug e 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

  1. Leia o wiki/index.md do espaço de destino como ele está atualmente.
  2. Percorra o wiki/ do espaço de destino. As entradas wiki/projects/<slug>/standup.md são companheiras do estado atual para páginas duráveis de wiki/projects/<slug>/index.md; indexe-as apenas como links anexados à entrada do projeto correspondente. Percorra wiki/ por categoria (sources/, projects/, entities/, concepts/, synthesis/, mais quaisquer subdiretórios personalizados que o esquema da wiki adicionou).
  3. Leia as últimas ~50 entradas de wiki/log.md do espaço de destino para identificar páginas que foram criadas ou substancialmente alteradas, mas nunca chegaram ao índice.
  4. Por categoria, produza entradas ordenadas no formato:
    - [[<path>]] — <one-line summary>
    
    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.
  5. 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>
    
  6. Adicione entradas para páginas que existem no disco, mas estavam ausentes do índice. Ignore wiki/log.md e wiki/index.md em si. Para wiki/projects/<slug>/standup.md autô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.
  7. 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.
  8. Preserve categorias personalizadas. Se a wiki adicionou, por exemplo, wiki/papers/ ou wiki/runbooks/, mantenha sua seção de índice. Não colapse para as cinco categorias padrão.
  9. Anexe uma entrada de log com contagens:
    ## [YYYY-MM-DD] index-refresh | added=N removed=M
    - operation issue: <issue identifier>
    
    Se o índice já estava preciso, a entrada do log diz 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.md corresponde ao conteúdo real de wiki/ — sem páginas faltando, sem entradas pendentes.
  • As entradas de projeto incluem links de wiki/projects/<slug>/standup.md atuais 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.md tem 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

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas