systems-thinking
Analyze complex systems through stocks, flows, and feedback loops to find high-leverage interventions. For organizational, environmental, social, and technical systems exhibiting circular causality. NOT for linear problems or simple cause-effect chains.
Best use case
systems-thinking is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Analyze complex systems through stocks, flows, and feedback loops to find high-leverage interventions. For organizational, environmental, social, and technical systems exhibiting circular causality. NOT for linear problems or simple cause-effect chains.
Teams using systems-thinking should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/systems-thinking/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How systems-thinking Compares
| Feature / Agent | systems-thinking | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Analyze complex systems through stocks, flows, and feedback loops to find high-leverage interventions. For organizational, environmental, social, and technical systems exhibiting circular causality. NOT for linear problems or simple cause-effect chains.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Systems Thinking
Diagnose why systems cause their own behavior and identify structural interventions that produce sustainable change.
## When to Use
✅ Use for:
- Persistent problems resistant to repeated solutions
- Unintended consequences from well-intentioned policies
- Exponential growth approaching limits
- Oscillating or eroding performance
- Collective outcomes nobody wants despite individual rationality
- Environmental/resource management
- Organizational dysfunction
- Policy design
- Technology system architecture
❌ NOT for:
- Simple linear causality problems
- One-time events without feedback
- Systems requiring immediate tactical response
- Purely technical optimization without human feedback
## Core Process
### Systems Analysis Decision Tree
```
START: Observe problematic behavior
│
├─→ Does behavior persist despite multiple interventions?
│ YES → Likely structural issue, continue
│ NO → May be simple cause-effect, consider other methods
│
├─→ Map the system structure:
│ 1. Plot behavior over time (time graphs, multiple variables)
│ 2. Identify stocks (accumulations)
│ 3. Identify flows (rates filling/draining stocks)
│ 4. Map feedback loops connecting stocks/flows
│ ├─ Balancing loops (goal-seeking, stabilizing)
│ └─ Reinforcing loops (amplifying, exponential)
│ 5. Identify delays between action and response
│
├─→ Recognize archetypal trap pattern:
│ ├─ Multiple actors pulling different directions? → Policy Resistance
│ ├─ Shared resource degrading? → Tragedy of Commons
│ ├─ Standards declining with performance? → Drift to Low Performance
│ ├─ Competitors raising stakes continuously? → Escalation
│ ├─ Intervention creating dependency? → Addiction/Shifting Burden
│ ├─ Rules evaded while appearing compliant? → Rule Beating
│ └─ Optimizing wrong measure? → Seeking Wrong Goal
│
├─→ Choose intervention level (ascending leverage):
│ ├─ LOW: Adjust parameters (numbers, rates, standards)
│ ├─ MID: Restructure information flows to decision-makers
│ ├─ MID: Change rules governing system
│ ├─ HIGH: Add/remove/strengthen feedback loops
│ ├─ HIGH: Enable self-organization capacity
│ ├─ HIGHEST: Shift system goals/purpose
│ └─ TRANSCENDENT: Change paradigm (worldview)
│
└─→ Design feedback-based policy (not static rule):
├─ Creates automatic adjustment based on system state
├─ Strengthens corrective feedback loops
└─ Monitors unintended consequences
```
### Stock-Flow Analysis Decision Tree
```
For any accumulation problem:
│
├─→ Identify the stock: What is accumulating/depleting?
│
├─→ Map all inflows: What fills the stock?
│
├─→ Map all outflows: What drains the stock?
│
├─→ Compare rates:
│ ├─ Inflows > Outflows → Stock rising
│ ├─ Inflows = Outflows → Dynamic equilibrium
│ └─ Inflows < Outflows → Stock falling
│
└─→ To change stock level:
├─ Option A: Increase inflows
├─ Option B: Decrease outflows
└─ Which has more leverage in THIS system?
```
### Trap Escape Decision Tree
```
When caught in system trap:
│
├─→ POLICY RESISTANCE (deadlock, fixes that fail)
│ ├─ Continue overpowering? → Escalating effort, no progress
│ └─ Let go + find shared overarching goal → Escape
│
├─→ TRAGEDY OF COMMONS (resource degradation)
│ ├─ Education alone? → Weak, rarely sufficient
│ ├─ Privatization? → Creates direct feedback
│ ├─ Regulation + enforcement? → Can work if monitored
│ └─ Create shared stewardship? → Strongest if achievable
│
├─→ DRIFT TO LOW PERFORMANCE (eroding standards)
│ ├─ Accept relative standards? → Reinforces decline
│ ├─ Hold absolute standards? → Stops erosion
│ └─ Benchmark to best performance? → Drives improvement
│
├─→ ESCALATION (arms race, price war)
│ ├─ Try to win? → Exponential growth to collapse
│ ├─ Unilateral disarmament? → Risky but can induce reciprocity
│ └─ Negotiated agreement? → Escape if enforceable
│
├─→ ADDICTION (dependency on intervention)
│ ├─ Continue intervention? → Deepening dependency
│ ├─ Strengthen original capacity first → Then withdraw
│ └─ Cold turkey + capacity building → Painful but necessary
│
├─→ RULE BEATING (letter vs. spirit)
│ ├─ Strengthen enforcement? → Intensifies trap
│ └─ Redesign rules with system understanding → Escape
│
└─→ WRONG GOAL (measuring wrong thing)
├─ Continue optimizing bad metric? → Perfect wrong outcome
└─ Redefine indicators reflecting real welfare → Escape
```
## Anti-Patterns
### Event-Level Thinking
**Novice approach:** Analyze discrete events, blame external actors, seek quick fixes for symptoms
**Expert approach:** Move from events → behavior patterns → underlying structure; map feedback loops generating the behavior
**Timeline to mastery:** 6-12 months of practice mapping stock-flow diagrams and recognizing structure generates behavior
**Key insight:** "The Slinky bounces because of its internal spring structure, not because your hand released it"
### Parameter Obsession
**Novice approach:** Spend 95% of effort adjusting numbers—taxes, budgets, standards, interest rates—while leaving structure unchanged
**Expert approach:** Focus on information flows, feedback loop strength, rules, self-organization, goals, and paradigms; recognize parameters as lowest leverage
**Timeline to mastery:** 1-2 years recognizing that "rearranging deck chairs on the Titanic" accomplishes nothing structural
**Key insight:** "Real leverage comes from who gets what information when, not from tweaking numbers"
### Blaming Individuals
**Novice approach:** Attribute system failures to character flaws; fire and replace people; assume new actors will behave differently
**Expert approach:** Recognize bounded rationality—locally rational decisions produce collectively irrational outcomes due to information structure, not character
**Timeline to mastery:** 3-6 months experiencing that replacement actors generate identical behaviors in unchanged structures
**Key insight:** "The invisible foot—individually sensible actions create systemic disasters when information is missing"
### Linear Causality Assumption
**Novice approach:** See only straight-line cause-effect (A causes B); expect proportional responses; surprised by sudden behavioral shifts
**Expert approach:** Recognize circular causality through feedback; understand nonlinearity means small changes flip system behavior; expect shifting loop dominance
**Timeline to mastery:** 6-18 months working with feedback models and observing exponential growth, collapse, and oscillation
**Key insight:** "Systems cause their own behavior through circular feedback—the answer lies within the system"
### Faster-Is-Better Fallacy
**Novice approach:** Assume reducing delays always improves performance; speed up response times without considering oscillation
**Expert approach:** Understand delays are integral to system function; sometimes slowing response dampens oscillation better than accelerating
**Timeline to mastery:** 3-12 months modeling systems with delays and observing counterintuitive stability effects
**Key insight:** "Slowing growth to allow adaptation often beats speeding technological response"
### Control Seeking
**Novice approach:** Demand prediction and control; treat uncertainty as solvable problem; impose rigid static policies
**Expert approach:** Embrace inherent unpredictability of self-organizing systems; use dynamic feedback policies; "dance with systems" rather than dominate
**Timeline to mastery:** 2-5 years accepting limits of knowability while maintaining effectiveness
**Key insight:** "We can't control systems, but we can dance with them"
### Symptom Relief Addiction
**Novice approach:** Implement quick interventions addressing symptoms; prevent harder work of root cause solution; create dependency
**Expert approach:** Strengthen original system capacity; remove obstacles to natural correction; avoid creating dependencies; plan capability restoration before withdrawal
**Timeline to mastery:** 1-2 years recognizing "shifting burden to intervenor" pattern across multiple domains
**Key insight:** "Intervention atrophies the system's own corrective capacity—like muscles unused"
## Mental Models
**The Bathtub (Stocks & Flows):** Water level changes based on faucet and drain, which can be temporarily decoupled—understanding that inflows and outflows operate independently is the foundation of all system analysis
**The Slinky:** Demonstrates system behavior emerges from internal structure (the spring) rather than external manipulation (your hand)—the system causes its own behavior
**Dancing vs. Conquering:** Mastery requires full engagement and responsiveness to feedback rather than prediction and control—letting go strategically, not pushing harder
**The Boiling Frog:** Gradual changes evade notice because memory of past conditions erodes—drift to low performance happens slowly enough to reset expectations downward
**Invisible Foot vs. Invisible Hand:** Adam Smith assumed perfect information creates collective good; bounded rationality means rational local decisions produce irrational collective outcomes
**Playing Field Leveling:** Like starting a new Monopoly game—antitrust, progressive taxation, and wealth redistribution counter "success to the successful" reinforcing loops
**Three Fairy Tale Wishes:** Systems produce exactly and only what you ask for, not what you want—measure wrong things, get wrong outcomes perfectly delivered
## Shibboleths
- "Systems cause their own behavior" (not external events)
- "Structure generates behavior" (events are symptoms)
- "Information is higher leverage than physical structure"
- "The goal is deduced from behavior, not rhetoric"
- "Shifting loop dominance explains complex behaviors"
- "Parameters are the lowest leverage despite attracting most attention"
- "Self-organization is the strongest form of resilience"
- "There are no separate systems—boundaries depend on purpose"
## References
- Source: *Thinking in Systems: A Primer* by Donella H. Meadows (2008)
- Historical context: Emerged from MIT system dynamics (1950s-60s), crystallized by *Limits to Growth* (1972)
- Foundational work synthesizing 30 years of systems modeling and teachingRelated Skills
skill-coach
Guides creation of high-quality Agent Skills with domain expertise, anti-pattern detection, and progressive disclosure best practices. Use when creating skills, reviewing existing skills, or when users mention improving skill quality, encoding expertise, or avoiding common AI tooling mistakes. Activate on keywords: create skill, review skill, skill quality, skill best practices, skill anti-patterns. NOT for general coding advice or non-skill Claude Code features.
3d-cv-labeling-2026
Expert in 3D computer vision labeling tools, workflows, and AI-assisted annotation for LiDAR, point clouds, and sensor fusion. Covers SAM4D/Point-SAM, human-in-the-loop architectures, and vertical-specific training strategies. Activate on '3D labeling', 'point cloud annotation', 'LiDAR labeling', 'SAM 3D', 'SAM4D', 'sensor fusion annotation', '3D bounding box', 'semantic segmentation point cloud'. NOT for 2D image labeling (use clip-aware-embeddings), general ML training (use ml-engineer), video annotation without 3D (use computer-vision-pipeline), or VLM prompt engineering (use prompt-engineer).
wisdom-accountability-coach
Longitudinal memory tracking, philosophy teaching, and personal accountability with compassion. Expert in pattern recognition, Stoicism/Buddhism, and growth guidance. Activate on 'accountability', 'philosophy', 'Stoicism', 'Buddhism', 'personal growth', 'commitment tracking', 'wisdom teaching'. NOT for therapy or mental health treatment (refer to professionals), crisis intervention, or replacing professional coaching credentials.
windows-95-web-designer
Modern web applications with authentic Windows 95 aesthetic. Gradient title bars, Start menu paradigm, taskbar patterns, 3D beveled chrome. Extrapolates Win95 to AI chatbots, mobile UIs, responsive layouts. Activate on 'windows 95', 'win95', 'start menu', 'taskbar', 'retro desktop', '95 aesthetic', 'clippy'. NOT for Windows 3.1 (use windows-3-1-web-designer), vaporwave/synthwave, macOS, flat design.
windows-3-1-web-designer
Modern web applications with authentic Windows 3.1 aesthetic. Solid navy title bars, Program Manager navigation, beveled borders, single window controls. Extrapolates Win31 to AI chatbots (Cue Card paradigm), mobile UIs (pocket computing). Activate on 'windows 3.1', 'win31', 'program manager', 'retro desktop', '90s aesthetic', 'beveled'. NOT for Windows 95 (use windows-95-web-designer - has gradients, Start menu), vaporwave/synthwave, macOS, flat design.
win31-pixel-art-designer
Expert in Windows 3.1 era pixel art and graphics. Creates icons, banners, splash screens, and UI assets with authentic 16/256-color palettes, dithering patterns, and Program Manager styling. Activate on 'win31 icons', 'pixel art 90s', 'retro icons', '16-color', 'dithering', 'program manager icons', 'VGA palette'. NOT for modern flat icons, vaporwave art, or high-res illustrations.
win31-audio-design
Expert in Windows 3.1 era sound vocabulary for modern web/mobile apps. Creates satisfying retro UI sounds using CC-licensed 8-bit audio, Web Audio API, and haptic coordination. Activate on 'win31 sounds', 'retro audio', '90s sound effects', 'chimes', 'tada', 'ding', 'satisfying UI sounds'. NOT for modern flat UI sounds, voice synthesis, or music composition.
wedding-immortalist
Transform thousands of wedding photos and hours of footage into an immersive 3D Gaussian Splatting experience with theatre mode replay, face-clustered guest roster, and AI-curated best photos per person. Expert in 3DGS pipelines, face clustering, aesthetic scoring, and adaptive design matching the couple's wedding theme (disco, rustic, modern, LGBTQ+ celebrations). Activate on "wedding photos", "wedding video", "3D wedding", "Gaussian Splatting wedding", "wedding memory", "wedding immortalize", "face clustering wedding", "best wedding photos". NOT for general photo editing (use native-app-designer), non-wedding 3DGS (use drone-inspection-specialist), or event planning (not a wedding planner).
websocket-streaming
Implements real-time bidirectional communication between DAG execution engines and visualization dashboards via WebSocket. Covers connection management, typed event protocols, reconnection with backoff, and React hook integration. Activate on "WebSocket", "real-time updates", "live streaming", "execution events", "state streaming", "push notifications". NOT for HTTP REST APIs, server-sent events (SSE), or general networking.
webapp-testing
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs. Activate on: Playwright, webapp testing, browser automation, E2E testing, UI testing. NOT for API-only testing without browser, unit tests, or mobile app testing.
web-weather-creator
Master of stylized atmospheric effects using SVG filters and CSS animations. Creates clouds, waves, lightning, rain, fog, aurora borealis, god rays, lens flares, twilight skies, and ocean spray—all with a premium aesthetic that's stylized but never cheap-looking.
web-wave-designer
Creates realistic ocean and water wave effects for web using SVG filters (feTurbulence, feDisplacementMap), CSS animations, and layering techniques. Use for ocean backgrounds, underwater distortion, beach scenes, ripple effects, liquid glass, and water-themed UI. Activate on "ocean wave", "water effect", "SVG water", "ripple animation", "underwater distortion", "liquid glass", "wave animation", "feTurbulence water", "beach waves", "sea foam". NOT for 3D ocean simulation (use WebGL/Three.js), video water effects (use video editing), physics-based fluid simulation (use canvas/WebGL), or simple gradient backgrounds without wave motion.