convez.ai
SkillProdutividadeIntermediário
OctavianTocan

Teach — Loop Socrático de Aprendizado

OctavianTocan/teach

Quiz interativo Socrático para consolidar aprendizado em sessões Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill que transforma sessões Claude em quizzes interativas de maestria. Extrai conceitos de transcrições de sessão ou arquivos, monta checklists concretos e testa sua compreensão pergunta por pergunta até você dominar tudo. Funciona em modo solo ou para ensinar terceiros.

Instalação

$npx convez-ai OctavianTocan/teach

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Revisar e consolidar conceitos aprendidos em sessões de código
  • Validar maestria antes de passar para próximo tópico
  • Estruturar uma aula para ensinar alguém usando transcripts de sessão

Veredito

Skill bem pensada que implementa pedagogia Socrática de forma concreta — ideal para quem quer realmente internalizar o que aprendeu em sessões Claude, não apenas passar por cima. O mecanismo de checklist com confirmação item-por-item e recusa de finalização prematura é particularmente útil.

README

A tradução para o português deste README ainda está na fila.

teach

A Socratic teaching loop for any Claude Code session — quiz yourself on what actually happened, confirm mastery item by item, and don't finish until everything's locked in.


What It Does

/teach turns a session, file, or topic into an interactive mastery quiz. It sources the material (by searching your ~/.claude/projects/ session logs, or from a file you point it at), writes a concrete checklist of the concepts that actually came up, then drills you one question at a time — always pushing on why a decision was made, not just what happened. It marks each item confirmed in a checklist file as you go and refuses to wrap up until everything is locked in.

Key behaviors:

  • Source resolution — grep your session transcripts by topic and rank by recency, or read a file (.jsonl transcript or .md notes) directly.
  • Concrete checklist — extracts specific items (the problem, the solution, the broader context) into a dated checklist file, not generic placeholders.
  • Incremental mastery — one question at a time, marks [x] immediately on each confirmed item, re-asks in a different form when you miss.
  • Solo or teaching mode — quiz yourself (default), or --student <name> to structure a walk-through for teaching someone else.
  • Completion gate — never offers to wrap up until the checklist is 100% complete.

Usage

/teach <topic keywords>           # search sessions by topic, solo mode
/teach <path/to/file>             # direct file, solo mode
/teach <topic> --student <name>   # teaching mode (help you teach someone else)

No argument: lists your 10 most recent sessions and asks which one to teach.


Installation

Install with Vercel's Skills CLI (recommended):

npx skills add OctavianTocan/teach

Or copy the directory into your skills folder:

# Personal (default)
cp -r teach ~/.claude/skills/

# Global (available to all agents)
cp -r teach ~/.agents/skills/

Claude discovers skills in these locations automatically; the description field in SKILL.md controls when /teach triggers.


Credit

The underlying prompt is the "Learn Quiz" by Suzanne (Anthropic), shared by @trq212, and wrapped into a skill (session sourcing, checklist tracking, incremental mastery confirmation) by alexknowshtml/claude-skills. This repo packages that skill as a standalone, npx skills-installable unit and adds a name field plus trigger keywords for discovery.


License

MIT — see LICENSE. Credit to the original authors above.

Ver o original no GitHub

Bom para

Relacionados