Communitygithub.com

gio-del/skills

Habilidades pessoais do Gio para agentes de codificação — pequenas, combináveis e instaláveis via npx skills@latest add gio-del/skills

O que é skills?

Esta skill permite que um agente de IA (como Claude Code, Cursor ou Codex) crie apresentações de slides no formato reveal.js a partir de descrições textuais. Ela é útil para desenvolvedores que desejam gerar rapidamente decks de palestras consistentes com sistemas de design predefinidos, sem precisar montar HTML manualmente. A skill detecta automaticamente o sistema de design disponível no repositório (via arquivos `design-systems/*/brand-guidelines.md`), orienta a escolha do nome do deck e produz um projeto local contendo `index.html` e assets, referenciando os temas e layouts por caminho relativo. Ela suporta tanto a criação de novos decks quanto a edição de decks existentes, seguindo as regras de design system definidas. Sua instalação é simples através do comando `npx skills@latest add gio-del/skills`.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add gio-del/skills

Perguntar na sua IA favorita

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

Documentação

Slides

Transforme a descrição de uma palestra em um deck reveal.js, renderizado com um dos sistemas de design do repositório.

1. Escolha um sistema de design

Se um nome de sistema de design foi passado como argumento, use-o. Caso contrário, faça uma busca global por design-systems/*/brand-guidelines.md:

  • Nenhum encontrado: informe ao usuário para executar /design-system primeiro.
  • Exatamente um: avise o usuário de que existe apenas um sistema de design (nomeie-o) e confirme antes de prosseguir.
  • Múltiplos: leia o frontmatter description: de cada brand-guidelines.md e ofereça um seletor mostrando nome + descrição.

2. Obtenha a descrição do que mostrar

Aceite o que o usuário fornecer: texto inline ou um caminho para um arquivo. Se a descrição for muito vaga para sugerir uma estrutura básica (número de slides, linha narrativa), faça uma pergunta esclarecedora antes de gerar — não adivinhe silenciosamente, mas também não realize uma entrevista /grilling completa.

3. Escolha um nome para o deck

Se já existir um deck com esse nome em slides/<nome-do-deck>/, trata-se de uma edição — estenda/modifique os slides existentes em vez de regenerar o deck do zero (consulte docs/adr/0004-slides-edits-in-place.md). Caso contrário, é um deck novo.

4. Gere ou edite o deck

Escreva slides/<nome-do-deck>/ como um pequeno projeto reveal.js local (index.html + assets), referenciando o theme.css e os layouts/ do sistema de design escolhido por caminho relativo, sem copiá-los. Compunha os slides usando os layouts nomeados do sistema de design — não invente marcação de slides avulsa que os ignore.

Fora do escopo

Criação de um sistema de design — isso é função do /design-system, que esta skill apenas consome.

Habilidades Relacionadas