pqbl

Design question-first learning modules with content embedded in feedback.

1|1|Updated Nov 4, 2025
One-click install
npx skills add https://github.com/dbosk/claude-skills --skill pqbl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pqbl
Source: https://github.com/dbosk/claude-skills/tree/main/pqbl
Command: npx skills add https://github.com/dbosk/claude-skills --skill pqbl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Traditional learning often involves passive consumption of content followed by questions, leading to lower engagement and retention. This skill helps you design "Pure Question-Based Learning" (pQBL) materials where questions come first, and all learning content is embedded directly within constructive feedback, maximizing active engagement and retention.

Core Features & Use Cases

  • Question-First Design: Guides the creation of learning modules that start with questions, eliminating prerequisite readings or lectures and promoting active discovery.
  • Content-Rich Feedback: Ensures all learning material is delivered through elaborated feedback, explaining why answers are correct/incorrect and providing comprehensive context.
  • Variation Theory Integration: Leverages Marton's Variation Theory (contrast, separation, generalization, fusion) to structure question sequences for optimal discernment of critical aspects.
  • Use Case: Instead of a lecture on Git commands, this skill would guide you to create a sequence of questions like "Which command stages changes?" with feedback that explains git add and its purpose, then "What happens if you stage a file and then modify it again?" with feedback explaining the need to re-stage.

Quick Start

I want to create a learning module using Pure Question-Based Learning. Guide me on how to design questions and feedback for a new topic.

Frequently Asked Questions about pqbl

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design learning materials where questions come before content?

Question-based learning starts with questions that learners answer first, then provides all explanatory content within feedback rather than in lectures. This approach embeds retrieval practice and active learning directly into the feedback, maximizing engagement and retention without prerequisite readings.

What's the difference between question-first learning and traditional quiz-based assessment?

Question-first learning makes questions the primary instructional vehicle—content lives only in elaborated feedback explaining correct and incorrect answers. Traditional quizzes test pre-taught content; pQBL uses questions as the discovery mechanism itself, applying variation theory to guide learners toward critical aspects.

How do I use variation theory to structure question sequences?

Variation theory uses contrast, separation, generalization, and fusion to help learners discern critical aspects of a concept. Structure questions so each variant reveals a new dimension—contrast similar cases, isolate key features, generalize patterns, then fuse them—embedding this progression into feedback explanations.

Can I use question-based learning for formative assessment?

Yes. Question-based learning is specifically designed for formative assessment, where questions and feedback drive learning rather than measure it. Each question-feedback cycle provides immediate insight into misconceptions and reinforces correct understanding through content-rich explanations.

What should I include in feedback to make question-based learning effective?

Feedback must explain why answers are correct or incorrect and provide comprehensive context about the underlying concept. Embed all learning material here—definitions, examples, reasoning, and connections—so questions serve as the entry point and feedback delivers the complete instructional content.

Do I need existing course materials to start using question-based learning?

No. Question-based learning eliminates prerequisite readings or lectures. Begin by defining the core concepts, design questions that prompt discovery of each concept, then write feedback that explains the complete reasoning—the questions and feedback together form your complete learning module.