Official agent skill

Gitnexus Debugging

by aws-samples in aws-samples/sample-kolya-br-proxy

A skill your agent uses when the user is debugging a bug, tracing an error, or asking why something fails.

OfficialMIT-0Auto-check passedDevelopment

Install Gitnexus Debugging

skills CLI
$ npx skills add aws-samples/sample-kolya-br-proxy --skill gitnexus-debugging -a claude-code

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

GitHub CLI
$ gh skill install aws-samples/sample-kolya-br-proxy gitnexus-debugging --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/aws-samples/sample-kolya-br-proxy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/gitnexus/gitnexus-debugging .claude/skills/gitnexus-debugging && 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
gitnexus-debugging
GitHub stars
106
Used in
11 other repos
Token cost
~780 tokens
SKILL.md length
122 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
MIT-0

At a glance

A skill your agent uses when the user is debugging a bug, tracing an error, or asking why something fails.

  • The user is debugging a bug
  • SKILL.md covers When to Use, Workflow, Checklist and Debugging Patterns, plus 2 more sections
  • Calls npx
  • Tracing an error

What it does

Gitnexus Debugging is an agent skill from aws-samples/sample-kolya-br-proxy, published by the product's own GitHub organization. Use when the user is debugging a bug, tracing an error, or asking why something fails. Examples: "Why is X failing?", "Where does this error come from?", "Trace this bug"

Its SKILL.md is about 780 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 Debugging. The licence is MIT-0.

When your agent uses it

  • The user is debugging a bug
  • Tracing an error
  • Asking why something fails

Example prompts

  • “Why is X failing?”
  • “Where does this error come from?”
  • “Trace this bug”
  • “/gitnexus-debugging”

Requirements

  • Node.js

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    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

Gitnexus Debugging loads about 780 tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 122 words of instructions outside code blocks.

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

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 aws-samples/sample-kolya-br-proxy at commit 9c3dcee, republished under its MIT-0 licence (© aws-samples). 122 words, ~780 tokens.

Download SKILL.mdSave it as .claude/skills/gitnexus-debugging/SKILL.md (or your agent's skills folder).
name
gitnexus-debugging
description
Use when the user is debugging a bug, tracing an error, or asking why something fails. Examples: "Why is X failing?", "Where does this error come from?", "Trace this bug"

Debugging with GitNexus

When to Use

  • "Why is this function failing?"
  • "Trace where this error comes from"
  • "Who calls this method?"
  • "This endpoint returns 500"
  • Investigating bugs, errors, or unexpected behavior

Workflow

1. gitnexus_query({query: "<error or symptom>"})            → Find related execution flows
2. gitnexus_context({name: "<suspect>"})                    → See callers/callees/processes
3. READ gitnexus://repo/{name}/process/{name}                → Trace execution flow
4. gitnexus_cypher({query: "MATCH path..."})                 → Custom traces if needed

If "Index is stale" → run npx gitnexus analyze in terminal.

Checklist

- [ ] Understand the symptom (error message, unexpected behavior)
- [ ] gitnexus_query for error text or related code
- [ ] Identify the suspect function from returned processes
- [ ] gitnexus_context to see callers and callees
- [ ] Trace execution flow via process resource if applicable
- [ ] gitnexus_cypher for custom call chain traces if needed
- [ ] Read source files to confirm root cause

Debugging Patterns

SymptomGitNexus Approach
Error messagegitnexus_query for error text → context on throw sites
Wrong return valuecontext on the function → trace callees for data flow
Intermittent failurecontext → look for external calls, async deps
Performance issuecontext → find symbols with many callers (hot paths)
Recent regressiondetect_changes to see what your changes affect

Tools

gitnexus_query — find code related to error:

gitnexus_query({query: "payment validation error"})
→ Processes: CheckoutFlow, ErrorHandling
→ Symbols: validatePayment, handlePaymentError, PaymentException

gitnexus_context — full context for a suspect:

gitnexus_context({name: "validatePayment"})
→ Incoming calls: processCheckout, webhookHandler
→ Outgoing calls: verifyCard, fetchRates (external API!)
→ Processes: CheckoutFlow (step 3/7)

gitnexus_cypher — custom call chain traces:

cypher
MATCH path = (a)-[:CodeRelation {type: 'CALLS'}*1..2]->(b:Function {name: "validatePayment"})
RETURN [n IN nodes(path) | n.name] AS chain

Example: "Payment endpoint returns 500 intermittently"

1. gitnexus_query({query: "payment error handling"})
   → Processes: CheckoutFlow, ErrorHandling
   → Symbols: validatePayment, handlePaymentError

2. gitnexus_context({name: "validatePayment"})
   → Outgoing calls: verifyCard, fetchRates (external API!)

3. READ gitnexus://repo/my-app/process/CheckoutFlow
   → Step 3: validatePayment → calls fetchRates (external)

4. Root cause: fetchRates calls external API without proper timeout

© aws-samples, MIT-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/gitnexus/gitnexus-debugging of aws-samples/sample-kolya-br-proxy.

Open the folder on GitHubat commit 9c3dcee

Used in 12 other repositories

We found 14 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 11 other GitHub owners. This page covers the copy in aws-samples/sample-kolya-br-proxy, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Gitnexus Debugging 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.

Gitnexus Debugging compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gitnexus Debugging this skillaws-samples/sample-kolya-br-proxy10611 repos~780Automated safety check: PassMIT-0
Trellis Session Insightmindfold-ai/Trellis15k4 repos~1.7kAutomated safety check: PassAGPL-3.0
Native Data FetchingCherryHQ/cherry-studio-app4k6 repos~2.9kAutomated safety check: NotesMIT
Aoti Debugpytorch/pytorch104k1 repos~1.7kAutomated safety check: PassCustom licence
Herdr Throwaway Reproductionherdrdev/herdr43k—~2.4kAutomated safety check: PassApache-2.0
Systematic Debuggingultralisp/ultralisp25851 repos~2.4kAutomated safety check: PassNone

Similar skills

  • Trellis Session Insight

    mindfold-ai/Trellis

    Reach into past AI conversation history through the trellis mem CLI.

    15k GitHub starsUsed in 4 repos~1.7k tokens
    DevelopmentAuto-check passed
  • Native Data Fetching

    CherryHQ/cherry-studio-app

    A skill your agent uses when implementing or debugging ANY network request, API call, or data fetching.

    4k GitHub starsUsed in 6 repos~2.9k tokens
    DevelopmentAuto-check: notes
  • Aoti Debug

    pytorch/pytorch

    Debug AOTInductor (AOTI) errors and crashes. An agent skill from pytorch/pytorch.

    104k GitHub starsUsed in 1 repo~1.7k tokens
    DevelopmentAuto-check passed
  • Runs a disposable, uniquely named Herdr session inside an existing one so runtime, pane, terminal or API bugs can be reproduced without touching the main session.

    43k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Systematic Debugging

    ultralisp/ultralisp

    A skill your agent uses when encountering any bug, test failure, or unexpected behavior, before proposing fixes

    258 GitHub starsUsed in 51 repos~2.4k tokens
    DevelopmentAuto-check passed
  • Decides whether an OpenLogi device problem on macOS is a privacy-permission (TCC) problem, using agent log lines, and says which identity needs which grant.

    23k GitHub stars~2.5k tokensUpdated 3 days ago
    DevelopmentAuto-check: notes

More from aws-samples/sample-kolya-br-proxy

  • Gitnexus Exploring

    aws-samples/sample-kolya-br-proxy

    Official

    A skill your agent uses when the user asks how code works, wants to understand architecture, trace execution flows, or explore unfamiliar parts of the codebase.

    106 GitHub starsUsed in 11 repos~749 tokens
    Auto-check passed
  • Gitnexus Impact Analysis

    aws-samples/sample-kolya-br-proxy

    Official

    A skill your agent uses when the user wants to know what will break if they change something, or needs safety analysis before editing code.

    106 GitHub starsUsed in 11 repos~723 tokens
    Auto-check passed
  • Gitnexus Refactoring

    aws-samples/sample-kolya-br-proxy

    Official

    A skill your agent uses when the user wants to rename, extract, split, move, or restructure code safely.

    106 GitHub starsUsed in 11 repos~1k tokens
    Auto-check passed
  • Gitnexus CLI

    aws-samples/sample-kolya-br-proxy

    Official

    A skill your agent uses when the user needs to run GitNexus CLI commands like analyze/index a repo, check status, clean the index, generate a wiki, or list indexed repos.

    106 GitHub starsUsed in 10 repos~822 tokens
    Auto-check passed
  • Gitnexus Guide

    aws-samples/sample-kolya-br-proxy

    Official

    A skill your agent uses when the user asks about GitNexus itself — available tools, how to query the knowledge graph, MCP resources, graph schema, or workflow reference.

    106 GitHub starsUsed in 10 repos~867 tokens
    Auto-check passed

Categories

Questions about Gitnexus Debugging

What does Gitnexus Debugging do?

A skill your agent uses when the user is debugging a bug, tracing an error, or asking why something fails. Gitnexus Debugging is an agent skill from aws-samples/sample-kolya-br-proxy, published by the product's own GitHub organization. Use when the user is debugging a bug, tracing an error, or asking why something fails.

When should I use Gitnexus Debugging?

Gitnexus Debugging fits situations like: the user is debugging a bug; tracing an error; asking why something fails.

How do I install Gitnexus Debugging in Claude Code?

Run `npx skills add aws-samples/sample-kolya-br-proxy --skill gitnexus-debugging -a claude-code`. Or copy the skill folder (.claude/skills/gitnexus/gitnexus-debugging in aws-samples/sample-kolya-br-proxy) into .claude/skills/gitnexus-debugging in your project. Claude Code loads it when a task matches its description.

How do I install Gitnexus Debugging in Codex?

Run `npx skills add aws-samples/sample-kolya-br-proxy --skill gitnexus-debugging -a codex`. Or copy the skill folder (.claude/skills/gitnexus/gitnexus-debugging in aws-samples/sample-kolya-br-proxy) into .agents/skills/gitnexus-debugging in your project. Codex loads it when a task matches its description.

Can I use Gitnexus Debugging 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 aws-samples/sample-kolya-br-proxy --skill gitnexus-debugging -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gitnexus-debugging, .gemini/skills/gitnexus-debugging, .github/skills/gitnexus-debugging and .opencode/skills/gitnexus-debugging in your project.

What does Gitnexus Debugging need to run?

Going by SKILL.md and its folder, Gitnexus Debugging needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Gitnexus Debugging access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Gitnexus Debugging 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 Gitnexus Debugging use?

Gitnexus Debugging is published under the MIT-0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gitnexus Debugging use?

About 780 tokens (SKILL.md is roughly 3.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 Gitnexus Debugging?

Skills that share tags, products or a category with Gitnexus Debugging: Trellis Session Insight (mindfold-ai/Trellis, 15k stars), Native Data Fetching (CherryHQ/cherry-studio-app, 4k stars), Aoti Debug (pytorch/pytorch, 104k stars) and Herdr Throwaway Reproduction (herdrdev/herdr, 43k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gitnexus Debugging?

aws-samples (a GitHub organization, an official publisher) maintains it in aws-samples/sample-kolya-br-proxy, which has 106 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 5, 2026.

Source: aws-samples/sample-kolya-br-proxy on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.