New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Codebase Nav

by ncatbot in ncatbot/NcatBot

导航 NcatBot 代码库：定位代码、理解模块、查阅文档。文档优先，非必要不读代码，通过问题分类 → 文档查阅 → 精准定位的流程找到目标。Use when: 定位代码、找代码、问题定位、代码在哪、哪个模块、哪个文件、issue 分析、bug 在哪、报错定位、功能在哪实现、架构理解、模块交互。

Custom licenceAuto-check passed

Install Codebase Nav

skills CLI
$ npx skills add ncatbot/NcatBot --skill codebase-nav -a claude-code

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

GitHub CLI
$ gh skill install ncatbot/NcatBot codebase-nav --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/ncatbot/NcatBot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/codebase-nav .claude/skills/codebase-nav && 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
codebase-nav
GitHub stars
115
Token cost
~253 tokens
SKILL.md length
66 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
Custom licence

At a glance

导航 NcatBot 代码库：定位代码、理解模块、查阅文档。文档优先，非必要不读代码，通过问题分类 → 文档查阅 → 精准定位的流程找到目标。Use when: 定位代码、找代码、问题定位、代码在哪、哪个模块、哪个文件、issue 分析、bug 在哪、报错定位、功能在哪实现、架构理解、模块交互。

  • Works in 3 steps: 使用 doc-nav 的症状速查表，确定涉及的模块和应读的文档 → 阅读文档，理解预期行为 → 如需确认实际实现或定位 bug 行号，使用 code-nav 锁定具体文件
  • : 定位代码、找代码、问题定位、代码在哪、哪个模块、哪个文件、issue 分析、bug 在哪、报错定位、功能在哪实现、架构理解、模块交互
  • SKILL.md covers 完整工作流, 路由决策, 典型流程 and 核心原则
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Codebase Nav is an agent skill from ncatbot/NcatBot. 导航 NcatBot 代码库：定位代码、理解模块、查阅文档。文档优先，非必要不读代码，通过问题分类 → 文档查阅 → 精准定位的流程找到目标。Use when: 定位代码、找代码、问题定位、代码在哪、哪个模块、哪个文件、issue 分析、bug 在哪、报错定位、功能在哪实现、架构理解、模块交互。

Its SKILL.md is about 250 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: NapCat Python SDK；快速开发你的 QQ 机器人.

When your agent uses it

  • : 定位代码、找代码、问题定位、代码在哪、哪个模块、哪个文件、issue 分析、bug 在哪、报错定位、功能在哪实现、架构理解、模块交互

Example prompts

  • “/codebase-nav”

Workflow steps

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

  1. 使用 doc-nav 的症状速查表，确定涉及的模块和应读的文档
  2. 阅读文档，理解预期行为
  3. 如需确认实际实现或定位 bug 行号，使用 code-nav 锁定具体文件

What it can do on your machine

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

Codebase Nav loads about 253 tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 66 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 66 words (~253 tokens).

name
codebase-nav

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/codebase-nav of ncatbot/NcatBot.

Open the folder on GitHubat commit c26300a

Compare with similar skills

Codebase Nav 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.

Codebase Nav compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Codebase Nav this skillncatbot/NcatBot115—~253Automated safety check: PassCustom licence
Nav Startqf-studio/navigator354—~4.6kAutomated safety check: NotesMIT
Nav Compactqf-studio/navigator354—~2.1kAutomated safety check: NotesMIT
Nav Diagnoseqf-studio/navigator354—~2.4kAutomated safety check: NotesMIT
Nav Featuresqf-studio/navigator354—~3kAutomated safety check: NotesMIT
Nav Initqf-studio/navigator354—~3kAutomated safety check: NotesMIT

Similar skills

  • Nav Start

    qf-studio/navigator

    Load Navigator documentation navigator when starting development session, resuming work, or beginning new feature.

    354 GitHub stars~4.6k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes

  • Nav Compact

    qf-studio/navigator

    Clear conversation context while preserving knowledge via context marker.

    354 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check: notes

  • Nav Diagnose

    qf-studio/navigator

    Detect quality drops in AI output and prompt re-anchoring. An agent skill from qf-studio/navigator.

    354 GitHub stars~2.4k tokensUpdated yesterday
    Auto-check: notes

  • Nav Features

    qf-studio/navigator

    Show and toggle Navigator features. An agent skill from qf-studio/navigator.

    354 GitHub stars~3k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes

  • Nav Init

    qf-studio/navigator

    Initialize Navigator documentation structure in a project. An agent skill from qf-studio/navigator.

    354 GitHub stars~3k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes

  • Nav Loop

    qf-studio/navigator

    Run tasks until complete with structured completion signals.

    354 GitHub stars~4.4k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes

More from ncatbot/NcatBot

All 12 skills in this repo

  • Code Nav

    ncatbot/NcatBot

    定位 NcatBot 代码实现：锁定模块目录、找到关键类/函数、追踪调用链。当文档不够时才读代码，用搜索而非遍历。Use when: 找代码实现、哪个文件、哪个类、追踪调用链、定位 bug 行号、代码在哪、模块目录、源码定位。

    115 GitHub stars~460 tokensUpdated 3 days ago
    Auto-check passed

  • Docs Maintenance

    ncatbot/NcatBot

    维护 NcatBot 项目文档、示例、Skills 知识资产。编写/编辑文档、修复文档问题、文档结构规范审查。Use when: 写文档、改文档、新增文档、修复断链、修复索引、修复代码块标注、文档规范、文档模板、文档结构设计、docs maintenance。

    115 GitHub stars~722 tokensUpdated 3 days ago
    Auto-check passed

  • Docs Sync

    ncatbot/NcatBot

    整体/局部防腐检查：Docs 内部链接断裂、README 索引不同步、guide↔reference 内容不一致、examples 导入过时、Code↔Docs API 对齐。逐文件检查，最大化并发 subagent。Use when: docs 防腐、docs 链接、docs 断链、断链检查、docs 审计、docs audit、code docs 对齐、reference 过时、guide…

    115 GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check passed

  • Framework Usage

    ncatbot/NcatBot

    使用 NcatBot 框架开发 QQ 机器人或跨平台 Bot。当用户需要快速体验、创建插件、注册事件处理、发送消息、调用 Bot API、使用 Mixin/Hook、使用 CLI 工具、编写插件测试、或调试运行问题时触发此技能。Use when: 开发…

    115 GitHub stars~1.2k tokensUpdated 3 days ago
    Auto-check passed

  • Plugin Migration

    ncatbot/NcatBot

    将 NcatBot 4.4/4.5 版本插件迁移到 5.0。包括导入路径、注册方式、Config/Data API、事件类型、消息构造的全面映射。Use when: 迁移插件、升级插件、4 转 5、老版本、旧版本、migration、upgrade、plugin migration、版本升级。

    115 GitHub stars~1.2k tokensUpdated 3 days ago
    Auto-check passed

  • Release

    ncatbot/NcatBot

    发布 NcatBot 新版本到 PyPI 和 GitHub Release，或仅编排 Commit 推送到 main。从工作区变更编排 commit 到最终发布的全链路流程。Use when: 发版、release、发布、changelog、版本号、pick commits、挑选提交、release notes、编排 commit、push、推送。

    115 GitHub stars~513 tokensUpdated 3 days ago
    Auto-check passed

Questions about Codebase Nav

What does Codebase Nav do?

导航 NcatBot 代码库：定位代码、理解模块、查阅文档。文档优先，非必要不读代码，通过问题分类 → 文档查阅 → 精准定位的流程找到目标。Use when: 定位代码、找代码、问题定位、代码在哪、哪个模块、哪个文件、issue 分析、bug 在哪、报错定位、功能在哪实现、架构理解、模块交互。. Codebase Nav is an agent skill from ncatbot/NcatBot.

When should I use Codebase Nav?

Codebase Nav fits situations like: : 定位代码、找代码、问题定位、代码在哪、哪个模块、哪个文件、issue 分析、bug 在哪、报错定位、功能在哪实现、架构理解、模块交互.

How do I install Codebase Nav in Claude Code?

Run `npx skills add ncatbot/NcatBot --skill codebase-nav -a claude-code`. Or copy the skill folder (.agents/skills/codebase-nav in ncatbot/NcatBot) into .claude/skills/codebase-nav in your project. Claude Code loads it when a task matches its description.

How do I install Codebase Nav in Codex?

Run `npx skills add ncatbot/NcatBot --skill codebase-nav -a codex`. Or copy the skill folder (.agents/skills/codebase-nav in ncatbot/NcatBot) into .agents/skills/codebase-nav in your project. Codex loads it when a task matches its description.

Can I use Codebase Nav 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 ncatbot/NcatBot --skill codebase-nav -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/codebase-nav, .gemini/skills/codebase-nav, .github/skills/codebase-nav and .opencode/skills/codebase-nav in your project.

What does Codebase Nav need to run?

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

Does Codebase Nav 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 Codebase Nav 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 Codebase Nav use?

Codebase Nav has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Codebase Nav use?

About 253 tokens (SKILL.md is roughly 1k 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 Codebase Nav?

Skills that share tags, products or a category with Codebase Nav: Nav Start (qf-studio/navigator, 354 stars), Nav Compact (qf-studio/navigator, 354 stars), Nav Diagnose (qf-studio/navigator, 354 stars) and Nav Features (qf-studio/navigator, 354 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Codebase Nav?

ncatbot (a GitHub organization) maintains it in ncatbot/NcatBot, which has 115 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 4, 2026.

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