Communitygithub.com

textbook-upgrade

Reestruture livros didáticos, apostilas e materiais de cursos existentes. Use para diagnosticar capítulos, organizar aulas, editar material do aluno, desenhar atividades ou preparar roteiros graváveis a partir do acervo do instrutor.

¿Qué es textbook-upgrade?

textbook-upgrade is a Claude Code agent skill that reestruture livros didáticos, apostilas e materiais de cursos existentes. Use para diagnosticar capítulos, organizar aulas, editar material do aluno, desenhar atividades ou preparar roteiros graváveis a partir do acervo do instrutor.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/j-c-fstk-dev/TextbookUpgradeSkill/tree/main/skills/textbook-upgrade

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Textbook Upgrade

Identifique o público, a entrega solicitada e o material disponível. Adote o idioma do curso. Execute somente as etapas necessárias. Se o pedido for editar um capítulo ou roteirizar uma aula já definida, comece por ela. Quando o público for incerto, explicite a suposição e avance nas decisões reversíveis.

Para um pedido amplo como “melhore este material”, assuma a produção até a entrega. Comece pela entrevista e escolha de direção. Use as respostas já presentes nos anexos. Confirme a peça quando houver ambiguidade: apostila, roteiro ou ambos. Uma intenção futura de gravar aulas informa o contexto. Produza roteiro quando solicitado. Em pedidos pontuais, limite a entrevista às decisões que alteram aquela entrega.

Para a apostila, aplique o guia de direção visual e imagens antes de diagramar. Quando houver pedido de roteiro, aplique o guia de gravação. Antes de entregar qualquer peça, execute a revisão e devolutiva. Guarde o briefing e as decisões junto ao projeto privado para retomadas.

Quando o PDF é composto por imagens

Trabalhe em uma cópia privada. Teste a extração de texto por página e inspecione visualmente páginas representativas, incluindo uma página densa e outra com imagens ou legendas. Para páginas escaneadas use OCR no idioma do material, se disponível, ou transcrição visual dos trechos legíveis. Um DOCX, PPTX ou projeto original pode economizar trabalho, mas é opcional. Se faltar ferramenta de leitura, identifique o impedimento concreto e peça uma captura legível da página necessária.

Ao receber um pedido de formatação com preservação de conteúdo, mantenha redação, ordem, tabelas, legendas e relações entre figuras e texto. Um PDF com camada OCR ainda precisa ser diagramado para mudar o layout. Reconstrua os blocos editáveis e compare o resultado com a imagem original, inclusive números, nomes técnicos, acentos e ordem de leitura. Registre trechos incertos com a página de origem para confirmação. Avalie cada figura no tamanho final. Peça uma imagem melhor apenas onde a resolução comprometer um detalhe necessário. Para videoaulas, avalie a utilidade do texto para o roteiro separadamente da qualidade das imagens para exibição.

Use uma amostra para estimar a recuperação e fundamentar a entrevista inicial. Para diagramação de um material extenso, entregue uma prova conforme o fluxo abaixo antes de replicar o layout. Prossiga pelo escopo aprovado, registrando quais páginas foram recuperadas, conferidas ou ainda precisam de um original melhor.

Diagnosticar

Associe cada achado a uma página, seção, imagem ou minuto de gravação. Para cada problema que afete a aprendizagem, explique onde o aluno trava e proponha uma mudança concreta. Distinga uma correção editorial de uma dúvida técnica. Conserve termos, exemplos e relatos próprios do professor. Quando houver conflito entre fontes, registre ambas e formule a pergunta que resolveria o conflito.

Organizar o curso

Defina o que o aluno deve conseguir fazer ao final. Ordene as aulas pelos conhecimentos necessários para realizar a próxima tarefa. Se uma aula tiver dois objetivos independentes, considere dividi-la. Para cada aula, registre objetivo observável, pré-requisito, fontes, exemplo do instrutor, prática e evidência de aprendizagem. Use a ficha de aula quando houver mais de uma entrega ou quando o usuário pedir planejamento.

Editar a apostila

Abra o capítulo com um problema que o aluno reconheça. Apresente os conceitos na ordem em que serão usados. Desenvolva um exemplo antes de pedir aplicação independente. Torne explícito o que a imagem permite observar e escreva legenda e descrição acessíveis quando houver imagem. Use listas para sequências de ações e tabelas para comparações reais. Para ajustes pontuais, preserve as demais seções.

Provar a diagramação

Escolha páginas que exercitem decisões diferentes presentes no material (por exemplo, explicação densa, tabela e sequência ilustrada). Aceite a seleção do usuário, justifique a amostra em uma frase e leia as páginas vizinhas para recuperar referências e continuações. Para pedidos restritos a um trecho, entregue o próprio trecho no formato combinado.

Exporte uma prova versionada, abra o arquivo e percorra todas as páginas. Para celular, gere a partir do PDF uma imagem por página na largura de leitura combinada. Se a largura estiver delegada, escolha uma representativa e informe-a. Examine cada imagem sem ampliar. Confira se o aluno consegue seguir uma linha da tabela até a fonte, ler legendas, distinguir detalhes e reconhecer onde começa uma alternativa. Redistribua o conteúdo se faltar espaço. Confira novamente a exportação após corrigir.

Entregue a prova, as prévias e as pendências reais. Relacione páginas da prova às do original, preserve versões anteriores e diga como responder: “aprovado, aplique ao restante” ou “revise a página X”. Aguarde a aprovação visual para estender a diagramação. Acompanhe as dúvidas técnicas até a validação pelo responsável antes da publicação.

Criar atividades

Escolha uma tarefa que produza evidência do objetivo. Se a meta for observar, ofereça algo para examinar; se for decidir, forneça contexto suficiente para justificar a escolha. Entregue enunciado, resposta esperada, critério de aceitação e comentário sobre um erro provável. Sinalize ao instrutor quando a resposta depender de informação ausente.

Roteirizar a gravação

Determine o que exige demonstração e quais recursos estão disponíveis. Trabalhe a partir da ficha ou do capítulo indicado. Use o modelo de roteiro. Escreva falas naturais, sincronize cada explicação com o detalhe visível e inclua oportunidade para o aluno observar ou responder. Identifique tomadas que possam ser gravadas juntas. Indique recursos faltantes e proponha alternativa viável quando possível.

Conferir a entrega

Verifique se cada objetivo anunciado aparece na atividade e se o aluno dispõe das informações para resolvê-la. Confira números, termos e condições contra as fontes disponíveis. Mantenha as dúvidas para o autor separadas do texto destinado ao aluno. Ao revisar uma aula com múltiplas saídas, rastreie cada mudança factual na apostila, no roteiro e no gabarito. Se houver exportação, confira cortes de figuras, leitura de legendas e ordem de títulos no arquivo final. Entregue somente os formatos pedidos.

Skills relacionados