convez.ai
MCP ServerProdutividadeIntermediário
dreamdavidmit-glitch

rviewer — Motor de Quiz Diagnóstico com IA

dreamdavidmit-glitch/rviewer

Converta material de estudo em quiz inteligente com diagnóstico 4D

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP Server que transforma qualquer material de estudo (textbooks, notas, PDFs) em quiz interativo diagnóstico com análise multidimensional de pontos fracos. Integra-se ao Claude Code como skill para gerar questões personalizadas em tempo real, medir desempenho com timing por pergunta e gerar relatórios de domínio visual com recomendações de estudo focadas.

Instalação

$npx convez-ai dreamdavidmit-glitch/rviewer

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
2
Forks
1
Acompanhando
1
Saúde
42%
Último commit
há 5 meses
Versão
v1.0.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Professores gerando avaliações personalizadas por turma/disciplina
  • Estudantes diagnosticando lacunas de conhecimento com análise multidimensional
  • Tutores monitorando progresso com histórico persistente de sessões

Veredito

Ferramenta inovadora que resolve um problema real: quizzes genéricos não adaptados ao material específico. A análise 4D (acurácia + velocidade + streaks + subtópicos) é sofisticada, mas a integração Claude Code + interface web bem pensada torna prático. Ideal para educadores e aprendizes sérios; implementação sólida em Python com histórico persistente.

README

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

rviewer — AI Learning Diagnosis Claude Skill

rviewer is an open-source Claude Code skill that turns ANY study material into an interactive diagnostic quiz with real-time timing, multi-dimensional weak-point analysis, and a visual mastery report — all in your browser.


Why rviewer?

Most AI quiz tools give you generic questions. rviewer reads YOUR material — your textbook chapter, your class notes, your PDF — and generates questions tailored to exactly what you're studying. Then it tracks how fast you answer, spots patterns in your mistakes, and tells you what to review.

Traditional Quiz Appsrviewer
Question sourcePre-built generic bankGenerated from YOUR material
Timing analysisNonePer-question real-time tracking
Weak point detectionCorrect/wrong only4D: accuracy + speed + streaks + subtopics
DeliveryApp downloadBrowser + Claude Code skill
SubjectsFixedAnything you teach it

Quick Demo

You: "/rviewer — quiz me on Math 10 Unit 5"
Claude: reads your Obsidian notes → generates 20 Quadratic Functions questions
You: open http://127.0.0.1:5050 → take the quiz → instant mastery report

Features

Claude Code Skill

  • /rviewer command — invoke from any Claude Code session
  • Reads material from PDF, screenshots, Obsidian vault, or pasted text
  • Claude generates fresh questions every time — no stale question banks
  • Server-side answer key — student never sees correct answers

Interactive Web Quiz

  • Real-time per-question timer: green → yellow → red as time runs out
  • Keyboard shortcuts (A/B/C/D for multiple choice, Enter for fill-in)
  • Hint system with time penalty (+30s)
  • Skip option — marked wrong but records 0s time
  • Progress bar + immediate correct/wrong feedback

4-Dimensional Analysis Per Topic

DimensionWhat It MeasuresWeight
AccuracyCorrect / Total40%
SpeedActual time vs Expected time ratio30%
StreaksLongest consecutive correct answers30%
SubtopicsPinpoint exactly which concepts are weak—

Mastery Levels

  • Mastered (85+) → Move on to harder material
  • Proficient (65-84) → Minor gaps, targeted practice
  • Developing (40-64) → Needs focused review
  • Needs Review (<40) → Urgent: revisit fundamentals

HTML Diagnostic Report

  • Topic cards with color-coded mastery badges
  • Progress bars for each topic
  • Complete answer timeline (what you answered vs correct answer vs time taken)
  • Personalized study recommendations
  • One-click open in browser

Persistent History

  • SQLite database stores every session
  • Track improvement over days/weeks
  • python app.py stats — see your average accuracy and total study time

Install

Option 1: Claude Code Skill (Recommended)

# Clone into your Claude Code skills directory
git clone https://github.com/dreamdavidmit-glitch/rviewer.git ~/.claude/skills/rviewer

Then restart Claude Code — /rviewer will be available.

Option 2: Standalone Web App

git clone https://github.com/dreamdavidmit-glitch/rviewer.git
cd rviewer
pip install flask
python web_app.py
# Open http://127.0.0.1:5050

Option 3: CLI Only (No Browser)

python app.py quiz      # Terminal-based quiz
python app.py history   # View past sessions
python app.py report    # Reopen previous reports
python app.py stats     # Your statistics

Tech Stack

LayerChoice
AI / SkillClaude Code (Anthropic)
BackendPython 3.6+ · Flask
FrontendVanilla HTML/CSS/JS — zero npm dependencies
DatabaseSQLite + WAL mode
ReportsStatic HTML with CSS (no JS framework)

Zero frontend build step. Zero npm install. Just Python + a browser.


Project Structure

rviewer/
├── SKILL.md                # Claude Code skill definition
├── web_app.py              # Flask server (quiz API + report serving)
├── quiz_engine.py          # Quiz logic, real-time timing, session mgmt
├── analyzer.py             # 4D weak-point analysis engine
├── report_generator.py     # HTML visualization report generator
├── database.py             # SQLite persistence with WAL
├── models.py               # Python dataclasses + enums
├── question_bank.json      # Dynamic question bank (Claude writes here)
├── templates/
│   └── quiz.html           # Interactive quiz UI
├── app.py                  # CLI entry point (quiz/history/report/stats)
├── data/                   # SQLite DB (auto-created at runtime)
└── reports/                # Generated HTML diagnostic reports

How It Works (Architecture)

┌─────────────────────────────────────────────────────────┐
│  Claude Code (AI)                                       │
│  Reads your material → Generates questions → JSON       │
└──────────────────────┬──────────────────────────────────┘
                       │ writes to
                       ▼
┌─────────────────────────────────────────────────────────┐
│  question_bank.json                                     │
│  Dynamic — rebuilt every time you quiz a new topic      │
└──────────────────────┬──────────────────────────────────┘
                       │ loaded by
                       ▼
┌─────────────────────────────────────────────────────────┐
│  Flask Web Server (web_app.py)                          │
│  /api/start  → new session + questions                  │
│  /api/answer → check answer (server-side key)           │
│  /api/finish → analysis + report                        │
└──────────────────────┬──────────────────────────────────┘
                       │ serves
                       ▼
┌─────────────────────────────────────────────────────────┐
│  Browser Quiz UI (quiz.html)                            │
│  Real-time timer · Keyboard shortcuts · Live feedback   │
└─────────────────────────────────────────────────────────┘

Adding Your Own Subjects

Edit question_bank.json — or just tell Claude:

"Add a physics question bank for Newtonian Mechanics"

Claude writes the JSON for you. Example structure:

{
  "subjects": {
    "physics": {
      "Mechanics": [
        {
          "id": "physics-mech-001",
          "topic": "Mechanics",
          "subtopic": "Newton's Laws",
          "type": "multiple_choice",
          "question": "An object at rest stays at rest unless acted upon by...",
          "options": ["An unbalanced force", "Gravity only", "Friction only", "Its own weight"],
          "answer": "An unbalanced force",
          "expected_seconds": 30,
          "difficulty": "easy",
          "hint": "This is Newton's First Law — the law of inertia."
        }
      ]
    }
  }
}

Keywords

claude-skill claude-code claude-code-skill mcp mcp-server ai-agent ai-learning ai-education edtech anthropic claude diagnostic-quiz learning-analytics self-study quiz-generator weak-point-analysis study-tool ai-tutor open-source python flask


Star History

If this project helped you study, consider giving it a ⭐ — it helps other students find it too.


License

MIT — see LICENSE

Author

dreamdavidmit — student, builder, Claude Code enthusiast.

"Built this because I was tired of guessing what I didn't know."

Ver o original no GitHub

Bom para

Relacionados