Back to Skills

explainer

verified

USE WHEN: user asks "explain", "teach me", "how does X work", "help me understand", or wants to learn concepts from first principles with interactive comprehension checks. DO NOT USE WHEN: user wants quick answers, code implementation, or already understands the concept and just needs a reminder.

View on GitHub

Marketplace

claude-hacks

mahidalhan/claude-hacks

Plugin

explainer

Repository

mahidalhan/claude-hacks
20stars

skills/explainer/skills/explainer/SKILL.md

Last Verified

January 22, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/mahidalhan/claude-hacks/blob/main/skills/explainer/skills/explainer/SKILL.md -a claude-code --skill explainer

Installation paths:

Claude
.claude/skills/explainer/
Powered by add-skill CLI

Instructions

This skill guides recursive, ground-up explanations that avoid "assume they know" syndrome. Start from absolute basics, build layers incrementally, and verify understanding through targeted questions before advancing.

The user provides code or concepts to understand: a code block, a function, a pattern, or a technical concept. They may indicate their current level ("beginner", "self-taught", "learning on the go") or specific areas of confusion.

## Explainer Thinking

Before explaining anything, understand the learner's context and commit to a RECURSIVE-FIRST strategy:
- **Foundation**: What's the absolute most basic concept needed? What would a complete beginner need to know first?
- **Layer Depth**: How many conceptual layers exist? Each layer must build on the previous—never skip layers.
- **Gap Detection**: Where might assumptions break? What terms need recursive explanation? What prerequisites are hidden?
- **Verification**: What questions confirm understanding? What questions reveal gaps? When to pause and check?

**CRITICAL**: Explain recursively from the ground up, never assume prior knowledge. If you use a term without explaining it first, you've failed. If you advance without checking comprehension, you're lecturing, not teaching. Foundation → Layer 1 → Check → Layer 2 → Check → Continue. Always.

Then explain concepts that are:
- Incremental—each layer builds on the previous, no jumps
- Verified—questions check understanding before advancing
- Recursive—technical terms get their own ground-up explanation
- Visual—use ASCII diagrams, examples, analogies when helpful

## Explainer Excellence Guidelines

Focus on:
- **Foundation First**: Start with "What is X?" at the most basic level. If explaining HTTP requests, start with "What happens when you type a URL?" If explaining middleware, start with "What is a request?" Never assume they know what a server is, what a function is, or what data means.
- **Layer-by-Layer Progression**: Build one concept at a time

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
4198 chars