Skills de Claude Code para propostas gamificadas de verdade
Sete skills que transformam qualquer conteúdo em uma experiência gamificada para a Educação Profissional e Tecnológica, seguindo a metodologia do curso Educatech Gamificação: LEVEL UP — pedagogia primeiro, narrativa depois, mecânicas por último. Cada etapa tem contrato, portão de qualidade e uma demo funcionando nesta página.
- DiagnósticoSemana 1
- NarrativaSemana 3
- MecânicasSemana 2
- EconomiaSemana 4
- Boss FightSemana 5
- Auditortodas
Como funciona
Um esquadrão, uma camada por vez
O orquestrador levelup-proposta lê seu conteúdo, faz a curadoria e chama cada skill de etapa em ordem. Cada etapa lê o que a anterior produziu, grava seu próprio arquivo e só avança quando passa no portão de qualidade. No fim, o auditor dá nota de 0 a 100, aponta red flags e corrige até 2 vezes.
Por que narrativa vem antes de mecânicas se o curso ensina mecânicas na Semana 2? Porque a doutrina que o próprio curso prega é pedagogia → narrativa → mecânicas: níveis, badges e checkpoints precisam nomear coisas que já existem no mundo da missão.
Toda skill também roda sozinha: se não encontrar as etapas anteriores, deduz o mínimo do seu pedido e registra as suposições.
O que aparece no seu projeto
propostas/
└── operacao-dados-limpos/
├── 00-curadoria.md ← conceitos, erros comuns
├── 01-diagnostico.md ← Canvas Inicial
├── 02-narrativa.md ← Mapa Narrativo
├── 03-mecanicas.md ← Mapa de Progressão
├── 04-economia.md ← Mapa de Economia
├── 05-boss-fight.md ← Plano de Boss Fight
├── auditoria.md ← nota + red flags
├── proposta.md ← documento final
└── proposta.json ← mesmo conteúdo, estruturado
No modo relâmpago só saem proposta.md e proposta.json (1 página).
Instalar
Opção A · Clonar e usar no repositório
As skills ficam em .claude/skills/levelup-*. Clone o repositório e abra o Claude Code dentro da pasta — elas são carregadas automaticamente.
git clone https://github.com/SauloCunha02/levelup-skills.git cd levelup-skills claude
Bom para versionar suas propostas (pasta propostas/) junto com as skills.
Opção B · Global (todos os projetos)
Depois de clonar, rode o instalador — ele copia as skills para ~/.claude/skills/:
./scripts/install.sh
.\scripts\install.ps1
Conferir: pergunte ao Claude "quais skills levelup você tem?" ou digite /levelup e veja o autocompletar.
Usar
1 · Comando direto
Chame a skill pelo nome e passe o conteúdo.
/levelup-proposta Técnico em Informática, Banco de Dados, consultas SQL com JOIN, 8 aulas, Moodle + laboratório. Modo completo.
2 · Linguagem natural
A descrição de cada skill dispara sozinha quando o pedido combina.
Gamifica essa apostila de NR-12 para Segurança do Trabalho: @apostila-nr12.pdf
3 · Uma etapa só
Use a skill da camada que você precisa agora.
/levelup-boss-fight transforma minha prova final de porcentagem em boss fight formativa
Dicas para tirar o máximo
- Dê o contexto mínimo de uma vez: curso, componente, conteúdo, carga horária, recursos. Se faltar algo essencial, a skill pergunta tudo numa rodada só.
- Nunca envie dados pessoais de estudantes. Use perfil geral ("turma com níveis diferentes de leitura"). As skills recusam e generalizam se aparecer.
- Relâmpago para testar ideias, completo para aplicar. Você pode começar relâmpago e depois pedir "agora no modo completo".
- Revise como autor. A seção "Decisões pendentes do professor" lista o que a IA não deve decidir por você.
- Já tem uma proposta?
/levelup-auditor @minha-proposta.mddá nota e plano de correção.
Exemplo que atravessa todas as demos: Operação Dados Limpos — Técnico em Informática · Banco de Dados · consultas SQL (SELECT, WHERE, JOIN, GROUP BY) · 8 aulas · Moodle + laboratório.
Proposta · orquestrador
levelup-proposta · encadeia todas as etapasRecebe qualquer conteúdo — tema solto, plano de aula, ementa, apostila em .md/.pdf/.docx — e entrega a proposta completa, auditada, em proposta.md + proposta.json.
- Entrada
- conteúdo + curso, componente, carga horária, recursos
- Modos
- relâmpago · 1 páginacompleto · 1 arquivo por etapa
- Saída
propostas/<slug>/- Gatilhos
- "gamifica esse conteúdo", "cria uma proposta gamificada", "monta a missão completa"
Passos
- Coleta de contexto (uma rodada de perguntas, no máximo)
- Curadoria: conceitos, procedimentos, erros comuns, conexão com o trabalho
- Diagnóstico → Narrativa → Mecânicas → Economia → Boss Fight
- Auditoria em modo correção (até 2 ciclos)
- Consolidação: modelo de proposta + JSON validável pelo schema
Simulação do pipeline
Veja o que acontece quando você roda o orquestrador no exemplo SQL.
Vocês são uma equipe de analistas de dados júnior da Cooperativa Vale Verde e precisam corrigir as consultas que geram os relatórios de produção para resolver a divergência nos pagamentos aos cooperados, produzindo um caderno de consultas validadas e um relatório técnico de correção.
Diagnóstico · Canvas Inicial
levelup-diagnostico · Semana 1 — Press StartConverte dor genérica ("eles não participam") em problema pedagógico específico, objetivo observável, evidência e missão inicial. Aqui ainda não existe XP, badge nem ranking — de propósito.
- Saída
01-diagnostico.md(Canvas Inicial)- Gatilhos
- "canvas inicial", "diagnóstico pedagógico", "qual seria o objetivo/evidência", "jogo ou gamificação?"
Fórmulas que a skill aplica
Problema: Durante [situação], [quem] não [comportamento observável], o que compromete [aprendizagem].
Missão: Vocês são ___ e precisam ___ para resolver ___, produzindo ___.
Portão de qualidade
- Problema tem situação, comportamento ausente e aprendizagem comprometida
- Objetivo com verbo observável (nada de "entender" sozinho)
- Evidência, sozinha, prova o objetivo
- ≥ 1 compromisso de inclusão concreto
- Nenhuma mecânica ainda · nenhum dado pessoal
Exemplo de saída — Canvas Inicial (trecho)
Dor: estudam só para a prova; não aplicam teoria.
Problema pedagógico: Durante as práticas de consultas SQL, boa parte da turma copia consultas prontas e não testa nem justifica o resultado, o que compromete a construção de consultas corretas e verificáveis para perguntas reais de negócio.
Objetivo: Construir consultas SQL com JOIN, filtros e agregações para responder perguntas de negócio, validando e justificando os resultados com base nos dados.
Evidência: caderno de consultas comentado (consulta + resultado + teste de validação + justificativa) e relatório técnico de correção.
| Versão | Atividade |
|---|---|
| Tradicional | Lista com 15 consultas para resolver. |
| Pontificação ✗ | Lista com 15 consultas, 10 pontos cada. |
| Gamificação profunda | Clãs recebem relatórios com divergência real; cada consulta corrigida e validada libera o próximo lote de dados da cooperativa. |
Inclusão: enunciados em texto + áudio; glossário SQL; entrega final escrita, oral ou em vídeo legendado.
Gerador de Canvas
Preencha e veja o portão de qualidade reagir. Experimente trocar o objetivo por "Entender JOIN".
Narrativa · Mapa Narrativo
levelup-narrativa · Semana 3 — Narrativa, mundo e escolhasConstrói lore mínima (≤ 120 palavras), mundo realista, problema-motor, papel ativo, NPCs com função, side-quests tipadas, escolhas significativas e documentos de mundo prontos — com teste anti-infantilização e checagem de estereótipos.
- Saída
02-narrativa.md- Gatilhos
- "lore", "storytelling", "NPC", "side-quest", "briefing", "essa narrativa ficou infantil?"
Portão de qualidade
- Problema-motor com contexto, tensão, investigação, produto e decisão
- Todo NPC tem função; ≥ 1 NPC inclusivo sem caricatura
- Side-quests com tipo e função (nunca castigo/passatempo)
- Escolhas exigem justificativa; nenhuma cosmética
- Sem infantilização nem estereótipos
Exemplo de saída — Mapa Narrativo (trecho)
Mundo: Cooperativa Vale Verde, 120 famílias associadas, sistema de registro de entregas de leite e grãos.
Problema-motor: na última assembleia, 14 famílias receberam menos do que entregaram. A diretoria suspeita das consultas SQL antigas e precisa de um diagnóstico antes da próxima assembleia.
| NPC | Função pedagógica |
|---|---|
| Dona Lúcia, presidenta | apresenta o problema; pede explicação em linguagem clara |
| Rafael, ex-técnico de TI | deixa pistas em comentários de código |
| Seu Joaquim, cooperado com baixa visão | pede relatório legível por leitor de tela → acessibilidade |
| Ana, auditora contábil | desafia decisões e exige evidências |
Escolha significativa: cada clã investiga Leite, Grãos ou Hortaliças e escolhe o formato final (relatório, apresentação oral, vídeo legendado) — justificativa com dados obrigatória.
Artefato de abertura: "Equipe, precisamos de ajuda antes da assembleia do dia 28. Quatorze famílias receberam menos do que entregaram e ninguém sabe explicar. O Rafael deixou as consultas sem documentação. Preciso entender o que aconteceu, em linguagem que todo cooperado entenda. — Lúcia, presidenta"
Detector de narrativa enfeite
Cole uma missão ou lore. A demo verifica a fórmula da missão, contexto profissional, inclusão, infantilização e fantasia sem função.
Mecânicas · Mapa de Progressão
levelup-mecanicas · Semana 2 — XP, níveis e clãsDesenha XP de aprendizagem em ciclo de 100, níveis que indicam mudança real, badges com critério e evidência, clãs com papéis e interdependência (TBL / peer instruction), checkpoints e recuperação safe-fail. Cada mecânica passa pela tríade mecânica → dinâmica → efeito pedagógico.
- Saída
03-mecanicas.md- Gatilhos
- "sistema de XP", "badges", "níveis", "clãs", "checkpoints", "ranking", "streak"
Portão de qualidade
- Ciclo soma 100 XP; zero XP de obediência
- XP de revisão e de colaboração presentes
- Badges com critério verificável + evidência
- ≥ 3 checkpoints; recuperação para cada erro provável
- Sem ranking individual por velocidade
Exemplo de saída — níveis e badges (trecho)
| Nível (autonomia) | XP | O que muda |
|---|---|---|
| Estagiário de Dados | 0 | escreve consultas a partir de modelo |
| Analista Júnior | 30 | roteiro parcial; testa com 1 caso |
| Analista | 60 | orientação mínima; valida com casos de teste |
| Analista Sênior | 90 | autonomia, justifica escolhas e mentora outro clã |
| Badge | Critério | Evidência |
|---|---|---|
| JOIN Certeiro | corrigir consulta com JOIN e provar com 2 casos de teste | consulta + saída + testes |
| Revisor de Qualidade | revisar 1ª versão indicando ≥ 3 melhorias | comparação entre versões + comentário |
| Relatório Acessível | relatório legível por leitor de tela | títulos, tabelas com cabeçalho, texto alternativo |
Clãs: 4 pessoas, papéis rotativos — escritor de consultas, testador, documentador, revisor de linguagem clara. Estrutura TBL.
Calculadora de XP · ciclo de 100
Edite ações, tipos e valores. A demo detecta XP de obediência, cobertura de tipos e o total do ciclo.
| Ação | Tipo de XP | XP | Remover |
|---|
Economia · Loja, cartas e crafting
levelup-economia · Semana 4 — Economia inteligente"Recompensa pedagógica boa não compra privilégio. Ela desbloqueia oportunidade de aprender melhor." A skill cria moeda com mensagem, ganhos diversificados, loja em 6 prateleiras, cartas com custo e limite, receitas de crafting, fundo coletivo e a lista pública do que nunca se vende.
- Saída
04-economia.md- Gatilhos
- "moedas", "loja", "recompensas", "cartas", "crafting", "jigsaw", "learning stations"
Portão de qualidade
- Nada essencial à venda (rubrica, legenda, critério, nota…)
- Nenhum item prejudica outro clã; toda carta tem limite
- ≥ 5 formas de ganho, incluindo revisão e colaboração
- Camada coletiva / fundo solidário presente
- ≤ 12 itens; regras explicáveis em 5 minutos
Exemplo de saída — economia (trecho)
Moeda: Bits de Cooperação — "testar, revisar e ajudar importa".
Nunca à venda: rubrica, enunciado, dados da missão, legenda/transcrição, tirar dúvida, nota.
| Carta | Custo | Limite | Função |
|---|---|---|---|
| Pista do Rafael | 2 | 1 por checkpoint | pergunta orientadora, não resposta |
| Segunda Versão | 3 | 1 por entrega | reentrega após feedback |
| Volta ao Mapa | 1 | 1 por ciclo | retomar após falta ou atraso |
| Clã Mentor | 2 | 2 por ciclo | consulta a outro clã |
Crafting: consulta + caso de teste + comentário = consulta validada.
Fundo coletivo: Silo Coletivo — 40 Bits desbloqueiam um plantão de revisão para a turma inteira.
Monte sua loja pedagógica
Selecione itens para a loja. Alguns parecem úteis, mas são direitos ou geram injustiça — a demo explica por quê.
Boss Fight Formativa
levelup-boss-fight · Semana 5 — Batalhas justas"A boa boss fight não elimina o estudante: revela o que ele domina, o que precisa revisar e qual é o próximo movimento." A skill monta o desafio integrador com 7 elementos, rubrica de 3 níveis (3–5 critérios observáveis), feedback 1+1+1, safe-fail, reentrega e recomposição por critério.
- Saída
05-boss-fight.md- Gatilhos
- "avaliação gamificada", "boss fight", "rubrica", "feedback", "transforma minha prova"
Portão de qualidade
- Os 7 elementos presentes
- Rubrica publicada antes; "Adequado" = essencial
- Todo critério com feedback 1+1+1 e recomposição
- Reentrega exige explicar o que mudou
- Sem ranking final, sem eliminação, IA não dá nota
Exemplo de saída — rubrica (trecho)
Assembleia da Transparência: os clãs apresentam à Dona Lúcia e à auditora Ana a causa da divergência, as consultas corrigidas e uma recomendação.
| Critério | Em desenvolvimento | Adequado | Excelente |
|---|---|---|---|
| Validação com evidência | apresenta resultado sem teste | valida cada consulta com ≥ 1 caso de teste | valida com casos-limite e explica por que cobrem o erro |
| Comunicação acessível | usa jargão sem explicação | explica a causa em linguagem clara para cooperados | adapta para leitor de tela e responde dúvidas com dados |
Feedback 1+1+1: "O JOIN de vocês resolve a duplicação de entregas. Ainda falta provar que nenhuma família ficou de fora. Rodem um LEFT JOIN com a tabela de cooperados e incluam a contagem no relatório."
Boss fight ou prova maquiada?
Construtor de feedback 1 + 1 + 1
Auditor
levelup-auditor · todas as semanasAudita qualquer proposta — sua, de colega ou gerada pelas skills — com rubrica de 16 critérios ponderados (0–100) e 28 red flags classificadas por severidade. Cita o trecho, explica o problema e entrega a versão corrigida pronta para colar.
- Saída
auditoria.md- Veredito
- ≥ 80 e sem crítica → Aprovada60–79 → Ajustes< 60 ou crítica → Redesenhar
- Gatilhos
- "revisa", "avalia", "dá nota", "audita minha proposta"
Red flags críticas
pontificaçãoranking excludentesem recuperaçãoestereótipoloja vende direitocompra de notaprova maquiadaacessibilidade como prêmiodados pessoais
Exemplo de saída — auditoria (trecho)
Nota: 88/100 · Veredito: Aprovada
| Sev. | Código | Trecho | Correção |
|---|---|---|---|
| média | R28 | "registrar XP de 6 ações por estudante a cada aula" | registrar por clã no checkpoint; individual só no diário de bordo |
| baixa | R20 | "Clã Mentor: 2 Bits" | adicionar limite: 2 por ciclo |
Decisão pendente do professor: o XP compõe parte da nota formal? Se sim, em qual proporção?
Scanner de red flags
Versão heurística (regex) só para ilustrar. A skill real lê semanticamente e aplica a rubrica completa.
Para devs
proposta.json + schema
Toda proposta sai também em JSON, validável pelo schema em .claude/skills/levelup-proposta/schema/proposta.schema.json (draft 2020-12). Use para renderizar a proposta num site, gerar cards de badges/cartas, popular o Moodle via API ou versionar no git.
npx -p ajv-cli@5 -p ajv-formats@3 ajv validate --spec=draft2020 -c ajv-formats -s .claude/skills/levelup-proposta/schema/proposta.schema.json -d "propostas/*/proposta.json"
import proposta from "./propostas/operacao-dados-limpos/proposta.json";
const total = proposta.mecanicas.xp.reduce((s, a) => s + a.xp, 0);
if (total !== 100) throw new Error(`Ciclo de XP soma ${total}, esperado 100`);
const vendeDireito = proposta.economia.loja.filter(i =>
proposta.economia.nuncaAVenda.some(n => i.item.toLowerCase().includes(n.toLowerCase())));
console.table(vendeDireito); // deve ser vazioAnatomia de uma skill
.claude/skills/ ├── levelup-proposta/ │ ├── SKILL.md ← orquestrador │ ├── referencias/modelo-proposta.md │ └── schema/proposta.schema.json ├── levelup-diagnostico/SKILL.md ├── levelup-narrativa/SKILL.md ├── levelup-mecanicas/SKILL.md ├── levelup-economia/SKILL.md ├── levelup-boss-fight/SKILL.md └── levelup-auditor/SKILL.md
Cada SKILL.md tem: frontmatter (nome + descrição que dispara a skill) → entrada (o que ler, o que perguntar) → procedimento numerado → modelo de saída → portão de qualidade → prompt de apoio para o professor.
Quer adaptar? Edite os portões de qualidade (ex.: ciclo de 200 XP), acrescente red flags no auditor ou crie levelup-moodle seguindo o mesmo contrato. As skills se encontram pelo nome da pasta.