asguth/grifo

Grifo-Skill

Gera material de estudo nível universitário sobre qualquer assunto, a partir de um tema ou de um arquivo do usuário: folhas A4 em duas colunas, hierarquia editorial sóbria, diagramas, tabelas, ilustrações e questões inéditas. Tudo passa por três revisores (conteúdo, didática, design) antes da entrega.

Caminhos abaixo são relativos à pasta deste SKILL.md.

Caminho	O que é	Quando ler
references/comandos.md	Sintaxe, flags e especificação de cada comando	Sempre: só a seção "Sintaxe" e a do comando
references/design.md	Paleta, estilos de cor, hierarquia, qual componente usar, ícones	Antes do HTML
references/ilustracoes.md	Figura didática: acervo aberto, gerador, licença e crédito	Quando o assunto tem estrutura física
references/idiomas.md	Material em outra língua: rótulos, fontes, exames de outros países	Se o idioma não for pt-BR
references/componentes.md	HTML de cada componente	Antes do HTML
references/fidelidade.md	Fontes, citação e referências com link	Antes de pesquisar
references/bancas.md	Estilo de bancas de concurso	Só se houver banca
agentes/*.md	Prompts dos 3 revisores	Etapa 6
assets/templates/*.html	Esqueleto de cada comando	Início da etapa 4
assets/lucide/nomes.txt	2.052 ícones Lucide (nome: tags)	Use grep, nunca leia inteiro
scripts/figura.py	Acervo curado por área, busca/baixa figura com licença aberta (Commons), gera molécula (RDKit) e gráfico (matplotlib)	Etapa 4, se houver figura
assets/acervo.json	61 figuras conferidas em 10 áreas (lido pelo figura.py acervo)	Não leia inteiro: use o script
scripts/verificar.py, montar.py, renderizar.py	Lint → HTML autocontido → PDF/PNG + revisão de layout	Etapa 5

Comandos

/<comando> <assunto ou arquivo> [--formato f] [--estilo e] [--nivel n] [--banca b] [--folhas N]
          [--material arq] [--idioma xx]

/resumo, /esquema, /lei-seca, /comparar, /pegadinhas, /questoes, /flashcards, /mnemonico, /edital, /cronograma, /revisao, /apostila, /validar, /grifo (ajuda). /cmd, cmd: e linguagem natural → mesmo fluxo. Flag desconhecida → avisar e seguir com o padrão. Comando inexistente → mostrar a ajuda do /grifo. Detalhes em references/comandos.md.

Fluxo (siga na ordem)

1. Entender o pedido — e perguntar quando faltar

Se o pedido não trouxer assunto/arquivo ou formato, pergunte uma vez, numa única mensagem (no Claude Code, com a ferramenta de pergunta se houver), oferecendo opções:

1. Assunto ou arquivo: "Sobre qual assunto — ou qual arquivo (PDF, slides, anotações) — você quer o material?"
2. Formato:
   • Explicação completa — resumo didático (2–4 folhas por padrão, sem limite) + questões + gabarito (/resumo);
   • Só o mapa — esquema visual, 1 folha por padrão (/esquema);
   • Revisão rápida — véspera, 1 folha por padrão (/revisao);
   • Treino — questões + gabarito comentado (/questoes) ou flashcards;
   • Tudo incluso — capa, sumário, resumo, mapa, flashcards, questões e gabarito (/apostila).
3. Estilo visual (cada pessoa aprende de um jeito):
   • Sóbrio — azul-marinho e cinza, cor só onde tem significado (padrão);
   • Colorido — cada tópico com uma cor diferente, faixas cheias;
   • Pastel — cores por tópico em tons suaves, fundos claros;
   • P&B — tons de cinza, para imprimir em preto e branco.
4. Nível (só se não der para inferir): ensino médio, faculdade (padrão), concurso (pergunte a banca), certificação.

O formato só conta como definido quando veio de comando com barra (/esquema, /revisao…), de --formato, ou de palavras explícitas do usuário ("só o mapa", "revisão rápida", "com questões"). Em linguagem natural, "faz uma apostila/resumo/material de X" não define o formato: pergunte. Quando for perguntar, pergunte o estilo junto, na mesma mensagem. Com assunto e formato definidos, não pergunte mais nada: estilo não informado = o que o usuário já usou nesta conversa, senão sóbrio (e cite --estilo colorido|pastel|pb em uma linha na entrega). Pedidos como "mais colorido", "menos cor", "pra imprimir em P&B" mudam o estilo.

Idioma: escreva o material e responda na língua do usuário (ou --idioma). Fora de pt-BR, leia references/idiomas.md antes do HTML. Liberdade de criação: escolha componentes, ordem e ênfase pelo que ensina melhor.

2. Levantar o conteúdo (fidelidade antes de beleza)

Ler references/fidelidade.md. Material do usuário > fonte oficial/primária > literatura de referência. Todo número, data, fórmula, artigo ou definição técnica é conferido; sem fonte acessível → <span class="verificar">. Guarde as fontes com URL para as referências.

3. Roteiro didático (nível faculdade)

Para cada subtema: definição precisa → mecanismo/por quê → exemplo → erro comum. Escolha o componente pela forma do conteúdo (references/design.md §3) e ilustre tudo que tem estrutura. Texto corrido só para conceito, curto e grifado.

4. Escrever o HTML-fonte a partir do template

Copie assets/templates/<comando>.html para <slug>-fonte.html e troque todo [[MARCADOR]].

• <html lang="…" data-tema="sobrio|colorido|pastel|pb"> conforme idioma e estilo (design.md §1.1). Cor fixa por tópico: class="cor-1" … cor-6 no bloco/coluna.
• Só classes do design system (references/componentes.md); style="" só para ajuste pontual.
• Sem limite de folhas: o tamanho do comando é padrão, não teto. Conteúdo que não cabe vai para nova .folha; nunca corte conteúdo para caber, salvo --folhas N do usuário.
• Questões sempre em coluna única, numa folha só delas. Gabarito comentado e referências em folha separada, depois das questões (nada de spoiler na mesma folha).
• Referências com link: <a href="URL oficial">título</a>.
• Ícones: Lucide (<svg class="ico"><use href="#l-NOME"/></svg>, ache o nome com grep -i termo assets/lucide/nomes.txt), só quando dizem algo do bloco.
• Assunto com estrutura física (anatomia, fisiologia, célula, planta, molécula, circuito, montagem de laboratório, mapa): a figura é o centro da folha e vem de acervo aberto (scripts/figura.py acervo, depois buscar/baixar) ou de gerador a partir de dados (figura.py molecula, figura.py grafico). Nunca desenhe estrutura acadêmica de cabeça: a IA erra anatomia sem perceber. Crédito obrigatório. Método em references/ilustracoes.md.

5. Verificar, montar e renderizar

python3 <skill>/scripts/verificar.py <slug>-fonte.html
python3 <skill>/scripts/montar.py <slug>-fonte.html <slug>.html     # [--fontes-embutidas]
python3 <skill>/scripts/renderizar.py <slug>.html <saida> --json     # [--pb]

Corrija todo ERRO do lint e todo aviso de layout (estouro, transbordo, colunas desequilibradas, fonte < 8 pt) antes de seguir. Sem Python/navegador: entregue o HTML (Ctrl+P → A4, sem margens, gráficos de fundo).

6. Validação (3 revisores que não escreveram o material)

Com subagentes: rode os três em paralelo, cada um com o seu agentes/*.md + caminhos do HTML e dos PNGs + fontes usadas. Sem subagentes: três passes em sequência, relendo do zero. Corrija BLOQUEANTES e IMPORTANTES, remonte e renderize (máx. 2 rodadas).

7. Entregar

HTML + PDF. Em 2–4 linhas: o que foi gerado, estilo usado, [VERIFICAR] restantes, fontes principais e créditos das figuras. Termine com uma linha de aviso: material gerado com IA para apoio ao estudo; não substitui livros, aulas nem fontes oficiais; confira.

Regras inegociáveis

1. Fidelidade > estética. Nada de memória sem conferência; dúvida = [VERIFICAR].
2. Direitos autorais. Não copiar texto, esquemas ou questões de terceiros. Imagem de terceiros só com licença aberta (CC0, domínio público, CC BY, CC BY-SA) e crédito. Atos oficiais podem ser citados literalmente (Lei 9.610/98, art. 8º, IV).
3. Sem retratos de pessoas reais (cite o nome do autor no texto).
4. Legível em P&B. Cor nunca é o único portador de significado: ícone + rótulo. Em figura, a legenda diz o que cada cor significa.
5. Densidade de apostila. Frases diretas, sem "neste resumo veremos"; bloco > 6 linhas sem destaque = reescrever.
6. Aviso de IA em toda folha. O rodapé já imprime "gerado com IA: confira nas fontes" (via CSS, traduzido por lang); não remova. O material auxilia o estudo e não substitui livro, aula, atlas, lei oficial nem orientação profissional.