Suporte upstream empacotado

Arquivos de suporte são incluídos em caminhos relativos à skill. Veja UPSTREAM-NOTICE.md para suas fontes fixadas, licenças, hashes e alterações de importação.

SlideOps: slides de um repositório, que avisam quando ficam desatualizados

Cópia do catálogo, congelada em v1.0.0. A fonte canônica é glukicov/slideops, que também contém o modelo de apresentação, os dois scripts de citação, os documentos de referência e a skill slides-to-pdf complementar. Instale a partir daí; esta página resume o fluxo de trabalho.

Visão Geral

SlideOps tem duas tarefas, e a segunda é o ponto principal. Construir: transformar um repositório em um único deck de slides HTML autocontido, cujas afirmações vieram do código, não da impressão do código por um modelo. Manter sincronizado: tornar esse deck capaz de provar, meses depois, se ele ainda corresponde ao repositório.

O mecanismo que os une é uma citação. Cada trecho citado registra o arquivo, o intervalo de linhas e um hash dessas linhas de origem no momento da construção, e o deck registra o commit de onde foi construído. "Esses slides ainda estão precisos?" se torna um comando em vez de uma releitura: um script Python da biblioteca padrão compara cada citação com o código atual e relata CURRENT, MOVED, CHANGED ou MISSING. Sem modelo, sem rede, sem tokens, milissegundos para executar.

Quando Usar Esta Skill

• Use quando o usuário pedir slides, um deck de slides ou uma apresentação sobre um repositório de código, um de seus subsistemas, um recurso ou suas alterações recentes: "fazer slides", "deck de visão geral", "slides de atualização da equipe", "slides HTML para este repo".
• Use quando o usuário perguntar se um deck existente ainda corresponde ao código, ou quiser que um seja verificado novamente, atualizado ou mantido sincronizado: "este deck ainda está preciso", "verificar os slides contra o código", "estes docs estão desatualizados".
• Use quando o usuário quiser que a atualização do deck seja integrada ao CI, a uma verificação de pull request ou a um hook de agente: "falhar na construção quando o deck parar de corresponder ao código".
• Não use para decks de slides sobre qualquer coisa que não seja uma base de código (um deck de vendas, uma palestra); o mecanismo de citação assume um repositório git como a fonte da verdade.

Como Funciona

Etapa 1: Instalar do repositório canônico

No Claude Code, como um plugin (ambas as skills, atualizações em segundo plano):

/plugin marketplace add glukicov/slideops
/plugin install slideops@slideops

Ou para Codex CLI, Copilot CLI e OpenCode, um instalador cobre todos eles:

git clone https://github.com/glukicov/slideops && cd slideops
git checkout ba43e89bc7936649be36a1796a62203f704f8c60   # the v1.0.0 release commit
./install.sh

O checkout fixa o commit exato em que esta cópia do catálogo foi congelada, o que um leitor pode verificar independentemente. (O repositório canônico também bloqueia o retargeting de tags v* com um ruleset de tags ativo, mas um SHA não pede que você confie nisso.) install.sh cria links simbólicos para as duas skills em ~/.claude/skills (lido por Claude Code e OpenCode) e ~/.agents/skills (lido por Codex CLI e Copilot CLI).

Etapa 2: Construir um deck

A skill percorre um pipeline fixo: uma varredura de repositório de dois minutos, uma entrada compacta (tópico, público, duração, tema, escopo, extras), um ponto de verificação do esboço antes que qualquer HTML seja escrito, e então a construção slide a slide a partir de um modelo verificado. Cada trecho é citado conforme é escrito. Execute o script de citação de dentro do repositório que está sendo apresentado, através de seu caminho de instalação (um agente resolve scripts/ contra o diretório da própria skill automaticamente; os caminhos abaixo são para executá-lo você mesmo após install.sh):

python3 ~/.agents/skills/slideops/scripts/cite.py app/main.py:40-58 --repo . --snippet   # prints data-src + data-sha256
python3 ~/.agents/skills/slideops/scripts/cite.py --stamp deck.html --repo .             # stamps the build commit

--repo sempre aponta para o repositório sobre o qual o deck é, nunca para o checkout do SlideOps.

Cada slide é então renderizado com Chrome headless e visualmente verificado antes que o deck seja considerado pronto.

Etapa 3: Verificar depois, de graça

De dentro do repositório que está sendo apresentado, mesma convenção de caminho da Etapa 2:

python3 ~/.agents/skills/slideops/scripts/check.py docs/slides/ --repo .

Saída real, do deck de demonstração que acompanha a skill:

Deck: skill-demo.html
Built: commit=179bbdb date=2026-08-28 repo=slideops

  slide   9  THEMING        skills/slideops/assets/template.html:22-45    CURRENT

…