Agent skill

Code Navigation

by ozontech in ozontech/seq-db

How to navigate and explore Go code in this repo. An agent skill from ozontech/seq-db.

Apache-2.0Auto-check: notesDevelopment

Install Code Navigation

skills CLI
$ npx skills add ozontech/seq-db --skill code-navigation -a claude-code

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

GitHub CLI
$ gh skill install ozontech/seq-db code-navigation --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/ozontech/seq-db.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/code-navigation .claude/skills/code-navigation && 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
code-navigation
GitHub stars
133
Token cost
~837 tokens
SKILL.md length
386 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
Apache-2.0

At a glance

How to navigate and explore Go code in this repo. An agent skill from ozontech/seq-db.

  • Works in 3 steps: Bootstrap without grepping. The two… → Navigate from that position: definition… → Read the location(s) gopls returns to…
  • Tasks that involve Codebase onboarding
  • SKILL.md covers Map the question to a gopls…, Typical flow, When Grep/Read are the right… and Notes
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Code Navigation is an agent skill from ozontech/seq-db. How to navigate and explore Go code in this repo. Use the gopls CLI (definition, references, implementation, callhierarchy, symbols, workspacesymbol) as the PRIMARY way to answer "where is this defined / used / implemented / called". Fall back to Grep/Read only when gopls cannot answer. Invoke when exploring the codebase, tracing a symbol, or answering a "where/who/what-calls" question about Go code.

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

It sits in Development, covering Codebase onboarding. The repository describes itself as: seq-db is a scalable and high-performance database designed for storing and querying logs efficiently. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Codebase onboarding

Example prompts

  • “where is this defined / used / implemented / called”
  • “where/who/what-calls”
  • “/code-navigation”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Bootstrap without grepping. The two commands that take a name/file
  2. Navigate from that position: definition / references /
  3. Read the location(s) gopls returns to see the actual code. Finding where

What it can do on your machine

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

Code Navigation loads about 837 tokens when it runs. Until then it costs about 106 tokens; SKILL.md has 386 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:47
    o files**: YAML/proto/Makefile/markdown/`.env` → `Grep`/`Read`.

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 ozontech/seq-db at commit 70af159, republished under its Apache-2.0 licence (© ozontech). 386 words, ~837 tokens.

Download SKILL.mdSave it as .claude/skills/code-navigation/SKILL.md (or your agent's skills folder).
name
code-navigation
description
How to navigate and explore Go code in this repo. Use the `gopls` CLI (definition, references, implementation, call_hierarchy, symbols, workspace_symbol) as the PRIMARY way to answer "where is this defined / used / implemented / called". Fall back to Grep/Read only when gopls cannot answer. Invoke when exploring the codebase, tracing a symbol, or answering a "where/who/what-calls" question about Go code.

code-navigation

For Go code, navigate with gopls first. It resolves symbols semantically — across packages, through interfaces, following the type system — which text search cannot. Grep/Read are the fallback, not the default: reach for them only when gopls genuinely can't answer (see below). gopls is allowlisted, so these run without a prompt.

Map the question to a gopls command

Positions are <file>:<line>:<col>, 1-based, with col pointing at the identifier (or <file>:#<byteoffset>).

You want to…Command
Find a symbol by name when you don't know where it livesgopls workspace_symbol <query>
List what's declared in a file (outline)gopls symbols <file>
Jump to where a symbol is definedgopls definition <file>:<line>:<col>
See a type/func's signature + docgopls definition -markdown <pos>
Find every use of a symbolgopls references <pos> (-d to include the declaration)
Find implementations of an interface (or interfaces a type satisfies)gopls implementation <pos>
See callers/callees of a functiongopls call_hierarchy <pos>

Add -json (on definition) when you want machine-readable output to parse.

Typical flow

  1. Bootstrap without grepping. The two commands that take a name/file instead of a position are your entry points:
    • Know the name only → gopls workspace_symbol MetaData → gives the declaration's file:line:col.
    • Know the file → gopls symbols path/to/file.go → outline with positions.
  2. Navigate from that position: definition / references / implementation / call_hierarchy.
  3. Read the location(s) gopls returns to see the actual code. Finding where is gopls's job; viewing the span is Read's.
Show full SKILL.md (151 more words)Show less

When Grep/Read are the right tool (gopls insufficient)

  • Non-symbol text: string literals, log messages, error text, struct tags, config keys, metric names, magic constants → Grep.
  • Non-Go files: YAML/proto/Makefile/markdown/.env → Grep/Read.
  • Generated or build-excluded code gopls doesn't resolve (e.g. files behind build tags it didn't load).
  • gopls returned nothing for a symbol you're sure exists → confirm with Grep, then retry.
  • Reading a known span: once a location is in hand, Read it directly.

Notes

  • Point col at the start of the identifier, not the line start, or the command resolves the wrong (or no) symbol.
  • This is a Go-navigation policy; for text-shaped searches across the tree (any language) Grep remains correct — the rule is "don't grep for something gopls can resolve semantically," not "never grep".
  • Equivalent structured alternative: the harness LSP tool (same gopls engine, JSON results, adds split incoming/outgoing calls + hover) — use it instead if you prefer structured output; results are identical.

© ozontech, Apache-2.0. 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 .claude/skills/code-navigation of ozontech/seq-db.

Open the folder on GitHubat commit 70af159

Compare with similar skills

Code Navigation 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.

Code Navigation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Code Navigation this skillozontech/seq-db133—~837Automated safety check: NotesApache-2.0
Codebase Knowledge Graph Q&AEgonex-AI/Understand-Anything85k1 repos~1.2kAutomated safety check: PassMIT
Understand ExplainEgonex-AI/Understand-Anything85k1 repos~1.3kAutomated safety check: PassMIT
Repomix Codebase Exploreryamadashy/repomix29k1 repos~2.7kAutomated safety check: PassMIT
Project Onboarding Guide from Knowledge GraphEgonex-AI/Understand-Anything85k—~1.2kAutomated safety check: PassMIT
Deepwiki Rssopaco/deepwiki-rs3.1k—~748Automated safety check: PassMIT

Similar skills

  • Codebase Knowledge Graph Q&A

    Egonex-AI/Understand-Anything

    Answers questions about a codebase by searching a prebuilt knowledge graph of its files, functions, classes and dependencies, not by rereading every source file.

    85k GitHub starsUsed in 1 repo~1.2k tokens
    DevelopmentAuto-check passed
  • Understand Explain

    Egonex-AI/Understand-Anything

    Gives an in-depth explanation of one file, function or module by reading the project's knowledge graph and checking that the graph is still fresh.

    85k GitHub starsUsed in 1 repo~1.3k tokens
    DevelopmentAuto-check passed
  • Repomix Codebase Explorer

    yamadashy/repomix

    Packs a local or remote repository into a single AI-friendly file with the Repomix CLI, then reads and searches that output to explain structure, find patterns or report metrics.

    29k GitHub starsUsed in 1 repo~2.7k tokens
    DevelopmentAuto-check passed
  • Writes an onboarding guide for new team members from a project's existing knowledge graph, after checking that the graph still matches the current commit.

    85k GitHub stars~1.2k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Deepwiki Rs

    sopaco/deepwiki-rs

    AI-powered Rust documentation generation engine for comprehensive codebase analysis, C4 architecture diagrams, and automated technical documentation.

    3.1k GitHub stars~748 tokensUpdated 23 days ago
    DevelopmentAuto-check passed
  • GitDiagram Repository Overview

    ahmedkhaleel2004/gitdiagram

    Explains the architecture of a public GitHub repository through GitDiagram: how the code is organized, the main components with paths, and a Mermaid diagram.

    18k GitHub stars~427 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from ozontech/seq-db

  • Perf Loop

    ozontech/seq-db

    Autonomous performance-optimization loop for seq-db driven by seqbazooka.

    133 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Perf Architect

    ozontech/seq-db

    Design-level performance review for seq-db — proposes data-structure, algorithmic, memory-layout, and architectural alternatives for a hot path, each with reasoning and a validation plan.

    133 GitHub stars~581 tokensUpdated yesterday
    Auto-check passed
  • Code Review

    ozontech/seq-db

    Review the current code changes (branch diff vs main, a commit range, or a PR) for seq-db.

    133 GitHub stars~411 tokensUpdated yesterday
    Auto-check passed
  • Perf Analyze

    ozontech/seq-db

    One-shot profile analysis for seq-db — turns pprof profiles (and optional metrics/report) into a ranked list of concrete, profile-grounded optimization opportunities for the code.

    133 GitHub stars~422 tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Code Navigation

What does Code Navigation do?

How to navigate and explore Go code in this repo. An agent skill from ozontech/seq-db. Code Navigation is an agent skill from ozontech/seq-db. How to navigate and explore Go code in this repo.

When should I use Code Navigation?

Code Navigation fits situations like: tasks that involve Codebase onboarding.

How do I install Code Navigation in Claude Code?

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

How do I install Code Navigation in Codex?

Run `npx skills add ozontech/seq-db --skill code-navigation -a codex`. Or copy the skill folder (.claude/skills/code-navigation in ozontech/seq-db) into .agents/skills/code-navigation in your project. Codex loads it when a task matches its description.

Can I use Code Navigation 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 ozontech/seq-db --skill code-navigation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/code-navigation, .gemini/skills/code-navigation, .github/skills/code-navigation and .opencode/skills/code-navigation in your project.

What does Code Navigation need to run?

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

Does Code Navigation 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 Code Navigation safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Code Navigation use?

Code Navigation is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Code Navigation use?

About 837 tokens (SKILL.md is roughly 3.3k 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 Code Navigation?

Skills that share tags, products or a category with Code Navigation: Codebase Knowledge Graph Q&A (Egonex-AI/Understand-Anything, 85k stars), Understand Explain (Egonex-AI/Understand-Anything, 85k stars), Repomix Codebase Explorer (yamadashy/repomix, 29k stars) and Project Onboarding Guide from Knowledge Graph (Egonex-AI/Understand-Anything, 85k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Code Navigation?

ozontech (a GitHub organization) maintains it in ozontech/seq-db, which has 133 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 6, 2026.

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