Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
glebis avatar

Decision Toolkit

glebis/claude-skills

  • 287 installs
  • 339 repo stars
  • Updated August 4, 2026
  • glebis/claude-skills

decision-toolkit is an agent skill that generates structured decision frameworks, bias checkers, and interactive wizards for developers who need explicit tradeoff analysis before major technical or product commitments.

About

decision-toolkit is a glebis/claude-skills agent skill that turns ambiguous choices into structured decision support artifacts rather than making the call for you. It ships seven frameworks—First Principles, 10-10-10, Pre-Mortem, Regret Minimization, Weighted Decision Matrix, Opportunity Cost Calculator, and Scenario Matrix—plus a bias encyclopedia covering 20+ cognitive biases with counter-questions. Outputs include interactive HTML wizards, Markdown decision records, and voice-summary templates. Invoke with /decision-toolkit plus a decision question when facing technology pivots, architecture forks, or significant engineering investments that need documented criteria and tradeoff visibility.

  • Tradeoff matrices
  • Decision criteria
  • Option framing
  • Assumption logging
  • Reversible vs one-way calls

Decision Toolkit by the numbers

  • 287 all-time installs (skills.sh)
  • Ranked #919 of 3,282 Productivity & Planning skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/glebis/claude-skills --skill decision-toolkit

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs287
repo stars★ 339
Last updatedAugust 4, 2026
Repositoryglebis/claude-skills ↗

How do you structure major engineering decisions systematically?

Structure product and engineering decisions with frameworks, tradeoff matrices, and explicit criteria before committing to stock-checker or general project direction.

Who is it for?

Tech leads and senior engineers evaluating architecture forks, stack migrations, or high-impact product bets who want documented criteria before committing.

Skip if: Routine bug fixes, trivial config toggles, or teams that already have a signed-off decision record and only need implementation.

When should I use this skill?

User faces a significant technology, architecture, or product decision requiring tradeoff matrices, bias checks, or structured frameworks

What you get

Interactive HTML decision wizards, Markdown decision records, scenario matrices, and bias-checker artifacts

  • decision wizards
  • Markdown decision records
  • scenario matrices

By the numbers

  • Includes 7 named decision frameworks
  • Bias encyclopedia covers 20+ cognitive biases
  • Bundles 3 output templates plus 2 reference files

Files

SKILL.mdMarkdownGitHub ↗

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:

StyleAccommodation
AnalyticalNumbers, matrices, weighted scores
IntuitiveGut-check prompts, "how does this feel?"
VisualDiagrams, progress bars, color coding
VerbalWritten summaries, question prompts
SequentialStep-by-step wizard flow
GlobalDashboard 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?

Or extract from existing documents (meeting transcripts, notes).

Step 2: Choose Output Format

Based on user preference and context:

  • Complex decision + time available → Interactive HTML
  • Quick analysis → Markdown framework
  • On-the-go consumption → Voice summary
  • Need to share with others → PDF report

Step 3: Generate Tool

Use templates in templates/ directory:

  • decision-guide-template.html — Full interactive wizard
  • decision-framework.md — Text-based analysis
  • decision-voice-summary.md — Audio script template

Step 4: Customize

Replace placeholders:

  • {{DECISION_TITLE}} — What's being decided
  • {{CONTEXT}} — Background information
  • {{OPTIONS}} — Available choices
  • {{STAKEHOLDERS}} — People/teams involved
  • {{TIMELINE}} — Relevant dates
  • {{FACTORS}} — Key evaluation criteria

Step 5: Apply Branding (Optional)

If using Agency brand:

  • Import brand-agency skill CSS variables
  • Use neobrutalism styling
  • Apply Geist/EB Garamond typography

Accessibility Implementation

Semantic HTML

<main role="main" aria-label="Decision Guide">
  <nav aria-label="Progress">
    <ol role="list">...</ol>
  </nav>
  <section aria-labelledby="step-title">
    <h1 id="step-title">...</h1>
  </section>
</main>

Keyboard Navigation

// Ensure all interactive elements are focusable
// Tab order follows visual order
// Enter/Space activate buttons
// Arrow keys navigate options

Screen Reader Announcements

<div role="status" aria-live="polite" id="announcer">
  <!-- Announce step changes, selections, results -->
</div>

Color Contrast

/* Minimum 4.5:1 for normal text, 3:1 for large text */
--text-on-light: #000000;  /* 21:1 on white */
--text-on-dark: #ffffff;   /* 21:1 on black */
--text-on-primary: #ffffff; /* Check each color */

Reduced Motion

@media (prefers-reduced-motion: reduce) {
  * {
    animation: none !important;
    transition: none !important;
  }
}

Cultural Considerations

Individualist Framing

  • "What do YOU want?"
  • Personal goals and values
  • Individual opportunity cost

Collectivist Framing

  • "How does this affect your team/family?"
  • Relationship implications
  • Group harmony considerations

Power Distance Awareness

  • Some cultures defer to authority figures
  • Bias check should include "Am I deferring inappropriately?"
  • Include stakeholder perspectives explicitly

Uncertainty Tolerance

  • Some prefer detailed scenario analysis
  • Others find it anxiety-inducing
  • Offer both detailed and simplified views

Example Invocations

From Meeting Transcript

User: Analyze this meeting transcript and create a decision toolkit
Claude: [Extracts decision, stakeholders, options from transcript]
        [Generates interactive HTML guide]
        [Creates voice summary]

From Scratch

User: I need to decide whether to take a new job offer
Claude: [Asks clarifying questions]
        [Generates decision framework]
        [Customizes for career decision type]

Quick Analysis

User: Help me think through this partnership decision, just give me the frameworks
Claude: [Provides markdown framework]
        [Skips interactive tool]
        [Focuses on key questions]

Files

  • SKILL.md — This file
  • templates/decision-guide-template.html — Interactive wizard template
  • templates/decision-framework.md — Text-based analysis template
  • templates/decision-voice-summary.md — Audio script template
  • references/bias-encyclopedia.md — Detailed bias descriptions
  • references/framework-deep-dives.md — Extended framework explanations

Integration

Works well with:

  • brand-agency — Apply visual branding
  • transcript-analyzer — Extract decisions from meetings
  • pdf-generation — Create shareable reports
  • elevenlabs-tts — Generate audio summaries

Learnings

2026-01-09

Context: Initial skill creation from Synthius decision session

Key Insight: Dashboard-everything-at-once overwhelms. Step-by-step wizard with one concept per screen dramatically improves usability.

Architecture: 9-step journey covering all major decision dimensions. State object persists selections across steps. Summary aggregates everything.

Accessibility Note: High contrast neobrutalism actually helps accessibility — clear borders, distinct states, no subtle gradients.

Related skills

mattpocockGrill MeHave an agent relentlessly pressure-test their plan or design until every decision branch is resolved and shared understanding is reached.691k196kmattpocockGrill With DocsPressure-test architecture decisions against their live codebase and living documentation before writing production code.585k196kopen.feishu.cnLark CalendarLet their coding agents read, create, and manage events inside Lark (Feishu) Calendar directly from natural language instructions.493kopen.feishu.cnLark ImLet their coding agent send instant notifications, post updates, and receive commands directly inside Lark (Feishu) workspaces.493kopen.feishu.cnLark ContactLet their AI coding agents read and write contacts, send messages, and manage user data inside Lark (Feishu).493kopen.feishu.cnLark AttendanceAutomatically fetch and report daily attendance data from Lark (Feishu) into their own tools or agents.493k

How it compares

Use decision-toolkit when you need interactive decision artifacts and bias-checked frameworks; use generic planning skills when you only need lightweight task breakdown without formal tradeoff documentation.

FAQ

What frameworks does decision-toolkit include?

decision-toolkit provides seven frameworks: First Principles Thinking, 10-10-10, Pre-Mortem Analysis, Regret Minimization, Weighted Decision Matrix, Opportunity Cost Calculator, and Scenario Matrix with probability calibration.

What outputs does decision-toolkit generate?

decision-toolkit produces interactive HTML wizards styled with Agency neobrutalism, Markdown decision-framework exports, and voice-summary templates for Orpheus TTS from bundled templates in templates/ and references/.

When should decision-toolkit be invoked?

decision-toolkit fits significant choices—career moves, technology decisions, major purchases, or strategic pivots—where systematic analysis, bias checking, and explicit tradeoff documentation are needed before commitment.

Productivity & Planningpmworkflow
Browse by category
AI & AgentsFrontend & DesignBackend & DataDev ToolsAutomationTesting & ReviewSecurityMonitoring & CloudDocs & Planning
Design & frontend
Design systemsAnimation & motionAccessibility (a11y)CSS & TailwindUI designUXDesign to codeshadcn/uiLanding pagesBest design skills
Most searched skills
find-skillscavemanfrontend-designbrainstormingsystematic-debuggingstop-slopemil-design-engui-ux-pro-maxkarpathy-guidelinesweb-design-guidelinesreact-best-practicesgrill-meimprovemicrosoft-foundryagent-browser
Browse all listings
All agent skillsAll MCP serversAll marketplacesAll plugins

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.