/decision-toolkit

name: decision-toolkit
description: Generate structured decision-making tools — step-by-step guides, bias checkers, scenario explorers, and interactive dashboards. Use when facing significant choices requiring systematic analysis. Supports multiple cognitive styles and output formats.
disable-model-invocation: true

Decision Toolkit

Overview

Create structured decision support materials that help humans think through significant choices systematically. This skill produces interactive tools, not just analysis — empowering the decision-maker rather than deciding for them.

Philosophy

Principles

1. **Guide, don't decide** — Tools illuminate the decision space; humans choose 2. **One thing at a time** — Reduce cognitive load through progressive disclosure 3. **Multiple lenses** — Same decision viewed through different frameworks reveals blind spots 4. **Biases visible** — Make cognitive biases explicit and checkable 5. **Actionable output** — End with concrete next steps, not abstract conclusions

Accessibility First

• Support screen readers (semantic HTML, ARIA labels)
• Keyboard navigable (tab order, focus states)
• High contrast by default (WCAG AA minimum)
• Reduced motion option
• Works without JavaScript (graceful degradation)
• Mobile-friendly touch targets (44px minimum)

Cognitive Inclusivity

Different people process decisions differently:

| Style | Accommodation | |-------|---------------| | **Analytical** | Numbers, matrices, weighted scores | | **Intuitive** | Gut-check prompts, "how does this feel?" | | **Visual** | Diagrams, progress bars, color coding | | **Verbal** | Written summaries, question prompts | | **Sequential** | Step-by-step wizard flow | | **Global** | Dashboard overview option |

When to Use

Invoke this skill when user faces:

• Collaboration/partnership decisions
• Career or job changes
• Investment of significant time/money
• Project prioritization
• Technology/tool selection
• Any choice with multiple factors and uncertainty

**Not for**: Trivial decisions, emergency responses, or when user just needs information.

Decision Types

Type 1: Opportunity Evaluation

*Should I pursue this opportunity?*

• Partnership, job offer, investment, project

Type 2: Resource Allocation

*Where should I invest my time/money/attention?*

• Prioritization, budgeting, focus areas

Type 3: Risk Assessment

*What could go wrong and is it worth it?*

• New ventures, changes, experiments

Type 4: Trade-off Navigation

*Which option among alternatives?*

• Tool selection, hire decisions, strategic choices

The Decision Journey

Nine steps, each focused on one dimension:

┌─────────────────────────────────────────────────────────────┐
│  1. CONTEXT         What is the decision?                   │
│  2. FIRST PRINCIPLES Does this solve a real problem?        │
│  3. TIMING          Is now the right moment?                │
│  4. STAKEHOLDERS    Who else is involved? Are they stable?  │
│  5. BIASES          What might cloud my judgment?           │
│  6. OPPORTUNITY COST What am I giving up?                   │
│  7. SCENARIOS       What could happen?                      │
│  8. QUESTIONS       What do I still need to learn?          │
│  9. SYNTHESIS       Summary + decision                      │
└─────────────────────────────────────────────────────────────┘

Output Formats

1. Interactive HTML Guide (Primary)

Step-by-step wizard with:

• Progress indicator
• One question per screen
• State persistence across steps
• Final summary aggregating all inputs
• Keyboard navigation
• Print-friendly CSS

2. Markdown Framework

For offline/text-based use:

• Structured prompts
• Checkbox-style bias audit
• Fill-in-the-blank templates

3. Voice Summary

For audio consumption:

• 5-7 paragraph executive summary
• Orpheus TTS markup for emotional texture
• Key decision + rationale

4. PDF Report

For documentation/sharing:

• Professional formatting
• All frameworks applied
• Appendix with raw analysis

Frameworks Reference

First Principles Test

1. What problem does this solve?
2. Can I solve it myself?
3. Is this the best solution?
4. What assumptions am I making?
5. If starting fresh today, would I choose this?

Bias Checklist

□ FOMO — Am I afraid of missing out?
□ Sunk Cost — Am I factoring past investment?
□ Authority — Am I deferring to credentials?
□ Social Proof — Am I following the crowd?
□ Commitment — Do I feel locked in by past statements?
□ Optimism — Am I assuming problems will resolve?
□ Recency — Am I overweighting recent events?
□ Confirmation — Am I seeking validating info only?
□ Shiny Object — Is novelty distracting me?
□ Loss Aversion — Am I overweighting potential losses?

Opportunity Cost Calculator

Hours/week × Weeks × Hourly rate = Direct cost
+ What else could those hours produce?
+ What relationships/opportunities might suffer?
= True opportunity cost

Scenario Matrix

| Scenario | Probability | Outcome | Expected Value |
|----------|-------------|---------|----------------|
| Worst    | X%          | ...     | ...            |
| Bad      | X%          | ...     | ...            |
| Neutral  | X%          | ...     | ...            |
| Good     | X%          | ...     | ...            |
| Best     | X%          | ...     | ...            |

Pre-mortem

Imagine it's [future date]. This decision failed. Why?

Possible causes:
1. ...
2. ...
3. ...

Which causes are within my control?
Which warning signs should I watch for?

10-10-10 Framework

How will I feel about this decision in:
- 10 minutes?
- 10 months?
- 10 years?

Regret Minimization

Imagine you're 80 looking back.
Would you regret doing this?
Would you regret NOT doing this?

Implementation Guide

Step 1: Gather Context

Ask user for:

• What is the decision?
• What are the options?
• What's the timeline?
• What's at stake?
• Any relevant background?