Install
openclaw skills install @deciqai/user-insight-engineActivate when: user says 'why aren't users doing X despite saying they would', or 'our survey scores are high but churn is high', or 'we shipped a feature that tested well but nobody uses it', or 'we have conflicting signals from research', or 'I can see the drop-off point but don't know why'. Do NOT activate when: the product has no real users yet (use lean-startup / jobs-to-be-done instead); or the purchase is a multi-stakeholder B2B enterprise deal (use principal-agent / signaling-games instead).
openclaw skills install @deciqai/user-insight-engineUser research produces data. The Engine produces insight — the causal link between an observable behavior and the deep-layer driver that causes it. Three layers: Surface (what users say), Behavioral (what users do), Deep (why — cognitive and social drivers). Four Deep Layer drivers: Loss Aversion, Social Proof, Cognitive Load, Trust Cost.
Cross-skill: use after jobs-to-be-done to map interview output onto drivers; before feedback-loops to avoid optimizing for the wrong behavior; alongside confirmation-bias as a meta-check; alongside loss-aversion-prospect-theory when Loss Aversion is primary.
Trigger: Surveys show satisfaction but behavioral data shows churn; a change that tested well failed in production; "why aren't users doing X?" where X is available and users expressed willingness; identical segments behaving differently; consistent drop-off that UX friction can't explain; low onboarding completion despite users rating it "easy"; feature adoption plateaued despite awareness.
When NOT to use: Zero behavioral data (don't attempt Deep Layer analysis); pre-launch no users (use lean-startup + jobs-to-be-done); B2B enterprise >12-month cycles (use principal-agent + signaling-games).
In Coach mode, respond one step at a time. Each [WAIT] is a hard stop — output only that step's question, then stop.
[WAIT — do not advance until user responds]
[WAIT — do not advance until user responds]
[WAIT — do not advance until user responds]
Step 1 — Behavior Gap: "[User segment] is [doing/not doing] [specific action] at [workflow point], despite [Surface Layer evidence they intend to / are capable of doing it]."
Step 2 — Three-Layer Synthesis: Collect Surface (surveys, interviews, tickets), Behavioral (clickstream, funnels, session recordings, cohort retention), Deep (ethnographic observation, JTBD interviews, diary studies, driver-isolating A/B). Stop-rule: no Deep Layer evidence = analysis incomplete; do not proceed to interventions.
Step 3 — Map to Driver: High trial-to-abandonment → Trust Cost / Cognitive Load. Low feature adoption despite awareness → Cognitive Load / Social Proof. Sudden drop-off after initial engagement → Social Proof / Trust Cost. Feature used in unintended order → Cognitive Load.
Step 4 — Intervention: Loss Aversion → reframe as prevention. Social Proof → surface specific peer group norm. Cognitive Load → reduce simultaneous decisions. Trust Cost → make first action reversible. Prioritize by: driver magnitude, testability, implementation cost.
USER INSIGHT ENGINE — REPORT CARD
Product / Feature: ___ Date: ___ Owner: ___
BEHAVIOR GAP: [segment] is [doing/not doing] [action] at [point], despite [Surface evidence].
SURFACE LAYER: ___ BEHAVIORAL LAYER: ___
Surface-Behavioral conflict: [ Yes / No ] If yes: ___
DEEP LAYER: Method: [ Ethnographic / JTBD / Diary / A/B ] Finding: ___
STOP-RULE: [ ] At least one Deep Layer piece collected — if unchecked, stop.
PRIMARY DRIVER: [ Loss Aversion / Social Proof / Cognitive Load / Trust Cost ]
Evidence: ___ Secondary driver: ___
INTERVENTION: Driver: ___ Change: ___ Test design: ___ Metric (behavioral): ___
→ Method in Action: Taylor's Behavioral Observation at Bethlehem Steel (1898–1901)
→ Primary sources: references/sources.md
[D] = designed upfront | [O] = observed in real use. [O] entries are more valuable.
| Fake move | Reality |
|---|---|
| [D] "80% said the feature is useful." | Stated utility is Surface Layer. 80% say useful + 20% use it = the conflict is the finding. |
| [D] "We watched 10 sessions — they completed without difficulty." | Lab sessions are Surface Layer in disguise. Real-environment observation is Deep Layer. |
| [D] "A/B test showed 5% lift in clicks." | Click lift is Behavioral Layer on one metric — doesn't confirm driver identification. |
| [D] "Users said onboarding is confusing — redesign it." | Cognitive Load, Trust Cost, and Social Proof all produce confusion; they require different fixes. |
| [D] "100,000 users — aggregate data is reliable." | Scale makes Behavioral statistically reliable; it says nothing about Deep Layer causes. |
| [D] "Power users love the feature." | Power users have resolved Trust Cost and formed habits — they're past the barriers you're trying to understand. |
| [D] "We've been doing user research for years." | Institutional knowledge accumulates Surface patterns; Deep Layer drivers shift as the user base scales. |
| [D] "Drop-off is at Step 3 — simplify Step 3." | Trust Cost established at Step 1 may only manifest as abandonment at Step 3. |
| → Add [O] entries here after each real use — paste the actual failure pattern | What went wrong and why |
Part of deciqAI Knowledge Skills — open-source thinking skills that make rigor executable for AI agents. Built by deciqAI · https://deciqai.com · Contributions welcome — see the template at the repo root.