narrative-sensemaking
Skill8 starsChanged 58 days agoMITView on GitHub
Some questions are "what happened and what did it mean", not "what is the mechanism". Use when an account must be reconstructed rather than measured, when a sequential process has a missing or out-of-order step, when a story is told to explain a failure, or when a claim sounds authoritative but may be structurally impossible before any source is even checked.
In this repository16 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- boundary-designSkill
- causal-auditSkill
- decision-bias-checkSkill
- estimationSkill
- evidence-synthesisSkill
- experience-and-transmissionSkill
- failure-forensicsSkill
- formal-correctnessSkill
- measurement-disciplineSkill
- normative-designSkill
- problem-reframingSkill
- representation-and-possibilitySkill
- structure-discoverySkill
- systems-leverageSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 42
If no shape above matches, do not force a genius — use a built-in agent with the closest GENIUS: pattern (rules/agent-routes.json, INDEX.md …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Narrative Sensemaking
Problem shape: the material is an account — an incident write-up, a user journey, a roadmap story, a vendor claim, a postmortem — and the work is to recover its structure: which functions occur in which order, which roles are filled, where the sequence breaks its own grammar, and whether the account is even structurally possible. Paradigmatic/causal analysis is the wrong mode here and produces confident nonsense when forced.
Relevant geniuses
| Agent | Use when |
| bruner | the question is "what happened and what did it mean?" — decide narrative vs paradigmatic mode explicitly, then analyze the breach of the canonical script that made the event tellable |
| propp | a sequential process (workflow, pipeline, user journey, incident response) needs its invariant functions extracted, its roles abstracted from their current occupants, and its gaps found by grammar rather than by inspection |
| ibnkhaldun | a claim sounds authoritative but may be structurally impossible — filter on structural plausibility before evaluating the source; check whether the reported thing could occur at that scale at all |
Invocation
- Pick the best-fit agent above. If two or more fit, run
tools/genius-invoker.sh route "<problem>"and take the top ranked match. - Load it:
tools/genius-invoker.sh invoke <agent> "<problem>", then readagents/genius/<agent>.mdin full. - Apply the agent's
<workflow>step by step and answer in its<output-format>. State which mode the account is being read in — narrative or paradigmatic — before drawing any conclusion from it. - Typical chain: ibnkhaldun filters out the structurally impossible → propp
extracts the function sequence from what survives → bruner reads what the
breach meant to the people in it. Run via
tools/genius-invoker.sh compose ibnkhaldun propp bruner -- "<problem>". - If no shape above matches, do not force a genius — use a built-in agent with the closest
GENIUS:pattern (rules/agent-routes.json, INDEX.md routing rule).
Refuse when
- A mechanism is available and measurable — a causal question is being smuggled
in as a story. Route to
causal-auditorfailure-forensics. - The narrative is the deliverable's purpose rather than its object: this shape analyzes accounts, it does not write persuasive ones.
- Structural analysis is being used to dismiss a first-hand report that has not been checked against any record — implausible is not the same as false.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

