Decision Guidance Agent Skill for the Age of Uncertainty
When data runs out, wisdom begins.
English Β· δΈζ Β· Philosophy Β· Install Guide Β· Examples
An open-source Agent Skill that guides you through high-stakes decisions when rational analysis alone isn't enough.
Most AI tools give you pros/cons lists and say "the decision is yours." Leap of Faith goes further β it surfaces the knowledge you already carry but can't articulate, names what's truly unknowable, and delivers a clear recommendation with conditions and stop-loss.
Built on two philosophical pillars:
- Kierkegaard's Leap of Faith β Recognizing that reason has limits, and at the boundary, you must commit
- Polanyi's Tacit Knowledge β Surfacing the intuition, experience, and bodily wisdom you carry but can't articulate
|
π’ Founders & CEOs
|
π§ Career Crossroads
|
|
π° Investors & Financial Planners
|
π§ Anyone Facing a Major Life Decision
|
graph TD
A["π― You describe your decision"] --> B["Step 1: Scene Recognition"]
B --> C["Identify domain(s) from 12 life domains"]
C --> D["Step 2: Three-Layer Analysis"]
D --> E["β
Known β Facts, data, validated experience"]
D --> F["π Unknown β Researchable gaps"]
D --> G["π«οΈ Unknowable β Where the leap lives"]
E --> H["Step 3: Tacit Knowledge Excavation"]
F --> H
G --> H
H --> I["Body signals β’ Reversal test β’ Time lens β’ Trust projection"]
I --> J["Step 4: Leap Point Judgment"]
J --> K["π’ LEAP β with conditions"]
J --> L["π΄ DON'T LEAP β with reasoning"]
J --> M["π‘ DEFER β with research plan"]
style A fill:#f9f3e3,stroke:#d4a843
style G fill:#fef3cd,stroke:#d4a843
style H fill:#e8f4f8,stroke:#5ba4c9
style K fill:#d4edda,stroke:#28a745
style L fill:#f8d7da,stroke:#dc3545
style M fill:#fff3cd,stroke:#ffc107
The key insight: Steps 1β2 exhaust rational analysis. Step 3 goes beyond reason β surfacing your tacit knowledge through structured questions about bodily reactions, emotional signals, and compressed experience. Step 4 delivers a clear judgment, not a cop-out.
π’ Founder: Should I accept this Term Sheet?
"Series A offer on the table. $8M at $40M pre. But the lead partner gives me a weird feeling β can't explain it. My co-founder wants to take it. Runway is 4 months."
Domains: Business Γ Investment Γ Family/Relationships
The Skill will:
- Map Knowns (runway, terms, market conditions), Unknowns (partner's post-close behavior), and Unknowables (whether a better offer would come)
- Excavate the "weird feeling" about the partner β is it pattern recognition from a past bad experience, or anxiety from the pressure?
- Apply the reversal test: "If this offer disappeared, would you feel relief or panic?"
- Deliver a leap-point analysis with explicit conditions (e.g., "Accept if you can negotiate X; walk if Y") and stop-loss
β Full walkthrough
π§ββοΈ Patient: Should I proceed with this surgery?
"Doctor recommends spinal fusion. 70% success rate. But I've read stories of people who got worse. I'm 42, two young kids. My body tells me to wait but my doctor says the window is closing."
Domains: Health/Medical Γ Family Γ Philosophy
The Skill will:
- Separate medical statistics (Known) from your specific prognosis (Unknown) and how your body will respond (Unknowable)
- Surface the conflict between bodily intuition ("wait") and medical authority ("the window is closing")
- Time lens: "If this surgery goes badly in a body you need for your children, what's your plan B?"
- Help distinguish between informed caution and fear-based avoidance
β Full walkthrough
π° Investor: All-in on one conviction bet, or diversify?
"I've studied this company for 2 years. Every metric says it's undervalued. But it would be 60% of my portfolio. My financial advisor says I'm crazy. My gut says this is the one."
Domains: Investment Γ Cognitive Breakthrough Γ Philosophy
The Skill will:
- Acknowledge the 2-year research as genuine expertise (not just confirmation bias)
- Test real risk tolerance: "Imagine it drops 40% tomorrow. Do you buy more or sell?" β your body's answer reveals your true tolerance
- Distinguish between high-conviction investing and emotional attachment
- Provide leap conditions with position sizing and stop-loss
β Full walkthrough
π Family: Should we emigrate?
"My wife and I keep going back and forth. Better education for the kids, but my aging parents are here. I'd have to rebuild my career from scratch. Some days it feels obvious. Some days it feels insane."
Domains: Cultural Identity Γ Family Γ Life Direction Γ Investment
The Skill will:
- Map the decision across four domains simultaneously
- Surface hidden signals: "On the days it feels obvious β what's driving that? On the days it feels insane β what changed?"
- Excavate intergenerational patterns: "Are you repeating your parents' choice to stay, or breaking it?"
- Apply the trust projection: "What would you advise your best friend in this situation?"
β Full walkthrough
π¨ Creator: Should I publish this?
"I've spent 3 years on this novel. It's deeply personal β family will recognize themselves. My agent says it could be a breakout debut. But it could also destroy relationships."
Domains: Creative Expression Γ Family Γ Ethical Courage
The Skill will:
- Name the core tension: authentic creative expression vs. relational cost
- Reversal test: "If you could never publish this, would you regret it for the rest of your life?"
- Surface what the creative urge actually is: "This story has possessed you for 3 years. Your psyche is trying to metabolize something."
- Help separate "Will they be hurt?" (Knowable) from "Will they forgive me?" (Unknowable)
β Full walkthrough
π§ Mental Health: Should I start therapy?
"I've been functioning fine. Great job, good relationship. But there's this background hum of... emptiness? Numbness? I don't even know if it's 'bad enough' for therapy. Feels indulgent."
Domains: Mental Health Γ Cognitive Breakthrough Γ Philosophy
The Skill will:
- Name what's happening: "The fact that you can't name it IS the data. Numbness is not fine β it's a signal."
- Challenge "functioning fine" as a metric: "Functioning is not the same as living."
- Confront the "not bad enough" belief: "Who told you there's a minimum threshold for deserving help?"
- Apply the time lens: "In 5 years, will you wish you'd started now?"
β Full walkthrough
π Founder at 32: Sell the company or keep building?
"Acquisition offer β enough to never worry about money again. But I built this from a dorm room 6 years ago. My co-founder wants to sell. My gut screams no. My partner says she just wants me to be happy. But I don't know what 'happy' looks like without this."
Domains: Business Γ Legacy Γ Family Γ Identity
The Skill will:
- Separate financial analysis (Known) from post-exit identity crisis (Unknowable)
- Surface the deepest question: "Who are you without this company? You've been building since you were 26. It's your entire adult identity."
- Time lens: "At 40, which version of yourself will you respect more?"
- Name the real fear: it's not about money β it's about whether you'll ever build something like this again
β Full walkthrough
| Traditional Approach | Leap of Faith |
|---|---|
| Pros/cons list, then "you decide" | Structured analysis + clear recommendation |
| Treats intuition as noise | Treats tacit knowledge as legitimate signal |
| Tries to eliminate all uncertainty | Names the unknowable, then helps you leap |
| Stops at rational analysis | Goes beyond reason with Polanyi's methods |
| One-size-fits-all | 12 specialized domains with unique excavation strategies |
| Avoids commitment | Provides leap conditions + stop-loss |
The skill covers the full spectrum of human decision-making:
| Domain | Core Question | What the Leap Looks Like |
|---|---|---|
| π’ Business / Startup | Should I commit? | Allocating resources under incomplete information |
| π§ Life Direction | Is this the right path? | Choosing a direction that can't be validated in advance |
| π§ Philosophy / Cognition | Can I trust my judgment? | Building belief beyond the boundary of reason |
| π¨βπ©βπ§ Family / Relationships | Should I make this change? | Making commitments under relational uncertainty |
| π‘ Cognitive Breakthrough | What do I really believe? | Trusting your own tacit knowledge |
| π§ Mental Health | Am I ready to face this? | Opening the door you're afraid to look behind |
| π° Investment / Finance | Where do I place my bet? | Committing capital in a world of probability |
| π₯ Health / Medical | Which treatment path? | Deciding for a body you inhabit but don't fully understand |
| π¨ Creative / Artistic | Do I dare to show this? | Exposing your unfiltered self to the world's judgment |
| βοΈ Ethical / Moral Courage | Can I live with staying silent? | Acting on values when cost is certain, impact unknowable |
| π Cultural Identity | Who am I becoming? | Deconstructing a known self to build an unknown self |
| π Legacy / Mortality | What was it all for? | Committing to meaning that can never be validated |
curl -fsSL https://raw.githubusercontent.com/clarkchenkai/leap-of-faith/main/install/install.sh | bashThe installer auto-detects your platforms and installs accordingly.
Manual (any platform):
git clone https://github.com/clarkchenkai/leap-of-faith.git
cp -r leap-of-faith/leap-of-faith ~/.your-platform/skills/leap-of-faithβ Full installation guide for all platforms: install/README-install.md
| Platform | Install Method | Status |
|---|---|---|
| Claude Code | ~/.claude/skills/ or ZIP upload |
β |
| Cursor | Remote Rule (GitHub URL) | β |
| OpenAI Codex | .agents/skills/ |
β |
| Google Antigravity | ~/.gemini/antigravity/skills/ |
β |
| Gemini CLI | ~/.gemini/skills/ |
β |
| OpenClaw / ClawHub | clawhub install leap-of-faith |
β |
| Amp / Goose / Cline | ~/.agents/skills/ |
β |
leap-of-faith/
βββ leap-of-faith/ # Skill package (copy this to any platform)
β βββ SKILL.md # Core guidance logic
β βββ references/ # Philosophy & decision theory
β βββ kierkegaard.md # Kierkegaard β Leap of Faith
β βββ polanyi.md # Polanyi β Tacit Knowledge
β βββ decision-domains.md # Twelve decision domains
β βββ prompts.md # Structured question templates
βββ examples/ # Real-world use case walkthroughs
βββ install/
β βββ install.sh # One-line installer
β βββ README-install.md # Detailed install guide
βββ docs/
β βββ philosophy.md # Deep dive into the philosophy
βββ README.md
βββ README-zh.md
βββ CHANGELOG.md
βββ LICENSE
"We can know more than we can tell." β Michael Polanyi
"Anxiety is the dizziness of freedom." β SΓΈren Kierkegaard
At the intersection of existentialism and epistemology lies a practical truth: the most important decisions cannot be fully resolved by analysis. They require a leap β but not a blind one. You leap carrying everything you know, including what you can't put into words.
β Read the full philosophical foundation: docs/philosophy.md
Contributions are welcome! See CONTRIBUTING.md for guidelines.
Ways to contribute:
- π New decision domains
- π‘ Better prompting strategies
- π Additional philosophical frameworks
- π§ Platform compatibility improvements
- π Translated use cases
See CHANGELOG.md for version history.
Built by Clark Chen Β· Founder of Cubic Consulting
When data runs out, wisdom begins.