axelv/claude-skill-code-walkthrough

Habilidade do Claude Code: gerar um tour educacional pelo código usando reveal.js com trechos de código, links para arquivos e diagramas de arquitetura Mermaid.

O que é claude-skill-code-walkthrough?

Esta habilidade para o Claude Code permite gerar apresentações interativas e educacionais sobre a base de código de um projeto, utilizando o framework reveal.js. Ela é útil para desenvolvedores que desejam documentar, ensinar ou revisar arquiteturas de software de forma visual e dinâmica. A habilidade suporta a inclusão de trechos de código reais (com syntax highlighting), links diretos para arquivos no repositório, e diagramas de arquitetura gerados com Mermaid, facilitando a compreensão de fluxos, dependências e estrutura modular. Com base no conteúdo do SKILL.md, ela orienta o Claude a estruturar slides com títulos, seções explicativas, exemplos de código e diagramas, tudo exportável como uma apresentação HTML pronta para ser hospedada ou compartilhada. É uma ferramenta poderosa para code reviews, onboarding de novos membros da equipe ou apresentações técnicas.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add axelv/claude-skill-code-walkthrough

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que claude-skill-code-walkthrough faz?

Habilidade do Claude Code: gerar um tour educacional pelo código usando reveal.js com trechos de código, links para arquivos e diagramas de arquitetura Mermaid.

Como usar

Esta habilidade instrui o modelo Claude (via Claude Code) a criar uma apresentação reveal.js interativa que percorre a base de código de um projeto, destacando:

  • Trechos de código com realce de sintaxe (parsing automático do idioma)
  • Links para arquivos que abrem diretamente no repositório (ex: [src/main.py](./src/main.py))
  • Diagramas Mermaid para representar arquitetura, fluxos de dados ou hierarquia de componentes

Exemplo de uso em prompt

Crie um tour de código para este projeto usando reveal.js. Inclua:
- Uma visão geral da arquitetura com diagrama Mermaid
- Os 3 principais módulos com trechos de código
- Links para os arquivos correspondentes
- Animações de transição entre slides

Estrutura gerada

A apresentação segue a estrutura padrão do reveal.js:

  • Slide 1: Título e descrição do projeto
  • Slide 2: Visão geral da arquitetura (diagrama Mermaid)
  • Slides seguintes: Módulo por módulo, com trechos de código, explicações e links
  • Slide final: Resumo e próximos passos

Suporte a plataformas

  • Claude Code (terminal)
  • Claude Desktop (via skills)
  • Qualquer ambiente que execute o Claude com suporte a skills

Dependências

  • reveal.js (para renderizar a apresentação) – recomendado usar via CDN
  • Opcional: mermaid para renderizar diagramas Mermaid diretamente nos slides

Personalização

Você pode modificar temas, animações e layout editando as opções do Reveal.initialize() no HTML gerado.

Nota: Esta skill não cria arquivos físicos no projeto, apenas gera o conteúdo HTML da apresentação para ser salvo ou visualizado.

Habilidades Relacionadas