Agent skill

Stacklit Navigator

by glincker in glincker/stacklit

Use stacklit.json to navigate codebases without burning tokens on file exploration

MITAuto-check passedAgent Workflows

Install Stacklit Navigator

skills CLI
$ npx skills add glincker/stacklit --skill stacklit-navigator -a claude-code

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

GitHub CLI
$ gh skill install glincker/stacklit stacklit-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).

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

Facts

Skill name
stacklit-navigator
GitHub stars
106
Token cost
~678 tokens
SKILL.md length
352 words
Files
170 (incl. assets)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Use stacklit.json to navigate codebases without burning tokens on file exploration

  • Tasks that involve Codebase knowledge for agents
  • SKILL.md covers When to use, Reading the index, How to use each section and What not to do, plus 2 more sections
  • Runs Go and JavaScript scripts from its folder

What it does

Stacklit Navigator is an agent skill from glincker/stacklit. Use stacklit.json to navigate codebases without burning tokens on file exploration

Its SKILL.md is about 680 tokens, which your agent loads only when the skill is triggered. The skill folder holds 173 other files, including assets (for example `.github/workflows/ci.yml`, `.github/workflows/release.yml` and `.github/workflows/stacklit-index.yml`).

It sits in Agent Workflows, covering Codebase knowledge for agents. It works with Model Context Protocol and Go. The repository describes itself as: One command gives AI agents instant codebase context. ~250 tokens replaces 50,000+ tokens of exploration. Auto-configures Claude Code, Cursor, Aider. The licence is MIT.

When your agent uses it

  • Tasks that involve Codebase knowledge for agents

Example prompts

  • “/stacklit-navigator”

Requirements

  • Node.js

What it can do on your machine

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

    Ships script files (Go and JavaScript, from the files we listed), which the agent can run.

    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

Stacklit Navigator loads about 678 tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 352 words of instructions outside code blocks.

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

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 glincker/stacklit at commit 6aa0176, republished under its MIT licence (© glincker). 352 words, ~678 tokens.

Download SKILL.mdSave it as .claude/skills/stacklit-navigator/SKILL.md (or your agent's skills folder). This skill also uses 169 other files; get the full folder from GitHub.
name
stacklit-navigator
description
Use stacklit.json to navigate codebases without burning tokens on file exploration

When to use

At the start of any session on a repo that has stacklit.json at the root. Read it before you read any source files.

Reading the index

bash
# Check if index exists
cat stacklit.json | head -5

The file has these sections:

  • project -- repo name, type (single/monorepo), workspaces
  • tech -- primary language, language breakdown, frameworks
  • modules -- the map: each module's purpose, files, exports, dependencies, activity level
  • dependencies.edges -- import relationships between modules
  • dependencies.most_depended -- the modules everything depends on (touch carefully)
  • hints -- where to add features, how to run tests, env vars to set

How to use each section

Finding code: Look up the module in modules by name. The purpose field tells you what it does. The file_list tells you exactly which files to read. Skip everything else.

Understanding structure: Check depends_on and depended_by to see how a module connects to the rest. If you need to change something in src/auth, check depended_by to know what might break.

Knowing what changed recently: The activity field (high/medium/low) tells you how actively a module is being worked on. git.hot_files lists the most-changed files in the last 90 days.

Adding a feature: Read hints.add_feature first. It tells you which directory to create files in and which files to update.

Running tests: Check hints.test_command.

Show full SKILL.md (152 more words)Show less

What not to do

  • Do not grep across all files when modules tells you which module to look in
  • Do not read entire directories to understand the codebase
  • Do not re-explore the same repo every session. The index persists across sessions.
  • Do not ignore most_depended when planning changes. Those modules have the widest blast radius.

Using the MCP server

If stacklit serve is running as an MCP server, use these tools instead of reading the file:

  • get_overview -- full project summary (call this first)
  • get_module("src/auth") -- detailed info on one module
  • find_module("auth") -- search modules by name
  • get_dependencies("src/auth") -- what it imports and what imports it
  • get_hot_files -- most-changed files (90 days)
  • get_hints -- conventions, test commands, env vars

One get_overview call replaces reading 5-10 files to build context.

Keeping the index fresh

If you have made significant structural changes (new modules, moved files, changed dependencies):

bash
stacklit generate

Use stacklit diff to check if the index is stale before regenerating.

© glincker, 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 169 other files (assets) in the repository root of glincker/stacklit.

  • SKILL.md
  • .github/workflows/ci.yml
  • .github/workflows/release.yml
  • .github/workflows/stacklit-index.yml
  • .gitignore
  • .goreleaser.yml
  • COMPARISON.md
  • DEPENDENCIES.md
  • LICENSE
  • Makefile
  • README.md
  • USAGE.md
  • action/action.yml
  • assets/embed.go
  • assets/lang-icons.js
  • assets/template.html
  • cmd
  • … and 153 more

Open the folder on GitHubat commit 6aa0176

Compare with similar skills

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

Stacklit Navigator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Stacklit Navigator this skillglincker/stacklit106—~678Automated safety check: PassMIT
Local DevSmilyOrg/photofield608—~2.4kAutomated safety check: PassMIT
MCP Code Search Tool SelectionContext-Engine-AI/Context-Engine402—~1.3kAutomated safety check: PassMIT
Context-Engine Code SearchContext-Engine-AI/Context-Engine402—~14kAutomated safety check: PassMIT
Codebase SearchHelweg/open-codebase-index217—~1.3kAutomated safety check: PassMIT
Easyeda Repo Maintainzhoushoujianwork/easyeda-agent601—~360Automated safety check: PassCustom licence

Similar skills

  • Local Dev

    SmilyOrg/photofield

    Run, test, and debug the photofield server locally. An agent skill from SmilyOrg/photofield.

    608 GitHub stars~2.4k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • MCP Code Search Tool Selection

    Context-Engine-AI/Context-Engine

    Rules for choosing Qdrant-Indexer semantic search over grep or file reads when exploring code, debugging or asking where and why questions.

    402 GitHub stars~1.3k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed
  • Context-Engine Code Search

    Context-Engine-AI/Context-Engine

    Searches a codebase with hybrid semantic and lexical retrieval plus neural reranking through MCP tools, for finding implementations and grounded answers.

    402 GitHub stars~14k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed
  • Codebase Search

    Helweg/open-codebase-index

    Chooses the right retrieval tool for code questions: compact context for unfamiliar repos, direct lookup for known symbols, call graphs for relationships and grep for exhaustive matches.

    217 GitHub stars~1.3k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Easyeda Repo Maintain

    zhoushoujianwork/easyeda-agent

    维护 easyeda-agent 仓库的 Skill、CLI、daemon、connector 与文档,补回可复用经验并组织验证和 Git 贡献。

    601 GitHub stars~360 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Codebase Search Workflow

    Helweg/open-codebase-index

    Directs an agent to use a local codebase index for repository orientation, definition lookups, call graphs and semantic search before turning to web lookups.

    217 GitHub stars~822 tokensUpdated today
    Agent WorkflowsAuto-check passed

Questions about Stacklit Navigator

What does Stacklit Navigator do?

Use stacklit.json to navigate codebases without burning tokens on file exploration. Stacklit Navigator is an agent skill from glincker/stacklit.

When should I use Stacklit Navigator?

Stacklit Navigator fits situations like: tasks that involve Codebase knowledge for agents.

How do I install Stacklit Navigator in Claude Code?

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

How do I install Stacklit Navigator in Codex?

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

Can I use Stacklit 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 glincker/stacklit --skill stacklit-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/stacklit-navigator, .gemini/skills/stacklit-navigator, .github/skills/stacklit-navigator and .opencode/skills/stacklit-navigator in your project.

What does Stacklit Navigator need to run?

Going by SKILL.md and its folder, Stacklit Navigator needs Go and JavaScript for the scripts in its folder. Our summary lists: Node.js.

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

Stacklit Navigator is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Stacklit Navigator use?

About 678 tokens (SKILL.md is roughly 2.7k 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 Stacklit Navigator?

Skills that share tags, products or a category with Stacklit Navigator: Local Dev (SmilyOrg/photofield, 608 stars), MCP Code Search Tool Selection (Context-Engine-AI/Context-Engine, 402 stars), Context-Engine Code Search (Context-Engine-AI/Context-Engine, 402 stars) and Codebase Search (Helweg/open-codebase-index, 217 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Stacklit Navigator?

glincker (a GitHub organization) maintains it in glincker/stacklit, which has 106 GitHub stars. The repository was last updated on May 7, 2026.

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