comprehend

Guide interactive learning through quizzes and checklists for codebases and pull requests.

3|2|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/broomva/skills --skill comprehend-broomva
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: comprehend
Source: https://github.com/broomva/skills/tree/main/skills/knowledge/comprehend
Command: npx skills add https://github.com/broomva/skills --skill comprehend-broomva

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the problem of superficial understanding by enforcing a rigorous, stage-gated pedagogical loop that ensures you truly grasp a body of work rather than just nodding along to a summary.

Core Features & Use Cases

  • Active-Recall Verification: Uses quizzes and restatement requirements to ensure mastery of concepts, code, or PRs.
  • Persisted Learning Artifacts: Creates and maintains a checklist document to track progress across sessions.
  • Adaptive Depth: Adjusts explanation complexity (ELI14, ELII, ELI5) based on your current understanding and quiz performance.
  • Use Case: Use this when onboarding onto a complex new codebase, reviewing a difficult PR, or conducting a post-mortem to ensure you understand the design decisions and edge cases.

Quick Start

Invoke the comprehend skill to walk through and master the logic of the current diff or a specific file.

Frequently Asked Questions about comprehend

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

FAQPage Schema
How does active-recall pedagogy help with onboarding onto a complex codebase?

Active-recall pedagogy enforces deep understanding of a complex codebase by requiring you to restate concepts and pass quizzes, verifying true mastery rather than passive reading before advancing through learning stages.

What is the best way to verify mastery of a difficult pull request?

The best way to verify mastery of a difficult pull request is using an iterative pedagogical loop with quiz-based gates, ensuring you comprehend design decisions and edge cases through active human participation before progressing.

Can I track my learning progress across multiple sessions when reviewing technical work?

You can track learning progress across multiple sessions by using persisted learning artifacts, which create and maintain a checklist document to monitor your mastery of technical work over time.

How do I adjust explanation complexity when I do not understand a technical concept?

Adaptive depth adjusts explanation complexity across stages like ELI5, ELI14, and ELII based on your current understanding and quiz performance, ensuring explanations match your comprehension level during knowledge transfer.

Does interactive knowledge transfer require human participation to validate comprehension?

Interactive knowledge transfer requires active human participation to validate comprehension, operating on codebases and subsystems to verify that you truly grasp the technical work before allowing advancement.

When should I avoid using a stage-gated pedagogical loop for teaching?

You should avoid a stage-gated pedagogical loop when superficial understanding suffices, as this approach requires rigorous interactive participation, restatement, and quiz completion to enforce deep mastery of technical work.