Agent skill

Decision Toolkit

by glebis in glebis/claude-skills

Generate structured decision-making tools — step-by-step guides, bias checkers, scenario explorers, and interactive dashboards.

MITAuto-check passedFrontend & Design

Install Decision Toolkit

skills CLI
$ npx skills add glebis/claude-skills --skill decision-toolkit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install glebis/claude-skills decision-toolkit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/glebis/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/decision-toolkit .claude/skills/decision-toolkit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
decision-toolkit
GitHub stars
389
Token cost
~2.6k tokens
SKILL.md length
690 words
Files
8 (incl. references)
Skills in repo
91
Repo updated
First seen
Licence
MIT

At a glance

Generate structured decision-making tools — step-by-step guides, bias checkers, scenario explorers, and interactive dashboards.

  • Works in 9 steps: Interactive HTML Guide (Primary) → Markdown Framework → Voice Summary → …
  • Facing significant choices requiring systematic analysis
  • SKILL.md covers Overview, Philosophy, When to Use and Decision Types, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Decision Toolkit is an agent skill from glebis/claude-skills. 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.

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including reference files (for example `.claude-plugin/plugin.json`, `references/bias-encyclopedia.md` and `references/framework-deep-dives.md`).

It sits in Frontend & Design, covering Accessibility. The repository describes itself as: Collection of Claude Code skills for enhanced AI workflows. The licence is MIT.

When your agent uses it

  • Facing significant choices requiring systematic analysis
  • Tasks that involve Accessibility

Example prompts

  • “/decision-toolkit”

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Interactive HTML Guide (Primary)
  2. Markdown Framework
  3. Voice Summary
  4. PDF Report
  5. Gather Context
  6. Choose Output Format
  7. Generate Tool
  8. Customize
  9. Apply Branding (Optional)

What it can do on your machine

Read from SKILL.md and the folder at commit 7524dff. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are html, css and javascript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Decision Toolkit loads about 2.6k tokens when it runs, and up to ~7.6k if it reads all its reference files. Until then it costs about 67 tokens; SKILL.md has 690 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~67
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from glebis/claude-skills at commit 7524dff, republished under its MIT licence (© glebis). 690 words, ~2,598 tokens.

Download SKILL.mdSave it as .claude/skills/decision-toolkit/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
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.

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).

Show full SKILL.md (287 more words)Show less
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
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
javascript
// Ensure all interactive elements are focusable
// Tab order follows visual order
// Enter/Space activate buttons
// Arrow keys navigate options
Screen Reader Announcements
html
<div role="status" aria-live="polite" id="announcer">
  <!-- Announce step changes, selections, results -->
</div>
Color Contrast
css
/* 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
css
@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.

© glebis, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (references) in decision-toolkit of glebis/claude-skills.

  • SKILL.md
  • .claude-plugin/plugin.json
  • references/bias-encyclopedia.md
  • references/framework-deep-dives.md
  • templates/decision-export-template.md
  • templates/decision-framework.md
  • templates/decision-guide-template.html
  • templates/decision-voice-summary.md

Open the folder on GitHubat commit 7524dff

Compare with similar skills

Decision Toolkit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Decision Toolkit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Decision Toolkit this skillglebis/claude-skills389—~2.6kAutomated safety check: PassMIT
Web Interface Guidelines Reviewervercel-labs/openreview1.7k98 repos~308Automated safety check: PassNone
Accessibility Reviewmarkmead/hyperui12k1 repos~1.1kAutomated safety check: PassMIT
Web Animation DesignbaptisteArno/typebot.io11k2 repos~2.7kAutomated safety check: PassCustom licence
Accessibility Fixeribelick/ui-skills9.5k4 repos~1.2kAutomated safety check: PassMIT
Wcag Audit PatternsvmDeshpande/ai-agent-automation17811 repos~610Automated safety check: PassApache-2.0

Similar skills

  • Web Interface Guidelines Reviewer

    vercel-labs/openreview

    Official

    Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my…

    1.7k GitHub starsUsed in 98 repos~308 tokens
    Frontend & DesignAuto-check passed
  • Accessibility Review

    markmead/hyperui

    Run a WCAG 2.1 AA accessibility audit on a design or page. An agent skill from markmead/hyperui.

    12k GitHub starsUsed in 1 repo~1.1k tokens
    Frontend & DesignAuto-check passed
  • Web Animation Design

    baptisteArno/typebot.io

    Guides easing, timing and animation choices for UI motion, based on a web animation course, and reviews existing animations in a before-and-after table.

    11k GitHub starsUsed in 2 repos~2.7k tokens
    Frontend & DesignAuto-check passed
  • Accessibility Fixer

    ibelick/ui-skills

    Audits and fixes HTML accessibility problems such as ARIA labels, keyboard navigation, focus management, contrast and form errors with minimal changes.

    9.5k GitHub starsUsed in 4 repos~1.2k tokens
    Frontend & DesignAuto-check passed
  • Wcag Audit Patterns

    vmDeshpande/ai-agent-automation

    Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance.

    178 GitHub starsUsed in 11 repos~610 tokens
    Frontend & DesignAuto-check passed
  • Baseline UI

    ibelick/ui-skills

    Applies a fixed set of UI rules for stack, components, interaction, animation, typography and layout, or reviews a file against them with concrete fixes.

    9.5k GitHub starsUsed in 8 repos~855 tokens
    Frontend & DesignAuto-check passed

More from glebis/claude-skills

All 91 skills in this repo
  • Runs a human-first workflow for labeling PII spans in a transcript, then scores inter-annotator agreement and drafts an adjudicated gold set.

    389 GitHub stars~1.3k tokensUpdated 12 days ago
    Auto-check passed
  • Automates a dedicated, logged-in Chrome instance per profile without ever closing the user's own open tabs or browser windows.

    389 GitHub stars~973 tokensUpdated 12 days ago
    Auto-check passed
  • Deep Research

    glebis/claude-skills

    This skill should be used when conducting comprehensive research on any topic using the OpenAI Deep Research API.

    389 GitHub stars~2.6k tokensUpdated 12 days ago
    Auto-check: notes
  • Elimination Research

    glebis/claude-skills

    This skill should be used for elimination-style research where the user wants to choose from a shortlist of products, tools, services, vendors, or other options using explicit criteria, numeric…

    389 GitHub stars~1.6k tokensUpdated 12 days ago
    Auto-check passed
  • Narrated HTML Presentations

    glebis/claude-skills

    Generates a self-contained HTML presentation with article and slides modes, ElevenLabs voiceover narration and optional GPT Image 2 illustrations.

    389 GitHub stars~2.3k tokensUpdated 12 days ago
    Auto-check: notes
  • Writes fictional but realistic coaching or therapy session transcripts for evals, demos and few-shot examples, in several modalities and export formats.

    389 GitHub stars~2.9k tokensUpdated 12 days ago
    Auto-check passed

Questions about Decision Toolkit

What does Decision Toolkit do?

Generate structured decision-making tools — step-by-step guides, bias checkers, scenario explorers, and interactive dashboards. Decision Toolkit is an agent skill from glebis/claude-skills. Generate structured decision-making tools — step-by-step guides, bias checkers, scenario explorers, and interactive dashboards.

When should I use Decision Toolkit?

Decision Toolkit fits situations like: facing significant choices requiring systematic analysis; tasks that involve Accessibility.

How do I install Decision Toolkit in Claude Code?

Run `npx skills add glebis/claude-skills --skill decision-toolkit -a claude-code`. Or copy the skill folder (decision-toolkit in glebis/claude-skills) into .claude/skills/decision-toolkit in your project. Claude Code loads it when a task matches its description.

How do I install Decision Toolkit in Codex?

Run `npx skills add glebis/claude-skills --skill decision-toolkit -a codex`. Or copy the skill folder (decision-toolkit in glebis/claude-skills) into .agents/skills/decision-toolkit in your project. Codex loads it when a task matches its description.

Can I use Decision Toolkit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add glebis/claude-skills --skill decision-toolkit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/decision-toolkit, .gemini/skills/decision-toolkit, .github/skills/decision-toolkit and .opencode/skills/decision-toolkit in your project.

What does Decision Toolkit need to run?

SKILL.md names no scripts, command-line tools or credentials: Decision Toolkit is instructions for the agent only.

Does Decision Toolkit access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Decision Toolkit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Decision Toolkit use?

Decision Toolkit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Decision Toolkit use?

About 2.6k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5k tokens, read only when the agent opens those files.

What are the alternatives to Decision Toolkit?

Skills that share tags, products or a category with Decision Toolkit: Web Interface Guidelines Reviewer (vercel-labs/openreview, 1.7k stars), Accessibility Review (markmead/hyperui, 12k stars), Web Animation Design (baptisteArno/typebot.io, 11k stars) and Accessibility Fixer (ibelick/ui-skills, 9.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Decision Toolkit?

glebis (a GitHub user) maintains it in glebis/claude-skills, which has 389 GitHub stars. The repository holds 91 skills in this directory. The repository was last updated on September 26, 2026.

Source: glebis/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.