Back to Skills

mindfulness

pjt222
Updated 2 days ago
8 views
17
2
17
View on GitHub
Metaaiapi

About

This skill provides techniques for maintaining defensive situational awareness and mental clarity in high-pressure or potentially unsafe environments. It includes frameworks like the Cooper color code and OODA loop for threat assessment, along with practical methods for de-escalation and stress management. Developers should use it when building tools that require safety analysis, environmental monitoring, or user guidance in uncertain contexts.

Quick Install

Claude Code

Recommended
Primary
npx skills add pjt222/agent-almanac -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternative
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/mindfulness

Copy and paste this command in Claude Code to install this skill

Documentation

Cultivate Defensive Mindfulness

Develop applied situational awareness, de-escalation skill, ability to maintain mental clarity under threat — practical complement to seated meditation operating in dynamic, real-world environments.

When Use

  • Entering unfamiliar or potentially hostile environments
  • Needing to assess social or physical situation for safety
  • De-escalating verbal confrontation before becomes physical
  • Maintaining calm focus during high-pressure or dangerous event
  • Grounding rapidly after shock, surprise, or adrenaline dump
  • Integrating awareness practice into daily movement (walking, commuting, traveling)
  • Preparing mental component before martial arts training (see tai-chi, aikido)

Inputs

  • Required: Willingness to practice sustained outward attention (opposite of internal meditation)
  • Required: Access to public or semi-public environments for practice (streets, transit, events)
  • Optional: Prior meditation experience (see meditate; helpful but not required)
  • Optional: Martial arts training background (see tai-chi, aikido; enhances physical response options)
  • Optional: Practice partner for de-escalation role-play scenarios

Steps

Step 1: Assess Situational Awareness (Cooper Color Codes)

Cooper color code system provides framework for calibrating awareness level to environment.

Cooper Color Code Awareness Levels:
┌──────────┬─────────────────────┬──────────────────────────────────────────┐
│ Code     │ State               │ Description and Application              │
├──────────┼─────────────────────┼──────────────────────────────────────────┤
│ White    │ Unaware             │ Absorbed in phone, headphones, day-      │
│          │                     │ dreaming. No awareness of surroundings.  │
│          │                     │ Acceptable only in secured private space │
├──────────┼─────────────────────┼──────────────────────────────────────────┤
│ Yellow   │ Relaxed alert       │ Aware of surroundings without fixation.  │
│          │                     │ Scanning people, exits, anomalies. This  │
│          │                     │ is the DEFAULT state in public spaces    │
├──────────┼─────────────────────┼──────────────────────────────────────────┤
│ Orange   │ Specific alert      │ Something has triggered attention: a     │
│          │                     │ person, behavior, or situation. Forming  │
│          │                     │ a plan: "If X happens, I will do Y"      │
├──────────┼─────────────────────┼──────────────────────────────────────────┤
│ Red      │ Action              │ The trigger condition from Orange has    │
│          │                     │ occurred. Execute the pre-formed plan.   │
│          │                     │ No hesitation — decision was made in     │
│          │                     │ Orange                                   │
├──────────┼─────────────────────┼──────────────────────────────────────────┤
│ Black    │ Overwhelmed         │ Panic, freeze, tunnel vision. Caused by │
│          │                     │ jumping from White directly to Red with  │
│          │                     │ no mental preparation. AVOID this state  │
└──────────┴─────────────────────┴──────────────────────────────────────────┘

Practice protocol:

  1. When leaving home, consciously shift from White to Yellow
  2. In Yellow, scan: Who is around? Where are exits? What is baseline behavior here?
  3. When something draws attention, shift to Orange: identify specific concern + form contingency
  4. If concern resolves, return to Yellow — do not stay in Orange unnecessarily (drains energy)
  5. Practice White-to-Yellow transition until automatic (2-4 weeks of daily practice)

Got: After consistent practice, Yellow becomes natural default in public spaces. Anomalies register immediately without conscious searching. Exits + positioning become habitual considerations.

If fail: Yellow feels exhausting or paranoid? Attention too focused. Yellow is relaxed + wide — like peripheral vision, not spotlight. If find self constantly in Orange, may be over-calibrating threat. Practice in safe, familiar environments first to establish baseline "Yellow" feeling sustainable + calm.

Step 2: Read Body Language + Intent

Most threats broadcast intention through body language before they act. Learn to read pre-attack indicators.

  1. Baseline observation: In any new environment, note what normal behavior looks like — pace, posture, eye contact patterns, group dynamics
  2. Deviation detection: Flag behaviors deviating from baseline:
    • Someone scanning crowd while standing still (target selection)
    • Clenched fists, squared shoulders, bladed stance (pre-fight posturing)
    • Avoiding eye contact while closing distance (predatory approach)
    • Exaggerated calm or unnatural stillness in dynamic environment
  3. Eye patterns: Direct, locked eye contact from stranger can indicate challenge or predatory focus. Repeated glancing at you, then away, may indicate surveillance or target assessment
  4. Proxemics (distance): People closing distance without social reason (not in queue, not passing through) warrant attention. Trust instinct saying "that person too close"
  5. Group dynamics: Watch for one person holding attention (distraction) while another maneuvers (setup). Pre-arranged signals between members of group (nods, gestures)
  6. Gut response: Limbic system processes threat faster than conscious mind. If something feels wrong, honor signal + increase awareness before rationalizing away

Got: Ability to notice pre-attack indicators in real time + shift from Yellow to Orange with specific concern identified. General sense of when someone's behavior does not match social context.

If fail: Body language reading feels like guesswork? Practice in safe environments first: observe interactions at cafe, on transit, in park. Note postures, distances, energy levels without any threat component. Reading people is skill built through volume of observation. If become hypervigilant (seeing threats everywhere), ground self with Step 6 techniques + recalibrate with reminder that most people not threats.

Step 3: De-escalate Verbal Confrontation

When situation escalates verbally, de-escalation is highest-value skill. Most violence can be prevented with words + positioning.

De-escalation Framework:
┌──────────────────┬──────────────────────────────────────────────────────┐
│ Phase            │ Technique                                            │
├──────────────────┼──────────────────────────────────────────────────────┤
│ 1. Space         │ Maintain 2+ arm-lengths distance. Angle your body   │
│                  │ 45 degrees (non-confrontational, protects center     │
│                  │ line). Position an exit route behind you, never      │
│                  │ behind the aggressor                                 │
├──────────────────┼──────────────────────────────────────────────────────┤
│ 2. Voice         │ Lower your volume below theirs — this forces them   │
│                  │ to quiet down to hear you. Speak slowly. Use a      │
│                  │ calm, even tone. Avoid commands ("calm down") —     │
│                  │ use observations ("I can see you're upset")         │
├──────────────────┼──────────────────────────────────────────────────────┤
│ 3. Acknowledge   │ Name their emotion without agreeing with their      │
│                  │ position: "That sounds really frustrating." Do NOT  │
│                  │ say "I understand" unless you genuinely do. Do NOT  │
│                  │ argue, correct, or explain — yet                    │
├──────────────────┼──────────────────────────────────────────────────────┤
│ 4. Offer exits   │ Give the person a way to disengage without losing  │
│                  │ face: "I think we both need a minute" or "Let me   │
│                  │ get someone who can help with this." Frame retreat  │
│                  │ as a mutual decision, not submission                │
├──────────────────┼──────────────────────────────────────────────────────┤
│ 5. Disengage     │ If de-escalation fails, create distance. Do not    │
│                  │ turn your back. Move toward other people, exits,   │
│                  │ or authority figures. Leave the area if possible    │
└──────────────────┴──────────────────────────────────────────────────────┘

Critical rules:

  • Never tell angry person to "calm down" — escalates
  • Hands visible + open (non-threatening) but positioned to protect (fence position)
  • Do not match their energy: if they escalate, you de-escalate harder
  • Ego-driven need to "win" argument is most common cause of avoidable violence

Got: Ability to lower emotional temperature of confrontation through voice, positioning, verbal technique. Most verbal confrontations de-escalate within 60-90 seconds of effective technique.

If fail: Person becomes physically threatening despite de-escalation? Priority shifts from de-escalation to escape or, if escape impossible, to physical defense (see aikido, tai-chi). Not every situation can be talked down. Recognize when de-escalation has failed + transition to action without hesitation.

Step 4: Practice Moving Mindfulness

Moving mindfulness applies meditation awareness to walking, commuting, navigating public spaces.

  1. When walking, practice panoramic awareness: soften eyes + take in full visual field rather than focusing on one point
  2. Feel ground contact with each step — anchors awareness in body while eyes scan environment
  3. Maintain awareness of space behind you: changes in sound (footsteps speeding up, conversation stopping) carry information
  4. At transitions (entering building, rounding corner, stepping off transit), briefly pause + scan new environment before committing
  5. In crowded spaces, track 2-3 people in peripheral awareness without fixating on any one
  6. Practice "mirroring walk": match pace + rhythm of environment to blend in; deliberately vary pace to test whether anyone matches changes
  7. Periodically check: "If something happened right now, where would I go?" — Yellow-state maintenance

Got: Walking becomes active awareness practice rather than passive transportation. Transitions (doorways, corners, platform edges) become natural scan points. Environmental baseline maintained without effort.

If fail: Moving mindfulness feels tiring or distracting? Likely gripping too tightly. Awareness should feel like listening to background music — present but not demanding. If cannot maintain while also thinking or conversing, practice in simple environments first (quiet neighborhood walk) before adding complexity (busy street, transit).

Step 5: Cultivate Combat Mindfulness (OODA Loop)

OODA loop (Observe-Orient-Decide-Act) is decision cycle for operating under pressure. Speed through loop determines who controls encounter.

OODA Loop Application:
┌──────────┬──────────────────────────────────────────────────────────────┐
│ Phase    │ Application                                                  │
├──────────┼──────────────────────────────────────────────────────────────┤
│ Observe  │ Take in the full situation: who, what, where, how many,     │
│          │ weapons, exits, bystanders. Use peripheral vision. Do not   │
│          │ fixate on the most obvious stimulus — scan the whole scene  │
├──────────┼──────────────────────────────────────────────────────────────┤
│ Orient   │ Match the observation to your training and experience:      │
│          │ "This is [type of situation]. I have [these options]."      │
│          │ Orientation is where pre-training pays off — trained        │
│          │ responses orient faster than improvised ones                │
├──────────┼──────────────────────────────────────────────────────────────┤
│ Decide   │ Select the best available option — not the perfect one.    │
│          │ A good decision now beats a perfect decision too late.      │
│          │ If Orange-state planning was done (Step 1), the decision   │
│          │ may already be made                                         │
├──────────┼──────────────────────────────────────────────────────────────┤
│ Act      │ Execute with full commitment. Hesitation between decision   │
│          │ and action is the most dangerous gap. Once you act, observe │
│          │ the result and re-enter the loop                            │
└──────────┴──────────────────────────────────────────────────────────────┘

Training OODA loop:

  1. In daily life, practice rapid scenario assessment: enter room + within 5 seconds identify exits, cover, most concerning person
  2. Play "what if" games: "If someone entered that door aggressively right now, what would I do?" Form plan (Orange), then release (return to Yellow)
  3. In martial arts practice, train pre-set responses to specific attacks — accelerates Orient phase
  4. Practice decision-making under artificial stress: timed drills, cold water exposure while problem-solving, physical exercise combined with cognitive tasks
  5. After any real or simulated event, debrief: "What did I observe? What did I miss? Where did I hesitate?"

Got: OODA loop becomes increasingly automatic. Observation broad + rapid. Orientation draws on trained patterns. Decisions made in Orange so Red-state action is immediate.

If fail: Freeze under simulated pressure (Black state)? Stimulus has bypassed OODA loop. Means gap between White + Red was too large. Return to Step 1 + reinforce Yellow-state maintenance so unexpected events meet already-alert mind. Freezing is normal survival response — can be retrained through gradual stress inoculation, not by forcing self into extreme scenarios.

Step 6: Deploy Rapid Grounding Techniques

When stress, shock, or adrenaline disrupts clarity, these techniques restore functional awareness within seconds.

Grounding Techniques Quick Reference:
┌──────────────────────┬─────────────────────────────────────────────────┐
│ Technique            │ Method and Use Case                             │
├──────────────────────┼─────────────────────────────────────────────────┤
│ Tactical breathing   │ Inhale 4 counts, hold 4, exhale 4, hold 4.    │
│ (box breathing)      │ Repeat 4 cycles. Activates parasympathetic     │
│                      │ response in ~60 seconds. Use: acute stress,    │
│                      │ pre-confrontation, post-adrenaline dump        │
├──────────────────────┼─────────────────────────────────────────────────┤
│ 5-4-3-2-1 sensory    │ Name 5 things you see, 4 you hear, 3 you can  │
│ anchor               │ touch, 2 you smell, 1 you taste. Forces the   │
│                      │ mind out of internal panic and into present-   │
│                      │ moment external reality. Use: dissociation,    │
│                      │ freeze response, post-traumatic intrusion      │
├──────────────────────┼─────────────────────────────────────────────────┤
│ Peripheral vision    │ Fix eyes on a point, then widen awareness to   │
│ activation           │ the edges of the visual field without moving   │
│                      │ the eyes. Activates parasympathetic nervous    │
│                      │ system and reduces tunnel vision. Use: hyper-  │
│                      │ focus, tunnel vision, adrenaline narrowing     │
├──────────────────────┼─────────────────────────────────────────────────┤
│ Physical anchor      │ Press feet firmly into the ground and feel the │
│                      │ contact. Squeeze and release fists 3 times.    │
│                      │ Roll shoulders back. These physical actions    │
│                      │ re-establish body awareness. Use: dissociation,│
│                      │ shaking, post-event processing                 │
├──────────────────────┼─────────────────────────────────────────────────┤
│ Verbal reset         │ State your name, location, and current task    │
│                      │ aloud: "I am [name], I am at [location], I am │
│                      │ doing [task]." Orienting to facts breaks the   │
│                      │ emotional loop. Use: confusion, panic, sensory │
│                      │ overload                                       │
└──────────────────────┴─────────────────────────────────────────────────┘
  1. Practice these techniques when NOT under stress so available when needed
  2. Tactical breathing is single most effective rapid intervention — practice daily
  3. After any adrenaline event (near-miss, confrontation, shock), run box breathing before making any decisions
  4. Combine techniques: physical anchor + tactical breathing effective for strong reactions

Got: Ability to downregulate from acute stress to functional clarity within 60-120 seconds. Techniques practiced enough to be recalled under pressure without conscious effort.

If fail: Technique does not bring relief within 2 minutes? Switch to different one — not all techniques work for all people or all situations. If grounding ineffective because stressor is ongoing (you still in danger), grounding is premature — address situation first using OODA (Step 5), then ground afterward. Persistent inability to downregulate after events may indicate need for professional support.

Step 7: Integrate Across Contexts

Apply defensive mindfulness consistently across different environments + situations.

  1. Urban: Higher baseline alertness (solid Yellow). Track blind spots (alleys, stairwells, parking structures). Maintain awareness at ATMs, transit platforms, when entering/exiting vehicles
  2. Wilderness: Different threat profile — terrain hazards, weather, wildlife, getting lost. Awareness shifts from people to environment. Navigation + shelter assessment replace social threat reading (see bushcraft skills)
  3. Social events: Identify exits on arrival. Monitor alcohol levels in others (impaired people unpredictable). Stay closer to exits than center of crowds
  4. Travel: Heightened awareness in unfamiliar environments. Know emergency number for country. Keep documents + valuables distributed, not in one bag. Note route to/from accommodation
  5. Digital: Awareness extends to information security — who is observing your device, what you share publicly, physical security of devices
  6. With others: Your awareness protects people with you. Position self between potential threats + those you with. Brief companions on basic awareness without causing anxiety

Got: Consistent, sustainable baseline awareness adapting to context without becoming paranoid or exhausting. Yellow state maintained across environments with appropriate Orange-state responses to genuine anomalies.

If fail: Awareness practice creates anxiety or hypervigilance? Calibration too high. Return to Step 1, practice Yellow in familiar, safe environments. Goal is relaxed alertness, not perpetual threat scanning. If awareness practice interferes with enjoyment of life, consult with mental health professional — particularly if there is trauma history making threat assessment unreliable.

Step 8: Review + Refine

Like any skill, defensive mindfulness improves through deliberate review + honest self-assessment.

  1. After any notable awareness event (successful detection, de-escalation, missed cue, freeze), journal details:
    • What happened?
    • What color code was I in when started?
    • What did I observe? What did I miss?
    • What worked? What would I do differently?
  2. Monthly review: scan journal entries for patterns — recurring blind spots, environments where awareness drops, emotional states interfering
  3. Seek training: de-escalation workshops, scenario-based self-defense courses, first aid certification
  4. Practice with partner: role-play confrontation scenarios, practice verbal de-escalation, critique each other's positioning
  5. Cross-train: martial arts (see aikido, tai-chi) build physical response options; meditation (see meditate) builds calm baseline that awareness operates from
  6. Maintain physical fitness: body's stress response performs better when cardiovascular system conditioned

Got: Measurable improvement over time: faster anomaly detection, calmer response to stressors, better positioning habits, more effective de-escalation.

If fail: Skills plateau? Introduce novel environments or training partners. Motivation wanes? Recall awareness is investment paying off in one moment it is needed. Self-assessment reveals persistent weaknesses (e.g., always freezing, never noticing approaches from behind)? Target those specifically rather than continuing general practice.

Checks

  • Cooper color codes can be identified + applied in real time
  • At least 3 pre-attack body language indicators can be named + recognized
  • De-escalation framework can be articulated + has been practiced (at minimum in role-play)
  • Moving mindfulness practiced during daily commute or walking for at least 1 week
  • Tactical breathing (box breathing) can be performed from memory + practiced daily
  • At least 2 rapid grounding techniques tested + one preferred method identified
  • OODA loop applied to at least 3 "what if" scenarios
  • Awareness journal has at least 3 entries documenting real observations

Pitfalls

  • Hypervigilance masquerading as awareness: True awareness relaxed + sustainable. If exhausted, anxious, or seeing threats everywhere, in chronic Orange — counterproductive + unsustainable. Yellow is goal, not Orange
  • Tunnel vision on obvious threat: Person yelling may be distraction. Train self to scan periphery when something grabs central attention. Multiple-threat awareness is purpose of randori training (see aikido)
  • Telling angry person to calm down: Single most common de-escalation error. Communicates their feelings invalid + you in control — both escalatory. Acknowledge their emotional state instead
  • Neglecting verbal before physical: Most violence preceded by verbal escalation. Effective de-escalation prevents vast majority of physical confrontations. Investing in verbal skills has higher return than physical technique alone
  • Skipping grounding after events: Adrenaline impairs judgment for 20-45 minutes after event. Making decisions (especially aggressive ones) during this window is unreliable. Ground first, decide second
  • Training in isolation: Awareness + de-escalation are social skills. Solo practice builds foundation, but partner drills + real-world practice essential for realistic competence

See Also

  • aikido — physical techniques for when de-escalation fails; blending + redirection principles mirror verbal de-escalation
  • tai-chi — develops rooted calm + body awareness supporting both physical readiness + emotional regulation
  • meditate — builds baseline mental stillness from which awareness operates; seated practice complements active, outward focus of defensive mindfulness
  • heal — first aid knowledge + stress management are direct applications of defensive mindfulness
  • remote-viewing — shares perceptual acuity training; non-local awareness exercises complement environmental scanning skills
  • awareness — AI self-application variant; maps Cooper color codes + OODA loop to internal threat detection for hallucination risk + context degradation

GitHub Repository

pjt222/agent-almanac
Path: i18n/caveman/skills/mindfulness
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Related Skills

content-collections

Meta

This skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.

View skill

polymarket

Meta

This skill enables developers to build applications with the Polymarket prediction markets platform, including API integration for trading and market data. It also provides real-time data streaming via WebSocket to monitor live trades and market activity. Use it for implementing trading strategies or creating tools that process live market updates.

View skill

creating-opencode-plugins

Meta

This skill helps developers create OpenCode plugins that hook into 25+ event types like commands, files, and LSP operations. It provides the plugin structure, event API specifications, and implementation patterns for JavaScript/TypeScript modules. Use it when you need to intercept, monitor, or extend the OpenCode AI assistant's lifecycle with custom event-driven logic.

View skill

sglang

Meta

SGLang is a high-performance LLM serving framework that specializes in fast, structured generation for JSON, regex, and agentic workflows using its RadixAttention prefix caching. It delivers significantly faster inference, especially for tasks with repeated prefixes, making it ideal for complex, structured outputs and multi-turn conversations. Choose SGLang over alternatives like vLLM when you need constrained decoding or are building applications with extensive prefix sharing.

View skill