ask-navigator

ask-navigator is a skill for Claude Code from Yeachan-Heo/oh-my-claudecode. It costs 0 tokens per session (3,084 once invoked), scanned A, original, MIT.

A planning workflow for unclear projects that turns unknowns into decision tickets on the repository's issue tracker. It works through those decisions with the human and produces a brief for later implementation rather than building the software itself.

In plain words
What is it for?
Mapping an uncertain effort, recording decisions, resolving them one session at a time, and preparing a mission brief.
Why use it?
It gives a project a path forward when its destination and first decisions are not yet clear.

Skill for Claude Code

Written for Claude Code: argument-hint in frontmatter. Also seen: mentions subagents.

Part of the oh-my-claudecode plugin — 37 skills, 21 commands, 19 agents, 11 hooks, 1 MCP server shipped together

Good fit Mapping an uncertain effort, recording decisions, resolving them one session at a time, and preparing a mission brief.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/yeachan-heo/oh-my-claudecode/ask-navigator
About the project

Oh My Claude Code is a multi-agent orchestration system for Claude Code, coordinating specialized agents, commands, skills, hooks, and workflows. It is designed for developers who want Claude Code to handle coding tasks through coordinated agent roles. Catalogue entries are components of its Claude Code workflow, including agents, commands, skills, hooks, instructions, MCP configuration, and a plugin.

Yeachan-Heo/oh-my-claudecode · 39,083 stars · on GitHub · oh-my-claudecode.dev

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Yeachan-Heo/oh-my-claudecode --skill ask-navigator
Clone the repo
git clone --depth 1 https://github.com/Yeachan-Heo/oh-my-claudecode

Made for: Claude Code.

Or install oh-my-claudecode, the plugin that ships this one along with the rest of its 37 skills, 21 commands, 19 agents, 11 hooks, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ask-navigator

README.md
[![agentmods](https://agentmods.dev/badge/skills/yeachan-heo/oh-my-claudecode/ask-navigator/github.svg)](https://agentmods.dev/skills/yeachan-heo/oh-my-claudecode/ask-navigator)
Your own site
<a href="https://agentmods.dev/skills/yeachan-heo/oh-my-claudecode/ask-navigator"><img src="https://agentmods.dev/badge/skills/yeachan-heo/oh-my-claudecode/ask-navigator/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for ask-navigator

Your own site · 80×15
<a href="https://agentmods.dev/skills/yeachan-heo/oh-my-claudecode/ask-navigator"><img src="https://agentmods.dev/badge/skills/yeachan-heo/oh-my-claudecode/ask-navigator.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,084 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00000 $0.03084
Opus 5 $0.00000 $0.01542
Sonnet 5 $0.00000 $0.00617
Haiku 4.5 $0.00000 $0.00308

Measured 5d ago against content hash d534aef9d4ba, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

ask-navigator scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

skills/ask-navigator/SKILL.md · 128 lines

How it starts

The opening of the file, as written. The whole thing — 128 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Ask Navigator

Ask-navigator is the shipyard's navigator: it takes an effort wrapped in fog — the way from here to the destination isn't visible yet — and charts it as a map of decision tickets on the repo's issue tracker, then works the frontier one ticket per session until the route is clear. It produces decisions, never deliverables: when the way is clear it hands off, it doesn't build. Delivery belongs to /oh-my-claudecode:launch.

The role contract. The captain (the human) signs the destination (W1) and the chart (W2); the navigator drafts everything else and never answers a question that belongs to the captain — a grilling session in which the agent answers its own questions has broken the role, not just the process. Facts are the navigator's job; decisions are the captain's.

Fog test. An effort has fog when either answer is no:

  1. Q1 — Can the destination be stated in one sentence: the spec, decision, or change this effort is finding its way to?
  2. Q2 — Can the first three decisions be stated precisely right now, even though none of them can be answered yet?

Both yes → no map is needed; run /oh-my-claudecode:launch (its fog gate sends efforts here only when an answer is no). Either no → chart first. ask-navigator is also reachable directly: invoke it with a loose idea, with residual questions handed over by launch's fog gate, or with no argument to continue the open map.

Map home

The map is a single issue labelled navigator:map on the repo's issue tracker; its decision tickets are child issues of the map. The tracker should have been recorded by /oh-my-claudecode:drydock; if none was recorded, ask once (GitHub / GitLab / local markdown) and remember the answer inside the map's Notes.

  • Tracker-backed (GitHub, GitLab, or recorded tracker): one map issue, child issues per ticket, native blocking/sub-issue relationships. Concurrent sessions and the tracker's own UI render the frontier — the map lives where humans already look. Create the navigator:map label if the tracker doesn't have it yet; ticket types live in the ticket body, not in labels.
  • Local markdown fallback: .omc/wayfinder/<map-slug>/map.md plus decisions/NN-<slug>.md, one file per ticket, numbered in dependency order. Local mode has no concurrent-claim guarantee: it is single-driver by convention, stated once in the map's Notes.

Read the full file on GitHub · 128 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 128 lines · 0 tokens per session scan A d534aef9d4ba

Subscribe to this mod's changes

ask-navigator is a skill published in the GitHub repository Yeachan-Heo/oh-my-claudecode (39,083 stars, last pushed yesterday), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 3,084 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-06.

Related

Other skills, from other repositories

inbound-triage

Triage raw human-channel input pasted directly into the session (chat exports, email threads, PR comments, meeting notes) — or dropped as files in a project inbox — into typed, deduplicated, decision-ready items with numbered recommendations. Strictly selection-gated — nothing dispatches without an explicit operator…

EZotoff/ez-omo-config · 69 tokens

worktrees

Manage Git worktrees as OMO safe isolated coding lanes for complex, risky, or parallel work.

alvinunreal/oh-my-opencode-slim · 23 tokens

verification-planning

Verification planning for non-trivial coding work. Use before implementing a feature, bug fix, refactor, cross-system change, or high-confidence behavior change that needs a credible project-specific evidence path.

alvinunreal/oh-my-opencode-slim · 43 tokens

loop-engineering

Loop engineering runtime Grill + Monitor.

alvinunreal/oh-my-opencode-slim · 10 tokens

moai-workflow-worktree

Git worktree management for parallel SPEC development with isolated workspaces, automatic branch registration, and seamless MoAI-ADK integration. Use when setting up parallel development environments.

modu-ai/moai-adk · 41 tokens

moai-kanban-foreman

One unattended kanban foreman iteration: watch the backlog queue, dispatch the next operator-picked card to an isolated worker, collect completion evidence on read (not on claims), and report. This is the body the project's loop.md driver invokes each iteration of a bare /loop; it can also be invoked directly to test…

modu-ai/moai-adk · 76 tokens