From thinking-frameworks-skills
Presents a math or ML concept simultaneously in geometric and algebraic form with a one-sentence bridge explaining why they are the same thing. Use when a learner has one view but not the other.
How this skill is triggered — by the user, by Claude, or both
Slash command
/thinking-frameworks-skills:geometric-algebraic-bridgeThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
1. [Workflow](#workflow)
A geometric picture without the algebra leaves the learner unable to compute. An algebraic formula without the picture leaves them unable to see. This skill produces both, side by side, with one sentence between them that says — in plain English — why they are the same thing.
The bridge sentence is the load-bearing piece. Without it, you've handed the learner two unrelated halves and made them do the joining themselves.
Quick example (Dot product):
Geometric: Two arrows in the plane. The dot product a · b measures how much one points along the other — the projection of a onto b's direction, scaled by b's length.
Algebraic: a · b = a₁b₁ + a₂b₂ + … + aₙbₙ. (Or equivalently, a · b = |a| |b| cos θ.)
Bridge: The component-wise sum is the projection-times-length. You can prove it by writing a in coordinates aligned with b — the sum collapses to |a|cos θ × |b|, which is what projection-times-length says geometrically.
Three short blocks. The bridge is the last, and the only one that's not optional.
Copy this checklist and track your progress:
Bridge Progress:
- [ ] Step 1: Identify the concept and which view the learner has
- [ ] Step 2: Construct the missing view, kept short and concrete
- [ ] Step 3: Write the bridge sentence — one sentence, plain English
- [ ] Step 4: Verify the bridge with a small example
- [ ] Step 5: Invite the learner to confirm or push back
Step 1: Identify the concept and which view the learner has
Most users come with one view, not zero. Diagnose which:
concept-rediscovery-walk skill instead — they need to invent the concept first.A diagnostic question that almost always tells you which: "Can you predict what this concept does without computing? Or do you need to compute first?" Predict-without-compute = geometric; compute-first = algebraic.
Step 2: Construct the missing view, kept short and concrete
Build the missing view in 3-5 sentences. Length is a discipline: longer = more chance the learner loses the thread before the bridge.
For per-concept layout templates, see resources/templates.md. For full worked examples, see resources/examples.md.
Step 3: Write the bridge sentence — one sentence, plain English
The bridge is the highest-leverage sentence in the response. It must:
Three bridge formulas that work for most concepts:
The bridge fails when it just restates one view in symbols and the other in words without explaining the why. "Av = λv means v is left in place up to scaling" is not a bridge; it's a translation. The bridge is "and that's why it's the special direction the transformation can't rotate".
Step 4: Verify the bridge with a small example
After the bridge, run one small example end-to-end through both views:
The verification example should fit on one line if possible. Its purpose is to make the bridge concrete — not to teach a new concept.
Step 5: Invite the learner to confirm or push back
End with one of:
This catches the case where the bridge made sense to you but not to the learner. Bridges are subjective; the learner is the only judge.
The bridge is a single sentence (or two) that explicitly identifies the geometric and algebraic descriptions as the same thing, with a because. It is the part of the explanation most often skipped, and the part most often missed by learners who say "I sort of get it but it doesn't click."
For a library of bridge sentences per concept, see resources/templates.md.
**Geometric view.** [3-5 sentence picture, with one specific example.]
**Algebraic view.** [Formula, with 1-2 sentences saying what each term does.]
**Bridge.** [One sentence: X *is* Y because Z.]
**Verify on a tiny example.** [One-line check that both views give the same answer.]
Use when both views are roughly equal weight. This is the default.
**[The view the learner has].** You already have this — [restate in one sentence].
**[The missing view].** [3-5 sentences, ending in the formula or the picture.]
**Bridge.** [One sentence.]
**Verify.** [One line.]
Use when the learner has one view confidently and you don't want to belabor it.
| Geometric | Algebraic | Bridge |
|---|---|---|
| [Sentence] | [Formula] | [Why same] |
Use only for compound concepts with multiple sub-bridges (e.g., SVD = rotate, scale, rotate; attention = ask, match, mix). The table prevents the bridge from getting lost in prose.
For full filled-in templates per concept, see resources/templates.md.
For one filled template per concept type, see resources/examples.md.
| Concept | Geometric noun | Algebraic form | Bridge sentence stub |
|---|---|---|---|
| Eigenvector | Direction A doesn't rotate | Av = λv | "...because λv is just a rescaling, no rotation." |
| Dot product | Projection × length | a₁b₁ + … + aₙbₙ | "...because aligning coordinates with b collapses the sum to |a|cos θ × |b|." |
| Determinant | Signed volume scale factor | det(A) formula | "...because the formula counts volume cell-by-cell with sign." |
| Covariance matrix | Shape of data cloud (ellipsoid) | Σᵢⱼ = E[(xᵢ−μᵢ)(xⱼ−μⱼ)] | "...because it stretches the unit ball into the cloud's shape." |
| Softmax | Point on the simplex | exp(xᵢ)/Σexp(xⱼ) | "...because exp ensures positivity, normalize ensures sum-to-1." |
| Jacobian | Local linear map at a point | matrix of ∂fᵢ/∂xⱼ | "...because it's the linear approximation of f near a point." |
| SVD | Rotate, scale, rotate | A = UΣVᵀ | "...because U is a rotation, Σ scales axis-aligned, Vᵀ is a rotation." |
| Outer product | Rank-1 matrix; rows are scaled v | uvᵀ | "...because each row is uᵢ times the row vector v." |
For full worked examples per concept, see resources/examples.md. For per-concept templates with all four blocks filled in, see resources/templates.md.
npx claudepluginhub lyndonkl/claude --plugin thinking-frameworks-skillsProduces step-by-step computational walkthroughs of vector and matrix operations as numbered frames, showing explicit state at each step. Use when a learner needs to see a computation unfold.
Verifies genuine comprehension by explaining concepts in plain language, identifying gaps, and refining understanding until explanations are clear and jargon-free.
Performs symbolic mathematics in Python with SymPy: solve equations algebraically, compute derivatives/integrals/limits, manipulate expressions, work with symbolic matrices, and generate code from formulas. Use when exact symbolic results are needed.