| name | s4h-decision-criteria-weighting |
| description | Runs a weighted multi-criteria analysis — making explicit what matters, how much, and how each option performs against it. Triggers: 'weighted decision matrix', 'multi-criteria analysis', 'help me choose between', 'compare these options', 'decision matrix'. |
Decision Criteria Weighting
Intuitive decisions fail when too many criteria are in play and their relative importance
isn't made explicit. This skill forces that explicitness. The goal is not to replace
judgment — it is to make the judgment visible enough to inspect, challenge, and defend.
Your Process
Step 1: State the Decision and List Real Options
Name the decision. List the actual options being considered — not aspirational ones. If an
option isn't genuinely available, remove it before it contaminates the analysis.
Framing check: Confirm the decision and its intended outcome before continuing. State what you've identified — the specific decision being made and the options on the table — in one sentence, then use AskUserQuestion:
- Question: "I'm reading this as: [your one-sentence framing of the decision and the options being compared]. Is that right?"
- Header: "Framing"
- Options:
- Yes — proceed — framing is correct
- Adjust — one element is off; user will correct it before you continue
- Reframe — different situation than read; incorporate the correction before proceeding
Step 2: Identify 4-8 Criteria
Name the criteria that define a good outcome for this specific decision. Criteria should
be independent (not measuring the same thing twice), observable (you can score against
them), and genuinely relevant (removing one would change the analysis).
Before narrowing: Show the complete generated set of candidate criteria to the user first. Use AskUserQuestion:
- Question: "I've identified [N] candidate criteria. Before I narrow to the most decision-relevant ones, are there any you'd flag as especially important, or any I've missed?"
- Header: "Prioritise"
- Options:
- Proceed with your selection — the set looks right
- Flag one — user will name a specific criterion to include
- Add a missing one — user will describe it
Step 3: Weight the Criteria
Distribute exactly 100 points across the criteria. This forces trade-offs — you cannot
weight everything highly. If everything matters equally, the distribution reveals a
failure to think through what actually matters most.
Step 4: Score Each Option
Score each option on each criterion from 1 to 5. Do this before calculating totals — the
sequence matters. Scoring after you see where things are headed is reverse-engineering to
confirm a preference, which defeats the exercise.
Step 5: Calculate Weighted Scores
Weighted score = sum of (weight × score) for each criterion. Calculate for all options.
Step 6: Sense-Check
If the math agrees with your intuition, good. If it disagrees, investigate: is the
intuition catching something the criteria missed, or is the intuition rationalising a
preference? Either is possible. Don't dismiss either.
Human Check-in
Before proceeding, use the AskUserQuestion tool. State your interpretation of the situation in 1–2 sentences — what is being analyzed and what the core question is — then ask:
- Question: "My read: [your 1–2 sentence interpretation]. How do you want to proceed?"
- Header: "Scope"
- Options:
- Full analysis — Complete all steps, reasoning shown throughout
- Key findings only — Bottom-line output, skip step-by-step detail
- Weights only — Establish criteria priorities before scoring any options
- Reframe — The read is off; correct it and the analysis will follow the corrected framing
Proceed based on their selection. If the user reframes, incorporate the correction before running any analysis.
Output Format
Decision: [Statement]
Criteria and weights:
| Criterion | Weight (total = 100) |
|---|
| |
Scored matrix:
| Option | [Criterion 1] (×W) | [Criterion 2] (×W) | ... | Weighted Total |
|---|
| | | | |
| | | | |
Sense-check:
[Does the result match intuition? If not — what is the intuition picking up that the
matrix doesn't capture, or what is the intuition getting wrong?]
Recommendation:
[Option name] — [one sentence rationale]
Notes
The value of this exercise is in the weighting step, not the scoring. Most decision
disagreements are disagreements about what matters, not about how options perform.
Making weights explicit moves the conversation to the right place.
What's Next
After delivering this output, use AskUserQuestion to offer the next move:
- Question: "Criteria weighted and options ranked. What's next?"
- Header: "Next"
- Options:
/s4h-decision-premortem-analysis — Stress-test the winning option before committing/s4h-decision-reversibility-analysis — Assess how reversible the top option is/s4h-ethics-check — Check whether the top option is ethically sound- Done — Wrap up and synthesise what we have so far
