decision-helper

Frame and score architectural decisions with a weighted decision matrix.

415|44|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/notque/claude-code-toolkit --skill decision-helper-notque
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decision-helper
Source: https://github.com/notque/claude-code-toolkit/tree/main/skills/decision-helper
Command: npx skills add https://github.com/notque/claude-code-toolkit --skill decision-helper-notque

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Weighted, transparent decision-making for architectural and technology choices, turning gut feel into measurable recommendations.

Core Features & Use Cases

  • Frames decisions with 2-4 options and applies a weighted criteria matrix to rank them.
  • Detects close calls and surfaces where differences are marginal to prompt further analysis.
  • Persists decisions to ADR or task plans for auditability and future reference.
  • Enforces guardrails like a maximum of four options and mandatory alignment with CLAUDE.md guidelines.

Quick Start

Frame a decision with 2-4 options, define the criteria, score the options, and review the weighted results to select a winner.

Frequently Asked Questions about decision-helper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make architectural decisions using a weighted scoring matrix?

A weighted decision matrix evaluates 2-4 options against weighted criteria to produce a ranked recommendation. It transforms gut feel into measurable scores, detecting close calls where differences are marginal to prompt further analysis.

When should I use a weighted decision matrix for technology selection?

Use a weighted decision matrix for technology vendor selection and design trade-offs when comparing 2-4 options. It enforces option limits and alignment constraints, ensuring structured, transparent evaluation instead of subjective preference.

How do I document trade-off analysis results for future reference?

Document trade-off analysis by persisting weighted scoring outcomes to ADR or task plans. This ensures auditability and creates a historical record explaining why specific architectural or technology choices were selected.

Can I evaluate more than four options in a single decision matrix?

No, the decision matrix enforces a maximum of four options per evaluation. This constraint maintains analytical focus and prevents scoring dilution when performing architectural trade-off analysis.

What happens if the weighted scores for two options are very close?

When weighted scores are close, the matrix detects the close call and surfaces marginal differences. This prompts further analysis rather than blindly accepting a winner, ensuring narrow scoring gaps receive appropriate scrutiny.