Claude-skill-registry gkg
Semantic code analysis with GitLab Knowledge Graph. Use for go-to-definition, find-usages, impact analysis, architecture visualization. Supports Ruby, Java, Kotlin, Python, TypeScript/JavaScript.
install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/gkg" ~/.claude/skills/majiayu000-claude-skill-registry-gkg-58253b && rm -rf "$T"
manifest:
skills/data/gkg/SKILL.mdsource content
GitLab Knowledge Graph (GKG)
Semantic code analysis engine using AST parsing and KuzuDB graph database. Enables IDE-like code navigation for AI assistants.
Status: Public beta | Requires: Git repository | Storage:
~/.gkg/
When to Use
- Find all usages of a function/class across codebase
- Go-to-definition for symbols
- Impact analysis before refactoring
- Generate architecture diagrams
- RAG-enhanced code understanding
Use repomix instead for: quick context dumps, any-language support, remote repos, token counting.
Quick Start
# Check installation gkg --version # Index current repo gkg index # Start server (for API/MCP) gkg server start # Stop before re-indexing gkg server stop
Installation
# macOS/Linux curl -fsSL https://gitlab.com/gitlab-org/rust/knowledge-graph/-/raw/main/install.sh | bash # Windows (PowerShell) irm https://gitlab.com/gitlab-org/rust/knowledge-graph/-/raw/main/install.ps1 | iex
Core Workflows
Index and Query
gkg index /path/to/project --stats gkg server start # Query via HTTP API at http://localhost:27495
Find Symbol Usages
- Index project:
gkg index - Start server:
gkg server start - Use MCP tool
or HTTP APIget_references/api/graph/search
Impact Analysis
- Index affected repos
- Query
for changed symbolsget_references - Review all call sites before refactoring
Language Support
| Language | Cross-file Refs |
|---|---|
| Ruby | ✅ Full |
| Java | ✅ Full |
| Kotlin | ✅ Full |
| Python | 🚧 In progress |
| TypeScript | 🚧 In progress |
| JavaScript | 🚧 In progress |
References
- CLI Commands -
,gkg index
,gkg server
,gkg removegkg clean - MCP Tools - 7 tools for AI integration
- HTTP API - REST endpoints for querying
- Language Details - Supported features per language
Key Constraints
- Must stop server before re-indexing
- Requires initialized Git repository
- Languages not connected across repos (yet)
- TS/JS/Python cross-file refs incomplete