mira-validator
Valida o HTML gerado pela /mira-builder, checando conformidade visual, estrutural e de assets. Use SEMPRE que a /mira-builder terminar de gerar um index.html, ou quando o usuário quiser verificar a qualidade de uma apresentação existente, revisar se os slides seguem o padrão, ou diagnosticar problemas visuais em slides já criados.
ソース情報
- リポジトリ
- sandeco/mira-animator
- ソースの最終更新活動
- 2026年7月26日 23:56
- 検出された SKILL.md の言語
- ポルトガル語
- スター
- 202
- フォーク
- 58
インストール方法
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
ソースファイルを確認
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
SKILL.md を表示中
SKILL.md
ソースの指示 · 読み取り専用プレビュー- name
- mira-validator
- description
- Valida o HTML gerado pela /mira-builder, checando conformidade visual, estrutural e de assets. Use SEMPRE que a /mira-builder terminar de gerar um index.html, ou quando o usuário quiser verificar a qualidade de uma apresentação existente, revisar se os slides seguem o padrão, ou diagnosticar problemas visuais em slides já criados.
# Skill: Validador de Slides
## Objetivo
Inspecionar o `index.html` gerado pela `/mira-builder` e produzir um relatório de conformidade: estilo, assets, estrutura HTML e boas práticas do padrão do projeto. Chamada automaticamente pela `/mira-builder` após gerar o HTML, ou manualmente para validar uma apresentação existente.
## Fluxo de Execução
### Passo 1: Localizar o arquivo
Identifique o `index.html` a validar:
- Chamado pela `/mira-builder`: caminho conhecido `decks/<deck>/index.html`
- Chamado pelo usuário: pergunte qual capítulo ou aceite o caminho direto
### Passo 2: Ler o HTML completo
Leia o `index.html` inteiro.
### Passo 3: Executar as verificações
Execute cada verificação abaixo e registre PASS ou FAIL com detalhes.
---
## Checklist de Verificações
### A. Cores (crítico)
| # | Verificação | Como checar |
|---|------------|-------------|
| A1 | Cor primária é `#FF904D` | Buscar ocorrências de `#FF904D` (deve existir). Buscar `#FFA203` ou `#e47d5b` (não deve existir) |
| A2 | Fundo é `#000000` | Buscar `background: #000000` no body. Buscar `#222222` ou `#1a1a2e` (não deve existir) |
| A3 | rgba usa `255, 144, 77` | Buscar `rgba(255, 144, 77` (deve existir). Buscar `rgba(255, 162, 3` (não deve existir) |
### B. Identidade Visual (crítico)
| # | Verificação | Como checar |
|---|------------|-------------|
| B1 | Logo no header | Buscar `<img` com `canal_sandeco_logo.png` dentro do `<header>` |
| B2 | Logo no footer | Buscar `<img` com `canal_sandeco_logo.png` após o `</main>` |
| B3 | Arquivo logo existe | Verificar se `canal_sandeco_logo.png` existe na pasta do slide |
| B4 | Nenhum SVG genérico no lugar da logo | Buscar `<svg` próximo de "sandeco" ou "logo" (não deve existir) |
### C. Vídeos (crítico)
| # | Verificação | Como checar |
|---|------------|-------------|
| C1 | Vídeo no header | Buscar `<video` dentro do `<header>` com `src="header-bg.mp4"` |
| C2 | Arquivo header-bg.mp4 existe | Verificar se o arquivo existe na pasta do slide |
| C3 | Atributos obrigatórios | Todo `<video` deve ter `autoplay`, `loop`, `muted`, `playsinline` |
| C4 | Opacidade 50% | Todo `<video` deve ter `opacity: 0.5` ou `opacity-50` |
| C5 | Overlay gradient | Após cada `<video`, deve haver um `<div` com `linear-gradient` |
### D. Layout dos Cards (importante)
| # | Verificação | Como checar |
|---|------------|-------------|
| D1 | Largura `max-w-5xl` | Cards devem usar `max-w-5xl`. Buscar `max-w-3xl`, `max-w-2xl`, `max-w-6xl` em cards (não deve existir, exceto dentro de parágrafos `<p>` onde `max-w-3xl` é permitido) |
| D2 | Padding adequado | Cards devem usar `p-8` ou `p-10`. Buscar `p-16` em cards (não deve existir) |
| D3 | Gap entre cards | `<main>` deve ter `gap-[60vh]` |
| D4 | Glassmorphism | Deve existir `backdrop-filter: blur(10px)` no CSS |
### E. Tipografia (importante)
| # | Verificação | Como checar |
|---|------------|-------------|
| E1 | Fonte Inter | Buscar `fonts.googleapis.com` com `Inter` no `<head>` |
| E2 | Títulos de card | Títulos `<h3>` dentro de cards devem usar `text-3xl` ou `text-4xl`. Buscar `text-5xl` em `<h3>` (não deve existir) |
| E3 | Título principal | O `<h1>` do header pode usar `text-5xl` ou `text-7xl` (permitido) |
### F. Estrutura e Navegação (importante)
| # | Verificação | Como checar |
|---|------------|-------------|
| F1 | Barra de progresso | Buscar `id="reading-progress"` |
| F2 | Botão próximo card | Buscar `id="next-card"` |
| F3 | Botão começar no header | Buscar `id="header-next-btn"` |
| F4 | AOS inicializado | Buscar `AOS.init` |
| F5 | Lucide inicializado | Buscar `lucide.createIcons` |
| F6 | D3.js carregado | Buscar `d3.v7` no `<head>` (se houver cards D3) |
| F7 | setupFullScreenWrappers | Buscar `setupFullScreenWrappers` |
### G. Conteúdo e Composição (qualidade)
| # | Verificação | Como checar |
|---|------------|-------------|
| G1 | Mínimo de cards | Contar elementos `glass-card` ou cards dentro de `<main>`. Mínimo: 8 |
| G2 | Variedade de templates | Identificar tipos de cards usados. Mínimo: 3 tipos diferentes |
| G3 | CTA presente | Buscar indicadores de card CTA (botão de ação, link para livro/canal) |
| G4 | Sem cards repetidos em sequência | Verificar se não há 2 cards do mesmo tipo seguidos |
| G5 | Sem placeholders residuais | Buscar `[TITULO]`, `[DESCRICAO]`, `[DELAY]`, `[ICONE]` e outros placeholders não substituídos |
| G6 | Sem número de slides no header | Buscar `[DESTAQUE_NUMERICO]` (não deve existir) |
### H. Assets do Capítulo (importante)
| # | Verificação | Como checar |
|---|------------|-------------|
| H1 | Imagens referenciadas existem | Para cada `<img src="...">` no HTML, verificar se o arquivo existe na pasta |
| H2 | Vídeos referenciados existem | Para cada `<source src="...mp4">`, verificar se o arquivo existe na pasta |
### I. Segurança (importante)
| # | Verificação | Como checar |
|---|------------|-------------|
| I1 | Código escapado | Em blocos `<code>` ou `<pre>`, buscar `<` e `>` não escapados (exceto tags HTML internas). Deve usar `<` e `>` |
---
## Passo 4: Gerar o Relatório
Apresente o relatório neste formato:
```
# Relatorio de Validacao: [Capitulo]
**Arquivo:** decks/<deck>/index.html
**Data:** YYYY-MM-DD
**Total de verificacoes:** XX
**Passou:** XX | **Falhou:** XX | **Avisos:** XX
## Resultados
### Criticos (devem ser corrigidos)
- [FAIL] A1: Cor #FFA203 encontrada nas linhas 45, 112
- [PASS] B1: Logo presente no header
### Importantes (recomendado corrigir)
- [FAIL] D1: Card na linha 89 usa max-w-3xl em vez de max-w-5xl
- [PASS] E1: Fonte Inter carregada
### Qualidade (sugestoes)
- [WARN] G4: Cards 3 e 4 sao ambos card_lista
- [PASS] G1: 12 cards encontrados
## Correcoes Sugeridas
Para cada FAIL, indique:
1. **Linha(s):** onde esta o problema
2. **Atual:** o que esta escrito
3. **Correto:** o que deveria estar
4. **Como corrigir:** instrucao especifica de edicao
```
### Níveis de severidade
- **Crítico** (categorias A, B, C): Problemas visuais graves ou assets faltantes. Não publicar sem corrigir.
- **Importante** (categorias D, E, F, H, I): Desvios do padrão que afetam qualidade mas não impedem o uso.
- **Qualidade** (categoria G): Sugestões de composição e variedade.
## Passo 5: Oferecer correção automática
Após o relatório, pergunte:
> "Encontrei **X problemas**. Quer que eu corrija automaticamente os itens críticos e importantes?"
Se aceitar, aplique as correções no `index.html` com edições pontuais (Edit tool) e rode a validação de novo para confirmar.
## Notas
- NÃO modifica o conteúdo textual dos slides, apenas problemas técnicos e de conformidade
- Problema ambíguo (ex: card poderia ser lista ou grid): classifique como WARN, não FAIL
- Placeholders residuais (G5) são sempre FAIL crítico: indicam montagem incompleta
GitHubで見る