skills/map-analogy-to-concept/SKILL.md
--- name: map-analogy-to-concept description: Produces an explicit component-by-component mapping from the analogy's source domain to the target technical concept. Rejects vague analogies by forcing each source element to map to a specific target element, and flags unmapped elements as voice-breaking ("it's like a brain" is rejected because "brain" is unmapped). Use after generate-analogy-set, for each of the 5 framings. Trigger keywords: map, component mapping, source target, explicit mapping,
npx skillsauth add lyndonkl/claude skills/map-analogy-to-conceptInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Related skills: Called by the Intuition Builder per framing, after generate-analogy-set and before stress-test-analogy. Gentner's structure-mapping theory is the theoretical spine: good analogies map relations, not just objects.
For one framing (source → target):
- [ ] Step 1: Enumerate the source domain's key components (entities + relations)
- [ ] Step 2: For each source component, propose the target component it maps to
- [ ] Step 3: Check systematicity — do the relations carry across, or only objects?
- [ ] Step 4: Flag any source component that maps to nothing concrete (vague mapping = reject)
- [ ] Step 5: Return the mapping table
A strong analogy preserves the pattern of relations, not just object-level similarity. Example:
If the framing only matches on objects (nouns), reject or downgrade.
Every source component must map somewhere. "It's like a brain" fails because "brain" is unmapped to anything specific in the target (neuron? cortex? entire NS?). Flag and reject.
source_domain: "library card catalog"
target_concept: "KV cache"
mapping:
- source: "library"
target: "the KV cache data structure"
relation: "contains"
- source: "drawer"
target: "cache slot"
relation: "capacity-bounded container"
- source: "card"
target: "(key, value) projection pair"
relation: "indexed entry"
- source: "lookup by drawer then card"
target: "retrieval by position in key tensor"
relation: "indexed retrieval"
- source: "eviction when drawers fill"
target: "LRU / FIFO eviction under context-length pressure"
relation: "replacement under capacity constraint"
systematicity_score: 4/5 # how well relations carry over
unmapped_source: none
unmapped_target: "the attention operation that reads this cache" # flagged — see stress-test
Framing: "Dropout is antibody diversity for weights."
Source components:
Target components:
Mapping: | Source | Target | Relation | |---|---|---| | immune system | the trained neural network | generates patterns from a small genome/parameter set | | antibody population | ensemble of thinned sub-networks | many variants tested in parallel | | pathogen recognition | generalization on test data | performance on unseen inputs | | V/D/J combinatorial generation | random dropout masks produce sub-network diversity | small seed → many variants |
Systematicity: 4/5 — the relation "small number of building blocks → large functional diversity" carries across. The one break: actual biological V/D/J has selection (negative selection in thymus), which dropout doesn't do. Flag.
generate-analogy-set. This skill only maps.testing
--- name: advisory-edit description: A strict advisory-only editing discipline for a writer who dictates ("speaks out") essays and wants help WITHOUT having their voice changed. The editor directs structure, flags grammar, and suggests strategic language — but never modifies the writer's text unless the writer explicitly says "apply" / "make that change" / "rewrite this." Produces a line-referenced, suggestion-only critique where every item is marked the writer's call. Four passes: structural, l
testing
Provides the house style for analyst-grade strategist writing — third-person register with sparing first-person, no em dashes, no "not X, not Y, not Z" negation cascades, numbered footnote citations rather than inline source parentheticals, specific opinion-signaling phrases, and topic-forward paragraph structure modeled on voice patterns observed in Damodaran's Musings on Markets and Thompson's Stratechery. Use when consolidating working notes into a finished long-form strategist or analyst report that must read as written by a senior human analyst rather than an AI assistant.
testing
Renders a markdown report to a PDF using pandoc with xelatex (11pt serif body, 1-inch margins, numbered footnotes, formal heading hierarchy). Requires a one-time install of pandoc and a LaTeX engine on the user's machine — basictex on macOS or texlive-xetex on Linux. Does not attempt automatic install. Fails loudly with the exact install commands if pandoc or xelatex is missing on the user's PATH. Use when producing a finished strategist or analyst report PDF from a polished markdown source.
testing
Produces step-by-step computational walkthroughs of vector and matrix operations as a sequence of numbered "frames", showing the explicit state at each step. The text-equivalent of a 3Blue1Brown animation — each frame shows what changed and why, so the learner can re-trace the operation by hand. Use when the learner needs to *see* a computation unfold (eigenvalue computation, attention with 3 tokens, gradient descent step, SVD on a 2×2, layer norm on a 3-vector, softmax of a small input), when an explanation has been given but the learner needs to ground it in a worked example, or when introducing an operation that's intimidating in symbol form but trivial in pencil-and-paper form.