Agent skill

Decision Navigator

by sickn33 in sickn33/agentic-awesome-skills

Guide stuck or overwhelmed users through targeted branching questions until they reach concrete next steps.

MITAuto-check passed

Install Decision Navigator

skills CLI
$ npx skills add sickn33/agentic-awesome-skills --skill decision-navigator -a claude-code

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

GitHub CLI
$ gh skill install sickn33/agentic-awesome-skills decision-navigator --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/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/decision-navigator .claude/skills/decision-navigator && 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-navigator
GitHub stars
47k
Used in
1 other repo
Token cost
~2.4k tokens
SKILL.md length
1,450 words
Files
1
Skills in repo
1,493
Repo updated
First seen
Licence
MIT

At a glance

Guide stuck or overwhelmed users through targeted branching questions until they reach concrete next steps.

  • Works in 4 steps: Acknowledge and orient (1–2 sentences) → Ask one clarifying question → Branch based on their answer → …
  • SKILL.md covers Core Philosophy, When to Use This Skill, The Process and Branching Guidelines, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Decision Navigator is an agent skill from sickn33/agentic-awesome-skills. Guide stuck or overwhelmed users through targeted branching questions until they reach concrete next steps.

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400+ agentic skills. Includes… The licence is MIT.

Example prompts

  • “/decision-navigator”

Requirements

  • Docker

Workflow steps

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

  1. Acknowledge and orient (1–2 sentences)
  2. Ask one clarifying question
  3. Branch based on their answer
  4. Deliver concrete steps at the leaf

What it can do on your machine

Read from SKILL.md and the folder at commit 680176d. 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.

    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 Navigator loads about 2.4k tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 1,450 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~32
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k

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 sickn33/agentic-awesome-skills at commit 680176d, republished under its MIT licence (© sickn33). 1,450 words, ~2,354 tokens.

Download SKILL.mdSave it as .claude/skills/decision-navigator/SKILL.md (or your agent's skills folder).
name
decision-navigator
description
Guide stuck or overwhelmed users through targeted branching questions until they reach concrete next steps.
category
planning
risk
safe
source
community
source_type
community
date_added
2026-05-27

Decision Navigator

Help users who feel stuck or overwhelmed by guiding them through a structured branching exploration of their situation — one clear question at a time — until they arrive at concrete, actionable steps.

Core Philosophy

Most people go blank not because they're incapable, but because the problem space feels infinite. Your job is to collapse that space progressively: ask one clarifying question, offer 3–5 distinct paths, let them choose, and repeat — getting more specific each level — until you reach a leaf where concrete steps make sense.

Never overwhelm with a wall of options or advice upfront. Navigate, don't lecture.


When to Use This Skill

Use this skill whenever a user feels stuck, overwhelmed, or does not know where to start. Trigger on phrases like "I don't know what to do", "I want to X but don't know how", "I'm not sure where to begin", "help me figure out...", "I feel lost about...", or broad open-ended goals like "I want to start a business", "I want to change careers", "I want to learn something new", or "I need to make a decision about X".

Do not wait for the user to ask a precise question. If they seem stuck or overwhelmed, use this skill.

The Process

Step 1 — Acknowledge and orient (1–2 sentences)

Reflect the situation back briefly so the user feels heard. Don't give advice yet.

"Changing careers is a big one — lots of directions it could go. Let me help you narrow it down."

Step 2 — Ask one clarifying question

Ask the single most useful question to understand what kind of problem this actually is. Frame it as a choice between 3–5 concrete options, not open-ended.

Option labels must be short — 2 to 6 words max. No explanations inside the bullet. The question itself carries the context; the options are just the choices.

Good question format:

"What's driving this for you right now?

  • Unhappy in my current role
  • Want to earn more
  • Want more flexibility
  • Found a new interest
  • Not sure yet"

Bad question format:

"Tell me more about your situation." ← too open, doesn't reduce the space

"- Simplicity: I want the easiest setup with zero server management." ← option labels should never have colons or sub-explanations

Step 2b — Extract before you ask

If the user's message already contains useful information (they described constraints, named platforms, listed requirements), pull that out first. Don't make them re-answer what they already told you.

"Ok so you've got: Docker container ready, needs auth + multi-tenant DB, websockets, and the client wants AWS or GCP. That's a lot. What's the scariest part right now?

  • Choosing between AWS and GCP
  • Understanding how all the pieces connect
  • Actually deploying the container
  • Not sure where to even begin"
Step 3 — Branch based on their answer

After they choose, go one level deeper. Each level should feel more specific.

Typical depth: 3–4 levels before reaching actionable steps.

Level 1 — What kind of problem is this? (motivation, constraint, knowledge gap, fear, resources...) Level 2 — What's the most important factor for them? (urgency, risk tolerance, resources available...) Level 3 — What's their current situation / starting point? Level 4 (leaf) — Give concrete steps

Step 4 — Deliver concrete steps at the leaf

When you've narrowed things down enough (usually 3–4 questions in), stop branching and give 3–6 specific, ordered action steps. These should be immediately doable, not vague advice.

Good leaf output:

Based on what you've shared — you're unhappy in your current role, want to stay in tech, and have about 3 months before you need to move — here's where to start:

  1. Spend one hour this week writing down what specifically drains you vs. energizes you at work.
  2. Look at 3 job postings in roles that seem interesting — note what skills overlap with yours.
  3. Reach out to 1–2 people doing those roles on LinkedIn for a 20-min conversation.
  4. Set a decision deadline: commit to applying somewhere within 6 weeks.
  5. Tell one trusted person about your plan so you have accountability.

Bad leaf output:

"You should network more and update your resume." ← too vague


Branching Guidelines

How to design your questions
  • Short option labels — 2 to 6 words. Never a colon + explanation inside a bullet. The question sets the context; options are just the fork in the road.
  • Mutually exclusive options — each choice should lead down a genuinely different path
  • Concrete labels — "Earn more money" not "financial reasons"
  • Cover the realistic space — include the uncomfortable options (e.g. "Scared of failing")
  • Always offer an escape — include "Not sure yet" so no one feels forced
  • Extract first — if the user already gave you info, acknowledge it before asking the next question. Summarize what you know in 1–2 lines, then ask only what's still missing.
When to branch vs. when to go straight to steps

Go straight to concrete steps when:

  • The user's situation is already specific enough (they've answered 3+ questions)
  • The remaining branches would all lead to the same advice
  • The user says something like "just tell me what to do"

Keep branching when:

  • The advice would be meaningfully different depending on their answer
  • You'd be guessing at key constraints (budget, timeline, risk tolerance, etc.)
  • The problem space still feels large
Show full SKILL.md (591 more words)Show less
How many options per question
  • 3 options — when the distinctions are clear-cut
  • 4–5 options — when the space is genuinely varied
  • Never more than 5 — more than that is overwhelming (the whole problem we're solving)

Tone and Style

  • Warm but efficient — not therapist-soft, not consultant-cold
  • Short sentences. No jargon.
  • Reflect their words back to them (if they said "burned out", use "burned out" not "fatigued")
  • Never judge the path they choose
  • If they seem emotionally distressed (not just confused), acknowledge that before navigating

Format

Present choices as a short list, not prose:

[Question]

- Option A
- Option B
- Option C
- Something else / not sure

At the leaf, use a numbered list for steps. Start with the number ("1.") not a bullet.

Keep the whole interaction feeling like a conversation, not a form.


Example Flow

User: I want to start a business but I have no idea where to start.

Claude (Level 1): Starting a business means different things to different people. What's the main thing drawing you to it?

  • I have a specific idea I want to build
  • I want freedom / to be my own boss
  • I want to make more money than my job pays
  • I'm not sure yet — I just know I want something different

User: I have a specific idea I want to build.

Claude (Level 2): Got it. Where are you in terms of the idea itself?

  • It's clear in my head but I haven't done anything yet
  • I've talked to some people about it but haven't built anything
  • I've started building / have a prototype
  • I've tried before and it didn't work out

User: It's clear in my head but I haven't done anything yet.

Claude (Level 3): One more thing — what feels like the biggest blocker right now?

  • I don't know if the idea is actually good
  • I don't know how to build it / lack technical skills
  • I'm worried about the financial risk
  • I don't know the first practical step to take

User: I don't know if the idea is actually good.

Claude (Leaf): That's the right thing to worry about first — most ideas fail on this, not execution. Here's how to find out quickly:

  1. Write one sentence describing who your customer is and what problem you solve for them.
  2. Find 5 people who match that description. Not friends — people who'd actually pay.
  3. Ask them: "Do you have this problem? How do you currently deal with it?"
  4. Do NOT pitch your solution yet. Just listen. If they describe your problem unprompted, that's signal.
  5. After 5 conversations, you'll know if this is real. If 3+ people have the problem badly, keep going.

Edge Cases

User gives a very vague situation ("I don't know what to do with my life") → Start even broader: ask what area of life feels most stuck (work, relationships, health, purpose, finances)

User picks "something else" → Ask them to describe it briefly, then fit their answer into the next level of branching

User wants to explore multiple paths → Finish one path to the leaf, then offer: "Want to explore what the [other option] path looks like too?"

User is clearly in distress → Pause the navigation. Acknowledge first. Ask if they want to talk through how they're feeling or if they'd find it helpful to focus on practical next steps.

Limitations

  • This skill helps structure uncertainty; it does not replace professional legal, medical, financial, or mental-health advice.
  • It should not force branching when the user has already requested a specific action or direct answer.
  • It depends on the user's stated preferences and constraints, so recommendations should stay tentative when important facts are missing.

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

Files

Just SKILL.md in skills/decision-navigator of sickn33/agentic-awesome-skills.

Open the folder on GitHubat commit 680176d

Used in 1 other repository

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in sickn33/agentic-awesome-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Decision Navigator 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 Navigator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Decision Navigator this skillsickn33/agentic-awesome-skills47k1 repos~2.4kAutomated safety check: PassMIT
Branchesredis/RedisInsight8.9k—~409Automated safety check: PassCustom licence
Conventional Branchgithub/awesome-copilot40k—~1.1kAutomated safety check: PassMIT
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Git Branch Namingmakeplane/plane61k—~594Automated safety check: PassAGPL-3.0
Breadcrumb Navigationthedaviddias/Front-End-Checklist74k—~418Automated safety check: PassMIT

Similar skills

  • Branches

    redis/RedisInsight

    Official

    Create and name git branches following project conventions. An agent skill from redis/RedisInsight.

    8.9k GitHub stars~409 tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • Conventional Branch

    github/awesome-copilot

    Official

    Create Git branches following the Conventional Branch specification (feature/, bugfix/, hotfix/, release/, chore/).

    40k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Git Branch Naming

    makeplane/plane

    Names a new Git branch with a type prefix, the lowercased work item ID and a short kebab-case description, so the ID can be extracted later from the branch name.

    61k GitHub stars~594 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Breadcrumb Navigation

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing templates, rendered HTML, or shared components related to Implement accessible breadcrumb navigation.

    74k GitHub stars~418 tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed
  • Navigation Landmark

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing templates, rendered HTML, or shared components related to Use navigation landmark regions.

    74k GitHub stars~417 tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed

More from sickn33/agentic-awesome-skills

All 1,493 skills in this repo
  • Liuguang Banlan UI

    sickn33/agentic-awesome-skills

    Implements an interface in one of two named color modes, iridescent white or colorful black, from a parameterized starter that reports measured color intensity.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • User Thoughts Memory

    sickn33/agentic-awesome-skills

    Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Using LWC Memory and Graphs

    sickn33/agentic-awesome-skills

    Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.

    47k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Find Complementary Founders

    sickn33/agentic-awesome-skills

    Guides an agent through assessing its own owner for cofounder fit, publishing an approved profile, and ranking complementary profiles other agents published for their owners.

    47k GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check passed
  • Whatsapp Cloud API

    sickn33/agentic-awesome-skills

    Integracao com WhatsApp Business Cloud API (Meta). An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~4.5k tokens
    Auto-check passed
  • Cline Pilot

    sickn33/agentic-awesome-skills

    Acts as a proxy for the Cline CLI, dispatching coding tasks one at a time, monitoring runs by hard evidence, relaying decisions to you and learning per-project preferences.

    47k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed

Questions about Decision Navigator

What does Decision Navigator do?

Guide stuck or overwhelmed users through targeted branching questions until they reach concrete next steps. Decision Navigator is an agent skill from sickn33/agentic-awesome-skills. Guide stuck or overwhelmed users through targeted branching questions until they reach concrete next steps.

How do I install Decision Navigator in Claude Code?

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

How do I install Decision Navigator in Codex?

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

Can I use Decision Navigator 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 sickn33/agentic-awesome-skills --skill decision-navigator -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-navigator, .gemini/skills/decision-navigator, .github/skills/decision-navigator and .opencode/skills/decision-navigator in your project.

What does Decision Navigator need to run?

SKILL.md names no scripts, command-line tools or credentials: Decision Navigator is instructions for the agent only. Our summary lists: Docker.

Does Decision Navigator 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 Navigator 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 Navigator use?

Decision Navigator 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 Navigator use?

About 2.4k tokens (SKILL.md is roughly 9.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Decision Navigator?

Skills that share tags, products or a category with Decision Navigator: Branches (redis/RedisInsight, 8.9k stars), Conventional Branch (github/awesome-copilot, 40k stars), Finishing a Development Branch (obra/superpowers, 297k stars) and Git Branch Naming (makeplane/plane, 61k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Decision Navigator?

sickn33 (a GitHub user) maintains it in sickn33/agentic-awesome-skills, which has 47,379 GitHub stars. The repository holds 1,493 skills in this directory. The repository was last updated on October 9, 2026.

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