How do I install the Gt Nav skill?

Run npx skillmds@latest add kinginyellows/gt-nav in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Gt Nav safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gt Nav?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gt Nav free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gt Nav?

kinginyellows (@kinginyellows) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gt Nav by kinginyellows — Agent Skill

Name: Gt Nav
Author: kinginyellows

Gt Nav

Visualize your Graphite stack and navigate between its branches. Use when user says "show my stack", "where am I in the stack", "go up/down a branch", or "checkout the top of the stack". Not for restacking, syncing, or cleanup — use the gt-sync or gt-cleanup skill.

File contents

What It Does

Visualizes your current Graphite stack and lets you navigate between branches — jump to the top or bottom, move up/down, or check out a specific branch by name. Optionally shows PR status for each branch in the stack.

When to Use

User says "show my stack", "where am I in the stack", "go up/down a branch", or "checkout the top of the stack".
Not for restacking, syncing, or cleanup — use the gt-sync or gt-cleanup skills instead.

Usage

Optional arguments:

--pr — Also show PR status for each branch
--top — Jump directly to the top of the stack
--bottom — Jump directly to the bottom of the stack

The argument text provided after the skill name (if any) is available as context for this invocation.

Phase 1: Visualize Stack

1. Show Full Stack

gt log

2. Show Current Position

echo "Current branch: $(git branch --show-current)"

3. Show PR Status (if `--pr` is provided)

gt pr

4. Handle Direct Navigation Arguments

If --top was passed:

gt top
echo "Jumped to top: $(git branch --show-current)"
gt log short

Then show the stack and exit.

If --bottom was passed:

gt bottom
gt log short

Then show the stack and exit.

Phase 2: Interactive Navigation

If no direct navigation argument was given, present options using AskUserQuestion. (AskUserQuestion is a Claude Code tool — on Codex, present the same options as a numbered list in your reply and wait for the user's answer; this applies to every AskUserQuestion mention in this skill.)

Ask: "Where do you want to go?"

Options:

Go up — Move to the child branch (gt up)
Go down — Move to the parent branch (gt down)
Jump to top — Move to the top of the stack (gt top)
Jump to bottom — Move to the bottom of the stack (gt bottom)

The user can also type a specific branch name via the "Other" option.

Execute Navigation

Based on the user's choice:

Go up:

gt up

Go down:

gt down

Jump to top:

gt top

Jump to bottom:

gt bottom

Specific branch (from "Other" input):

gt checkout -- "<branch-name>"

Show New Position

After navigating:

echo "Now on: $(git branch --show-current)"
gt log short

Success Criteria

Stack is clearly visualized with current position highlighted
PR status shown for context
User can navigate up/down/top/bottom or to a specific branch
New position confirmed after navigation

---name: gt-navdescription: Visualize your Graphite stack and navigate between its branches. Use when user says "show my stack", "where am I in the stack", "go up/down a branch", or "checkout the top of the stack". Not for restacking, syncing, or cleanup — use the gt-sync or gt-cleanup skill.---## What It DoesVisualizes your current Graphite stack and lets you navigate betweenbranches — jump to the top or bottom, move up/down, or check out aspecific branch by name. Optionally shows PR status for each branch inthe stack.## When to Use- User says "show my stack", "where am I in the stack", "go up/down a branch", or "checkout the top of the stack".- Not for restacking, syncing, or cleanup — use the `gt-sync` or `gt-cleanup` skills instead.## UsageOptional arguments:- `--pr` — Also show PR status for each branch- `--top` — Jump directly to the top of the stack- `--bottom` — Jump directly to the bottom of the stackThe argument text provided after the skill name (if any) is available ascontext for this invocation.### Phase 1: Visualize Stack#### 1. Show Full Stack```bashgt log```#### 2. Show Current Position```bashecho "Current branch: $(git branch --show-current)"```#### 3. Show PR Status (if `--pr` is provided)```bashgt pr```#### 4. Handle Direct Navigation ArgumentsIf `--top` was passed:```bashgt topecho "Jumped to top: $(git branch --show-current)"gt log short```Then show the stack and exit.If `--bottom` was passed:```bashgt bottomgt log short```Then show the stack and exit.### Phase 2: Interactive NavigationIf no direct navigation argument was given, present options usingAskUserQuestion. (`AskUserQuestion` is a Claude Code tool — on Codex, presentthe same options as a numbered list in your reply and wait for the user'sanswer; this applies to every AskUserQuestion mention in this skill.)Ask: "Where do you want to go?"Options:- **Go up** — Move to the child branch (`gt up`)- **Go down** — Move to the parent branch (`gt down`)- **Jump to top** — Move to the top of the stack (`gt top`)- **Jump to bottom** — Move to the bottom of the stack (`gt bottom`)The user can also type a specific branch name via the "Other" option.#### Execute NavigationBased on the user's choice:**Go up:**```bashgt up```**Go down:**```bashgt down```**Jump to top:**```bashgt top```**Jump to bottom:**```bashgt bottom```**Specific branch (from "Other" input):**```bashgt checkout -- "<branch-name>"```#### Show New PositionAfter navigating:```bashecho "Now on: $(git branch --show-current)"gt log short```### Success Criteria- Stack is clearly visualized with current position highlighted- PR status shown for context- User can navigate up/down/top/bottom or to a specific branch- New position confirmed after navigation

Frequently asked questions