explain-concept

Installation
SKILL.md

Explain a concept

Help the learner use one concept to reason about a new situation, at the depth and length they requested.

Choose the learning target

Establish the learner's starting knowledge and the question or decision the concept should help them answer. Infer these from the conversation when possible. Ask only when the missing context changes the explanation; do not turn a narrow question into a course-planning interview.

Select the smallest prerequisite set. Define unfamiliar terms at first use and connect the explanation to a concrete task the learner recognizes. If a question contains a misconception, correct it directly and explain the consequence for that task.

Explain and demonstrate

Start with a precise plain-language model of the mechanism. Use an analogy only if it makes a difficult relationship easier to understand; map it to the real mechanism and state where it stops working.

Work through one representative example with visible intermediate reasoning. Use consistent units, coordinate-frame names, conventions, and assumptions. Check arithmetic or small code examples with available tools when that materially improves confidence. Label hypothetical values; a teaching example is not a benchmark or device specification.

Show a boundary case or counterexample that exposes the most consequential misconception. Distinguish general principles from implementation-dependent behavior. For device limits, pinouts, API behavior, or version-specific claims, consult authoritative sources for that implementation or explicitly leave the claim unresolved.

For example, a lesson about coordinate transforms should make frame direction and units explicit; a lesson about quantization should distinguish representation, task quality, and runtime support. Include only distinctions relevant to the learner's question.

Installs
2
First Seen
Today