Agent Skills
› phuc-nt/my-translator
› ck:gkg
ck:gkg
GitHub基于GKG的语义代码分析工具，支持跨文件符号引用查找、定义跳转和影响分析。通过构建代码知识图谱，为AI助手提供IDE级导航能力，辅助重构和架构理解。
Trigger Scenarios
需要查找函数或类在代码库中的所有使用位置
进行重构前需分析代码影响范围
需要生成代码架构图或进行符号定义跳转
Install
npx skills add phuc-nt/my-translator --skill ck:gkg -g -y
SKILL.md
Frontmatter
{
"name": "ck:gkg",
"metadata": {
"author": "claudekit",
"version": "1.0.0"
},
"description": "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.",
"argument-hint": "[symbol or query]"
}
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
get_referencesor HTTP API/api/graph/search
Impact Analysis
- Index affected repos
- Query
get_referencesfor changed symbols - 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 remove,gkg 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
Version History
- 3495f99 Current 2026-07-25 07:19
