aula-interativa
Produz aulas guiadas em HTML sobre qualquer assunto — telas curtas com pouco texto, um botão Continuar, mocks realistas da ferramenta ou situação, diagramas animados e prática com feedback — e as revisa quadro a quadro via Playwright. Use quando o usuário quiser aprender nesse formato ou transformar material em uma aula interativa. Pergunta apenas idioma, assunto e profundidade ou quantidade de telas; executa pesquisa, roteiro, design, motion, captura, correção e entrega com os recursos incluídos.
How do I install this agent skill?
npx skills add https://github.com/gabrielgreco1/skills --skill aula-interativaIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides a robust framework and automated pipeline for generating interactive HTML lessons. It includes specialized scripts for asset bundling, browser-based frame capture, and visual auditing. It uses industry-standard tools like Playwright and Sharp, and incorporates security best practices such as blocking external network requests during the rendering and audit phases.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Aula interativa
Uma entrada simples deve acionar uma produção completa: uma aula que a pessoa quer seguir, em que sempre sabe o que olhar, o que ler e onde clicar, e ao fim consegue aplicar o conceito. Correção de conteúdo e determinismo são obrigatórios, mas não bastam: uma tela feia, cheia de texto ou confusa é um defeito com a mesma prioridade de um erro factual.
Entrada: somente três perguntas
Reutilize respostas explícitas do pedido e da conversa. Não pergunte novamente o que já foi respondido. Se faltar idioma, pergunte-o antes das demais perguntas e traduza o restante para a resposta escolhida.
- Qual idioma? / Which language? Português, English, Español ou outro.
- O que você quer aprender hoje? Aceite tema, problema, pergunta, ferramenta ou material.
- Qual profundidade? 1 — pouca, 2 — média, 3 — muita. Aceite também uma quantidade exata de telas.
| Escolha | Escopo | Telas curtas (faixa usual) |
|---|---|---|
| 1 | Um mecanismo central, um caso real, uma aplicação | 10–14 |
| 2 | Mecanismo, variações, caso real resolvido, duas práticas | 18–26 |
| 3 | Mecanismos internos, limites, operação, transferência | 30–40 |
Cada tela tem uma ideia. Profundidade vem de mais telas e passos e, quando o assunto pede, de um bloco de aprofundamento bem composto; nunca de telas desarrumadas. Respeite uma quantidade exata. Profundidade não é conhecimento prévio. Se o usuário delegar, use 2. Não acrescente questionário de estética, plataforma ou áudio. Não execute a entrada quando a tarefa for editar esta skill.
Leia antes de começar
| Quando | Recurso | Resultado |
|---|---|---|
| Sempre, primeiro | Experiência do aluno | Contrato de navegação, texto calmo (uma voz tipográfica), tipos de tela, composição |
| Sempre, antes do brief | Arco da aula | As 7 decisões e os 8 movimentos de uma aula impecável |
| Sempre, antes do roteiro | Escrita | Títulos, frases de passo, termos, feedback |
| Sempre, em cada portão | Qualidade e portões | Rubrica 1–5, portões P1–P5, falhas típicas de modelos |
| Sempre, antes de escrever código | examples/exemplar-dns/ e examples/mecanismo.html | O exemplar mostra o processo completo (brief, roteiro, fontes, aula); o mecanismo mostra a API mínima. Estude a forma, não copie o tema |
| Depois da entrada | Didática | Objetivos, pré-requisitos, progressão |
| Ao pesquisar | Fontes e interfaces | Evidências, versões, mocks honestos |
| Ao roteirizar | Roteiro de telas | Tabela fala · imagem · tipo; passos |
| Ao desenhar | Direção visual | Tokens, blocos do kit, geometria |
| Ao animar | Motion e Receitas | Tempo, easing, câmera, mocks animados |
| Ao implementar | Runtime e HTML | Player, kit, API de captura |
| Antes de entregar | Captura e revisão | Storyboard, frames, testes, reparos |
| Para julgar | Falhas e critérios | Critérios de aceitação |
Pipeline de produção
- Preparar.
node scripts/check_env.mjs --channel chrome. Reutilize umnode_modulesexistente com Playwright e Sharp (find ~ -maxdepth 4 -type d -path '*node_modules/playwright') viaLESSON_NODE_MODULES; instale em$WORK/toolingsó se não houver. - Pesquisar e decidir (portão P1). Preencha
$WORK/brief.mda partir detemplates/brief.md: as 7 decisões do arco, com caso único e resultados calculados. Objetivo observável, mapa de pré-requisitos, fontes primárias. Para software, verifique comandos, nomes e formatos de saída que vão aparecer nos mocks (execute-os se puder). Guardebrief.mdesources.jsonno diretório de trabalho$WORK: uma pasta própria da aula, fora da pasta da skill. - Roteirizar (portão P2). Escreva
$WORK/roteiro.mda partir detemplates/roteiro.md: uma linha por passo com movimento do arco, tipo, frase e imagem; preencha as conferências; faça o teste de leitura em voz alta de escrita. Antes de desenhar, confira: cada termo é definido antes de ser usado; cada conceito tem um mock ou desenho; o aprofundamento, quando houver, cabe num bloco só; afirmações sobre o caso não viram regra geral; os tipos alternam. É aqui que a aula fica boa ou ruim. - Montar. Copie a pasta
templates/para$WORK/source/templates/e a aula para$WORK/source/lesson.html, com<script src="templates/…">e<link href="templates/player.css">(o exemplo usa../templates/só porque mora dentro da skill). Parta deexamples/mecanismo.html. Monte cada tela com o kit (LessonKit.diagram,split,hero,terminal,app,quiz,cards) e o modelo calculado norender. Escolha a paleta do assunto nos tokens do:root; não reescreva o player. - Primeira impressão (portão P3). Com 2–3 telas prontas, capture e veja o storyboard; acerte tipografia, paleta e desenho antes de fazer o resto.
- Animar. Use
templates/motion.js(enter,stagger,spring,pulse,camera,typed). O movimento mostra o mecanismo; entradas são calmas; o passo termina parado. - Revisar em ciclos (portão P4). Capture keyframes em
1440x900,390x844e motion a 30 fps; gere o storyboard (desktop, celular e os cenários de erro) e leia tela por tela com o checklist de experiência; abra em tamanho real os passos com cara de problema; revise o motion pelas folhas de contato com a amostragem de captura e revisão; escreva testes da própria aula (cálculos, feedback de cada alternativa, navegação) em$WORK/test_aula.mjs; rodeaudit.mjs. Faça a autocrítica em três papéis e dê as notas da rubrica em$WORK/qualidade.md(qualidade). Corrija, recapture, repita até toda dimensão ter nota ≥ 4, o storyboard passar no checklist e a captura não ter problemas. - Empacotar e entregar (portão P5).
pack.mjsgera um HTML único; abra-o no navegador do usuário, salvo pedido em contrário. Entregue só o HTML. Roteiro, capturas e relatórios ficam em$WORK, nunca na pasta da skill nem junto da entrega; ao fim, avise que as capturas podem ser apagadas.
Não peça aprovação de roteiro ou keyframe. Decisões estéticas comuns são suas. Áudio, vídeo e 3D só entram se ajudarem o objetivo. A aula funciona sem som.
Invariantes
Experiência
- Arco completo com caso único: gancho, revelação, vocabulário, modelo, mecanismo, prova real, prática e fechamento.
- Uma ação principal (Continuar), sempre no mesmo lugar; o aluno nunca precisa de pausar, reproduzir ou reiniciar.
- Uma ideia por tela e uma frase-guia por passo. Texto longo é permitido num bloco de aprofundamento; poluição visual não: uma família, no máximo 4 tamanhos de texto por tela, poucas cores com papel, uma região de texto. Nenhuma fonte, citação ou nota de versão na tela: fontes vão em
sourcese aparecem no painel Fontes. - Todo termo técnico é definido (com desenho) antes de ser usado.
- O desenho ocupa a cena; no desktop a tela cabe em 1440×900 sem rolar; texto ≥ 11 px renderizado em todo viewport revisado.
- Mocks usam formatos verificados e trazem o selo “simulação”.
Execução
- O mesmo slide, passo, tempo e entradas produzem o mesmo frame, inclusive buscando fora de ordem. Nada de relógio, rede, aleatoriedade sem seed ou transição CSS na cena.
- Fonte, imagens e recursos carregam antes de
lesson.ready; falha de recurso é informada. - O modelo determina texto, cores, estados e feedback; a frase do passo deriva do mesmo estado do desenho.
- Interações têm consequência e feedback causal; uma resposta errada recebe a explicação do porquê.
- Dados reais, mocks, reconstruções e valores ilustrativos recebem rótulos corretos.
Comandos
$SKILL é a pasta desta skill; $WORK é a pasta da aula, fora dela. Use caminhos absolutos.
node $SKILL/scripts/check_env.mjs --channel chrome
node $SKILL/scripts/pack.mjs $WORK/source/lesson.html --out $WORK/out/lesson.html
node $SKILL/scripts/capture.mjs $WORK/out/lesson.html --out $WORK/qa/kf --mode keyframes --viewports 1440x900,390x844 --channel chrome
node $SKILL/scripts/storyboard.mjs $WORK/qa/kf/manifest.json # desktop
node $SKILL/scripts/storyboard.mjs $WORK/qa/kf/manifest.json --viewport 390x844 # celular
node $SKILL/scripts/storyboard.mjs $WORK/qa/kf/manifest.json --scenario errada # feedback de erro
node $SKILL/scripts/capture.mjs $WORK/out/lesson.html --out $WORK/qa/motion --mode motion --fps 30 --channel chrome
node $SKILL/scripts/contact_sheet.mjs $WORK/qa/motion/manifest.json --stride 3
node $SKILL/scripts/audit.mjs $WORK/out/lesson.html --capture $WORK/qa/motion/manifest.json --out $WORK/qa/audit.json --channel chrome
Apostila em PDF (quando o usuário pedir ou quando a aula for distribuída para impressão ou leitura offline): node $SKILL/scripts/pdf.mjs $WORK/out/lesson.html --out $WORK/out/lesson.pdf --channel chrome gera A4 paisagem: capa, uma página por tela (estado final da cena + as frases de todos os passos, em ordem), práticas sem resposta, gabarito com o feedback no fim e fontes com links. Abra algumas páginas do PDF antes de entregar.
Vídeo da aula (só se o usuário pedir): node $SKILL/scripts/video.mjs $WORK/out/lesson.html --out $WORK/video --channel chrome grava a aula sendo usada (cada passo anima, um cursor clica em Continuar, as práticas recebem a resposta certa) em 1920×1080, 1080×1080, 1080×1350 e 1080×1920, nativos. --formats escolhe formatos; --hold e --read ajustam as pausas. Assista a um quadro de cada formato antes de entregar.
test_player.mjs e test_tools.mjs testam o player e as ferramentas com o exemplo incluído; rode-os ao editar a skill, não para validar uma aula.
Sem --channel, usa o Chromium do Playwright. Não troque falha por silêncio nem marque inspeção visual como feita sem ter olhado.
Conclusão
Conclua quando: os portões P1–P5 passaram; toda dimensão da rubrica tem nota ≥ 4; o storyboard passa no checklist de experiência em desktop e celular; a captura não tem problemas; as animações foram inspecionadas; a prática tem feedback; o HTML final foi aberto e testado. Se uma verificação não puder ser feita, diga qual.
Na resposta final: onde está a aula (e abra-a), como navegar em uma linha (“Continuar ou →”), o PDF ou vídeo se foram pedidos, e limitações materiais. Ao editar esta skill: valide os scripts e o exemplo, rode test_player.mjs e test_tools.mjs, e não deixe artefatos de work/ no repositório.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/gabrielgreco1/skills/aula-interativa">View aula-interativa on skillZs</a>