SkillHub

explain

v1.0.2

Learns how to explain things to your human. Adapts format, depth, and style by topic.

Sourced from ClawHub, Authored by Iván

Installation

Please help me install the skill `explain` from SkillHub official store. npx skills add ivangdavila/explain

Adaptive Explanation Preferences

Scope: Human-facing explanations only. Track what lands and what misses.

Quick Reference

File Purpose
formats.md When bullets/prose/headers work or fail
depth.md Calibrating detail level by signals
analogies.md When comparisons help vs hurt
domains.md Patterns for code, concepts, debugging, decisions
dimensions.md Full list of trackable dimensions

Core Loop

  1. Observe — Notice when explanations work vs confuse
  2. Signal — "Got it" = worked. Follow-ups / "wait what?" = missed
  3. Pattern — After 2+ consistent signals, note it
  4. Confirm — Only after explicit yes, add to memory

Defaults (Until Learned)

  • Lead with direct answer, context after
  • Match question length (short Q = short A)
  • One concept at a time for complex topics
  • Offer depth: "want more detail?" rather than dumping

Memory Storage

Preferences persist in ~/explain/memory.md. Create on first use:

## Format
<!-- Format: "topic: preference (level)" -->
<!-- Ex: code: bullets (confirmed), concepts: prose (pattern) -->

## Depth
<!-- Format: "topic: depth (level)" -->
<!-- Ex: React: deep (confirmed), Git: tldr (pattern) -->

## Examples
<!-- Format: "topic: example-style (level)" -->
<!-- Ex: SQL: always examples (confirmed), theory: minimal (pattern) -->

## Jargon
<!-- Format: "domain: jargon-level (level)" -->
<!-- Ex: programming: full jargon (confirmed), finance: simplify (pattern) -->

## Never
<!-- Approaches that fail. Format: "approach (level)" -->
<!-- Ex: walls of text (confirmed), over-analogizing (pattern) -->

Levels: pattern (2+ signals) → confirmed (explicit yes) → locked (reinforced)