Communitygithub.com

study-site

Use ao criar qualquer página de estudo, anotações de capítulo, revisão ou preparação para provas, ou índice de curso — a partir de slides, PDFs, provas antigas, listas de exercícios ou apenas um nome de tópico.

O que é study-site?

O skill **study-site** permite construir páginas de estudo interativas e completas em HTML single-file, publicadas como artefatos (ou salvas em `.html` quando artefatos não estão disponíveis). Cada página parte do template `assets/template.html`, garantindo que funcionalidades padrão como tema claro/escuro, busca, progresso e salvamento de perguntas sejam sempre incluídas. O skill é útil para desenvolvedores, educadores e estudantes que desejam criar materiais de estudo ricos e responsivos a partir de slides, PDFs, provas antigas ou listas de exercícios, sem precisar de ferramentas externas. Ele funciona em qualquer agente que suporte a geração de artefatos HTML, como Claude Code, Cursor ou Codex, e segue regras pedagógicas detalhadas: assume conhecimento zero, organiza seções por tópico, inclui diagramas SVG inline com explicações, perguntas de múltipla escolha com feedback, e modo prova com cronômetro. O processo começa com uma rodada de perguntas para identificar o curso e o índice onde a página será listada, depois lê todo o material anexo, corrige erros silenciosamente e constrói a página respeitando uma estrutura predefinida de explicação → diagrama → exercício resolvido → questões de provas → MCQs práticos. O resultado é uma página independente que pode ser compartilhada por link e salva no navegador do usuário com progresso e notas locais.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Ranjit-choudhary/claude-skills-ranjit/tree/HEAD/study-site

Perguntar na sua IA favorita

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

Documentação

Site de Estudo

Construa páginas de estudo HTML interativas em um único arquivo, publicadas como artefatos (ou salvas como arquivos .html quando artefatos não estiverem disponíveis). Toda página parte de assets/template.html, para que as funcionalidades padrão nunca sejam esquecidas.

0. Configurações — edite para você

ConfiguraçãoValor
URL do índice mestre (hub que liga todos os cursos)none — defina a URL do seu hub, ou deixe none para pular atualizações do índice
Tema padrãolight (um alternador de tema escuro é sempre incluído)
Navegação entre capítulosApenas link de volta ao índice do curso — sem links de capítulo anterior/próximo
Estilo do cartão de índiceMínimo: ícone, código do curso, nome do curso — sem estatísticas

1. Pergunte primeiro (uma rodada de perguntas)

Pergunte apenas o que já não estiver claro a partir da solicitação:

  1. Isto é para um curso? Se sim: qual curso, qual capítulo ou bloco. Uma página de curso recebe modo prova e ferramentas de revisão além dos recursos padrão; uma página sem curso (tópico geral, explicador único) os ignora.
  2. Onde deve ser listado? Diretamente no índice mestre, dentro de um índice de estudo do curso (qual), ou em nenhum lugar. Pule esta pergunta se a configuração do índice mestre for none.
  3. Se a URL do índice de estudo do curso não for conhecida, pergunte por ela — o link de volta da página precisa dela.

Se o usuário tiver anotações salvas sobre como deseja que um curso seja ensinado (memória, instruções de projeto, mensagens anteriores), leia-as e siga-as, sobrepondo os padrões abaixo.

2. Reúna o material antes de construir

  • Leia cada arquivo anexo completamente: slides, anotações, provas antigas, listas de exercícios.
  • Colete as questões de anos anteriores (PYQs) e as questões de lista de exercícios pertencentes a cada tópico.
  • Corrija silenciosamente erros no material de origem; não os aponte a menos que seja perguntado.
  • Só então planeje a lista de tópicos: uma <section class="topic"> por tópico lógico, pequena o suficiente para ser concluída em uma sessão.

3. Regras de ensino (todas as disciplinas)

  • Assuma nenhum conhecimento prévio. Construa a partir do básico, defina cada termo no primeiro uso, elabore em vez de comprimir.
  • Ordem dentro de cada tópico: explicação → diagrama imediatamente após → explicação do diagrama → exemplo resolvido → questões PYQs/de lista → MCQs práticos. Nunca agrupe diagramas no final.
  • Todo diagrama recebe uma explicação. Nunca entregue um diagrama sem explicação.
  • Marque pontos importantes para prova com .callout.imp e armadilhas comuns com .callout.mistake.
  • Questões: escreva cada questão por completo antes de sua solução, nunca condensada. Responda a cada questão; não deixe nenhuma sem resposta. Marque PYQs com fonte, ano e pontos (ex.: PYQ 2024 Midsem · 5M).
  • Pelo menos 3 MCQs práticos por tópico, com distratores plausíveis e uma explicação .why.
  • Diagramas são SVG inline, nunca ASCII. Use um .stepper (um figure.fig.step por estado) para qualquer coisa que evolua passo a passo.
  • Sem cronogramas de estudo ou planos de dias, a menos que seja solicitado.

4. Adapte por disciplina

Tipo de disciplinaÊnfase
Teoria / provas (teoria da computação, matemática discreta, algoritmos)Diagramas de estados para cada autômato; steppers que rastreiam strings de entrada; templates de prova (lema do bombeamento, reduções, indução) como passos preenchíveis; muitos exemplos pequenos
Sistemas (sistemas operacionais, arquitetura de computadores, redes)Visual primeiro; steppers para pipelines, gráficos de Gantt de escalonamento, substituição de páginas, consultas de cache; exercícios numéricos resolvidos passo a passo; exercícios de final de capítulo de livro-texto
Linguagens / notação formal (linguagens de programação, compiladores)BNF/EBNF, árvores sintáticas e gramáticas de atributos como árvores SVG limpas; regex construído peça por peça; questões de lista resolvidas inline
Matemática pesada (aprendizado de máquina, estatística, sinais)Intuição primeiro, depois a derivação linha por linha com cada passo justificado; gráficos em SVG; exercícios de livro-texto resolvidos
Descritivo (biologia, administração, humanidades)Orientado por provas antigas: agrupe PYQs por tema, respostas modelo no tamanho da prova, fluxogramas e tabelas de comparação para processos

Escolha a linha mais próxima para uma disciplina não listada. As anotações do próprio usuário sobre o curso substituem esta tabela.

5. Recursos da página (incorporados ao template)

RecursoComo funcionaSua tarefa
Tema claro + alternador escuroClaro por padrão; 🌙 alterna; escolha lembradaUse apenas as variáveis CSS — sem cores fixas
Restauração de rolagemPosição salva e restaurada ao reabrirNada
Acompanhamento de progresso"Marcar como concluído" por tópico, barra de progresso, ✓ no índiceid único em cada seção de tópico
BuscaFiltra tópicos e destaca correspondênciasNada
Copiar imagemBotão ao passar o mouse em cada figure.fig copia um PNG (sempre visível em toque)Envolva cada diagrama ou imagem em figure.fig
Amigável para mobileResponsivo; tabelas rolam lateralmenteMantenha SVG baseado em viewBox; sem larguras fixas
MCQs práticosFeedback instantâneo; respostas lembradasdata-answer = índice 0 da opção correta
Mostrar respostadetails.answerUse para toda solução de formato longo
Link de voltaCabeçalho linka ao índice de estudo do cursoPreencha {{COURSE_INDEX_URL}}
Apenas páginas de curso: ferramentas de revisãoCola (.cheatsheet) + flashcards (.flashdeck)Resumo de uma página de fórmulas, definições, diagramas-chave; 10+ flashcards
Apenas páginas de curso: modo provaBorrado até Iniciar; cronômetro; MCQs corrigidos ao Enviar; respostas modelo reveladasMisture MCQs (data-marks) e questões longas no estilo das provas antigas do curso; defina data-minutes

Progresso e pontuações ficam no navegador do visualizador, por página — uma página de índice não pode mostrar progresso de capítulo, e nada sincroniza entre dispositivos.

6. Regras de design

  • Mínimo e calmo. Corpo serifado para leitura longa, UI sem serifa. Largura de conteúdo ~820px.
  • Evite {" "}AI-slop: sem gradientes roxos, banners hero, layouts centralizados, Inter ou confetes de emoji.
  • Cor carrega significado: azul = informação, dourado = importante para prova, vermelho = erro, verde = correto/concluído.
  • Diagramas SVG: rotule tudo; use var(--text), var(--accent) etc. para traços e preenchimentos; texto ≥12px em largura mobile.

7. Páginas de índice de estudo do curso

Para um índice ou hub de curso: cartões mínimos (veja configurações), mesmo cabeçalho (busca + alternador de tema), restauração de rolagem, tema claro padrão.

8. Construa, publique, verifique

  1. Copie assets/template.html, preencha os {{placeholders}}, remova os blocos exclusivos de curso para páginas sem curso (ou descomente-os para páginas de curso).
  2. Publique como artefato (ou salve o .html). Mostre primeiro; verifique depois.
  3. Verifique em desktop e largura ~390px, em ambos os temas: cada figura tem botão de cópia, cada MCQ tem data-answer correto, cada questão tem resposta, nenhum {{placeholder}} permanece.
  4. Adicione o link da página ao índice mestre ou de curso conforme escolhido na etapa 1. Não redesenhe o índice.

Habilidades Relacionadas