O que update-markdown-file-index faz?
Atualiza uma seção de um arquivo markdown com um índice/tabela de arquivos de uma pasta especificada.
Descrição
Esta habilidade escaneia uma pasta específica e gera uma lista de arquivos (como uma tabela ou lista markdown) e insere ou atualiza essa lista em uma seção designada de um arquivo markdown. É ideal para manter automaticamente índices de documentação, listas de recursos ou exemplos de código atualizados com o conteúdo real do diretório.
Como funciona
- O usuário fornece o caminho para o arquivo markdown de destino e o caminho da pasta a ser indexada.
- A habilidade localiza a seção no arquivo markdown delimitada por marcadores de comentário HTML, como
<!-- start index -->e<!-- end index -->. - Ela gera uma lista formatada dos arquivos encontrados na pasta (opcionalmente com links relativos ou descrições adicionais).
- O conteúdo entre os marcadores é substituído pela nova lista, preservando o restante do arquivo.
Uso
Exemplo:
# Comando de exemplo (a ser executado pelo agente)
update-markdown-file-index --target README.md --source ./docs/exemplos
Plataformas suportadas
- Claude Code
- Cursor
- Codex CLI
Observações
- Os marcadores de seção devem estar presentes no arquivo markdown de destino.
- A habilidade não modifica código ou paths; apenas o conteúdo textual da seção é atualizado.
- Formatos de saída suportados: lista simples, tabela markdown ou lista com links.
Licença
MIT