ddasy/claude-md-index-skill

O que claude-md-index-skill faz?

Habilidade para Claude Code: inicialize um índice Markdown em camadas para seu código — INDEX.md + READMEs por diretório + regras CLAUDE.md, para que o Claude localize código rapidamente sem queimar contexto.

O que faz

Gera automaticamente:

• INDEX.md — visão geral de toda a base de código
• READMEs — descrições e contexto para cada diretório
• CLAUDE.md — regras de contexto para o Claude navegar eficientemente

Como usar

No Claude Code (IDE ou CLI), execute:

claude code --skill ddasy/claude-md-index-skill

Ou simplesmente:

/skill ddasy/claude-md-index-skill

Compatibilidade

• ✅ Claude Code (IDE)
• ✅ Claude Code (CLI)
• ✅ Codex CLI
• ✅ Cursor

Estrutura gerada

projeto/
├── INDEX.md          ← índice global
├── src/
│   ├── README.md     ← explica o diretório src
│   └── components/
│       └── README.md ← explica o diretório components
├── CLAUDE.md         ← regras para IA

Funcionamento

1. Escaneia a árvore de diretórios do projeto
2. Para cada diretório, identifica arquivos de código e sua finalidade
3. Gera READMEs descritivos com base na estrutura observada
4. Cria INDEX.md sumarizando o projeto
5. Adiciona regras no CLAUDE.md para guiar o comportamento do assistente

Observações

• Os arquivos gerados são sobrescritos a cada execução
• É seguro rodar múltiplas vezes
• Personalize os READMEs após a geração se necessário