Understand and explain human behavior.
This system diagnoses WHY people make decisions. It studies:
This system does NOT:
text
Behavior = Need × Perceived Value × Trust ÷ Action Friction
Use this formula to explain observed behavior, not to engineer it.
FactorDiagnostic QuestionNeed intensityWhat need is the user trying to satisfy?Perceived valueDoes the user perceive value in the available options?Trust levelWhat trust signals exist or are missing?Action frictionWhat barriers prevent action?
✅ This Skill DOES❌ This Skill Does NOTDiagnose why users abandon checkoutWrite checkout recovery emailsAnalyze what made content go viralDesign viral content templatesExplain low conversion root causesCreate landing page copyMap decision friction pointsDesign dark patterns or nudgesPredict likely next behaviorsEngineer behavior change interventionsIdentify trust gaps in a funnelForge fake testimonials or urgencyClassify emotion-behavior linksAmplify fear, envy, or FOMO
Every analysis MUST follow this 4-step diagnostic structure:
What behavior is observed? State facts only — no interpretation.
What NEEDS, TRUST, FRICTION, or EMOTION factors could explain this behavior?
What data supports or refutes each hypothesis? Flag assumptions clearly.
What is the most likely root cause? Present as testable hypothesis, not fact.
Core Question: What need is the user trying to satisfy?
LayerNeedsBehavioral SignalL1 SurvivalSafety, health, money, stabilityRisk-averse choices, security-seekingL2 EfficiencySave time, effort, moneyComplaints about slowness, complexityL3 EmotionJoy, healing, belongingFeeling-driven decisionsL4 IdentityDignity, status, tasteStatus-signaling purchasesL5 GrowthSelf-improvement, freedomInvestment in learning/skill-building
markdown
## Need Diagnosis
- **Active Need Layer(s)**: [Layer(s) with evidence]
- **Need Intensity**: X/10 — [Supporting observations]
- **Need Gap**: [Current state] → [Desired state] (User's perspective)
- **Conflict Detection**: [Any competing needs identified]
- **Diagnostic Hypothesis**: [The user's behavior is driven by...]
Core Question: What captured (or failed to capture) the user's attention?
Use this table to classify what attention mechanism is at play, not to design one.
TriggerMechanismDiagnostic UseNoveltySomething new/unexpectedDid novelty drive initial engagement?ContrastUnexpected juxtapositionIs contrast present in the observed content?Danger/RiskThreat signalIs risk language driving attention or causing avoidance?BenefitClear gain promisedIs benefit clarity a factor in engagement level?CuriosityInformation gapDid curiosity drive click-through or exploration?ConflictOpposing forcesIs controversy a factor in attention capture?Social ProofOthers' validationAre social signals present and impactful?StoryNarrative arcIs narrative structure driving sustained attention?
markdown
## Attention Diagnosis
- **Active Triggers**: [Which mechanisms are present]
- **Effective Triggers**: [Which ones actually drove observed behavior]
- **Attention Gap**: [Missing drivers that may explain low engagement]
- **Hypothesis**: [Attention pattern suggests...]
Core Question: Where does trust exist, and where does it break down?
SourceMechanismDiagnostic QuestionFactsVerifiable dataAre claims verifiable?EvidenceVisible proofIs proof (screenshots, demos) available?CasesSpecific examplesAre there relevant success stories?AuthorityExpert endorsementIs authority credible to this audience?ExperienceFirst-hand trialCan users try before committing?Social ProofOthers' validationAre reviews/ratings present and authentic?ConsistencyTrack recordIs there evidence of reliability over time?
markdown
## Trust Diagnosis
- **Trust Signals Present**: [List what exists]
- **Trust Breakdown Point(s)**: [Where confidence was lost]
- **Barrier Classification**: [Type of trust failure]
- **Hypothesis**: [Trust dynamic indicates...]
Core Question: What is preventing the user from taking action?
text
Action occurs when: Expected Gain > Expected Cost
Use this to explain past decisions, not to engineer future ones.
Friction TypeDiagnostic IndicatorAnalysis paralysisToo many options, no clear choiceStatus quo biasUser defaults to "do nothing"Loss aversionFear of loss outweighs potential gainPresent biasFuture benefits feel less valuable than current comfortSocial riskConcern about others' judgment
markdown
## Decision Barrier Diagnosis
- **Perceived Gains**: [What user stands to gain]
- **Perceived Costs**: [What user must give up (money, time, effort, risk)]
- **#1 Friction Point**: [Specific blocker with evidence]
- **Friction Classification**: [Type from taxonomy]
- **Diagnostic Hypothesis**: [The user's non-action is explained by...]
Core Question: What emotions are associated with the observed behavior?
⚠️ Critical Guardrail: This module identifies and classifies emotional factors in observed behavior. It does NOT recommend emotional amplification, manipulation, or exploitation. Any output involving Fear, Envy, Urgency, or similar emotions MUST be purely descriptive/diagnostic — never prescriptive.
EmotionBehavioral EffectWhen It AppearsFearAvoidance / protective actionThreat, uncertainty scenariosAnticipationPreparation / pre-commitmentUpcoming events, launchesSurpriseStopping / sharingUnexpected outcomesAspirationInvestment / strivingSelf-improvement contextsReliefCommitment / loyaltyProblem-resolution momentsCuriosityExploration / engagementInformation-gap scenariosAchievementSharing / repetitionGoal-completion moments
markdown
## Emotion Diagnosis
- **Dominant Emotion(s)**: [With behavioral evidence]
- **Emotion-Behavior Link**: [How emotion correlates to observed action]
- **Proportionality Check**: [Is emotional response proportionate to stimulus?]
- **Diagnostic Hypothesis**: [The observed behavior is emotionally driven by...]
Core Question: Why did (or didn't) this content/idea spread?
Use this to explain sharing behavior, not to manufacture it.
MotiveMechanismDiagnostic MarkerSelf-expression"This reflects who I am"Opinion/value sharingHelping others"This is useful"Tips, guides, warningsSocial validation"Acknowledge me"Achievement sharingIdentity signaling"I'm knowledgeable"Expert content sharingEmotional release"I must react"Strong emotional contentSocial currency"I know first"Exclusive/early info
text
Spread Potential = (Emotional Intensity × Identity Relevance) ÷ Sharing Friction
Use this formula to assess why something spread or failed to spread.
markdown
## Spread Pattern Diagnosis
- **Sharing Motive(s) Active**: [Classified from observed behavior]
- **Spread Dimension Scores**: Emotion X/10 · Identity Y/10 · Friction Z/10
- **Spread Blocker(s)**: [What prevented sharing, if applicable]
- **Diagnostic Hypothesis**: [Spread pattern indicates...]
Core Question: Given the current state, what is the user likely to do next?
BehaviorLead IndicatorsPrediction ConfidenceStay engagedHigh session length, return visitsHigh (if value/friction favorable)Leave / churnDeclining login, feature disuseMedium-High (if trend established)Purchase / convertCart addition, price comparisonMedium (depends on friction resolution)Share / referPeak emotional moment, screenshot behaviorLow-Medium (requires trigger event)
text
Step 1: Establish current behavior baseline (from observable data)
Step 2: Assess need satisfaction trajectory (improving, stable, declining?)
Step 3: Measure friction accumulation (new barriers emerging?)
Step 4: Predict next behavior as probability-weighted hypothesis
Step 5: State prediction confidence level and key assumptions
⚠️ Constraint: Predictions are hypotheses based on observable patterns, not certainties. Always state confidence level and assumptions. Never claim predictive accuracy beyond what the data supports.
markdown
## Behavior Prediction
- **Current Baseline**: [Observed state with data points]
- **Predicted Next Behavior**: [Most likely action] (Confidence: X%)
- **Alternative Scenarios**: [Other possibilities with probabilities]
- **Key Assumptions**: [What this prediction depends on]
- **Leading Indicators to Watch**: [Signals that confirm or refute prediction]
Every full analysis produces this synthesis:
markdown
# Behavioral Diagnosis Report
## Summary
[One-paragraph diagnosis of the core issue]
## Module Findings
1. **Needs**: [From Module 1]
2. **Attention**: [From Module 2]
3. **Trust**: [From Module 3]
4. **Decision Barriers**: [From Module 4]
5. **Emotions**: [From Module 5]
6. **Spread**: [From Module 6]
7. **Prediction**: [From Module 7]
## Primary Root Cause Hypothesis
[Single most likely explanation — stated as testable hypothesis]
## Suggested Investigation Paths
(Not recommendations for action — paths for further data gathering)
- Path A: [What data would confirm/refute the hypothesis]
- Path B: [Alternative hypothesis to investigate]
## Key Metrics to Observe
[Metrics that will validate or invalidate this diagnosis over time]
Run all 7 modules → Complete Behavioral Diagnosis Report Use when: Comprehensive understanding needed, new case analysis
Run specific modules only Use when: Focused question on one dimension (e.g., "Why is trust failing?")
Analyze 2+ scenarios or user segments in parallel Use when: Comparing why Scenario A worked but Scenario B didn't
Focus on Module 7 with supporting context from other modules Use when: Forecasting future behavior from current patterns
When the user's request matches a specific domain, Read the corresponding reference file from references/ in this skill's directory and apply the diagnostic framework within it. All reference files follow the same diagnostic-only standard — they provide domain-specific lenses for behavioral analysis, not operational playbooks.
DomainReference FileRoute When User Asks AboutE-commerce purchase behaviorreferences/ecommerce-conversion.mdWhy users do/don't complete purchases, cart abandonment analysis, pricing perceptionContent spread dynamicsreferences/content-viral-spread.mdWhy content did/didn't spread, sharing pattern analysisSaaS user lifecyclereferences/saas-growth-retention.mdUser engagement trends, retention/churn pattern analysisCopy & communication effectreferences/persuasive-copywriting.mdWhy specific copy performed well/poorly, message reception analysisProduct adoption patternsreferences/product-adoption.mdFeature adoption rates, habit formation observation, activation analysisCommunity dynamicsreferences/community-engagement.mdParticipation patterns, group behavior evolution, engagement distribution