tomasz-syn-grzegorza/skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add universal GitNexus skills for Cursor and Hermes.

Browse Source 
Consolidate connect, graph, and search workflows with mobile endpoint defaults and shared installation docs.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Tomasz syn Grzegorza ©
2026-07-01 16:08:15 +02:00
parent fa48844fb3
commit 287c08ebfc
6 changed files with 428 additions and 35 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+75 -29
View File
@@ -1,29 +1,45 @@
# Workspace skills (`/home/test-user/cursor/skills`)
# Workspace skills (`$HOME/Pulpit/cursor/skills`)
Wspólne skille dla **Cursor** i **Hermes** w ekosystemie agency-ai.
## Skille
| Skill | Wywołanie | Opis |
|-------|-----------|------|
| [gitnexus-search](gitnexus-search/SKILL.md) | `gitnexus-search <repo> <prompt...>` | Przeszukiwanie zdalnego GitNexus po nazwie repo |
## Cursor
Skills w tym katalogu nie są automatycznie widoczne w Cursor — utwórz symlink:
Domyślna ścieżka:
```bash
SKILLS_ROOT="${SKILLS_ROOT:-$HOME/Pulpit/cursor/skills}"
```
## Skille GitNexus
| Skill | Wywołanie / trigger | Opis |
|-------|---------------------|------|
| [gitnexus-connect](gitnexus-connect/SKILL.md) | setup MCP, health check, problemy z połączeniem | Bootstrap połączenia z `gitnexus.mobile.agency-ai.dev` |
| [gitnexus-graph](gitnexus-graph/SKILL.md) | architektura, zależności, impact, refaktoryzacja | Graph-first: `query` / `context` / `impact` przez MCP |
| [gitnexus-search](gitnexus-search/SKILL.md) | `gitnexus-search <repo> <prompt...>` | Jawne wyszukiwanie po nazwie repo + prompt |
## Endpointy
| Zastosowanie | Zdalny (domyślny) | Lokalny (dev na hoście GitNexus) |
|--------------|-------------------|-----------------------------------|
| MCP | `https://gitnexus.mobile.agency-ai.dev/api/mcp` | `http://127.0.0.1:4747/api/mcp` |
| REST API | `https://gitnexus.mobile.agency-ai.dev` | `http://127.0.0.1:4747` |
| UI (opcjonalnie) | osobna subdomena → 4173 | `http://127.0.0.1:4173` |
Szczegóły: [gitnexus-connect/reference.md](gitnexus-connect/reference.md).
## Cursor — instalacja
Symlinki do skilli (po sklonowaniu repo):
```bash
SKILLS_ROOT="$HOME/Pulpit/cursor/skills"
mkdir -p ~/.cursor/skills
ln -sfn /home/test-user/cursor/skills/gitnexus-search ~/.cursor/skills/gitnexus-search
ln -sfn "$SKILLS_ROOT/gitnexus-connect" ~/.cursor/skills/gitnexus-connect
ln -sfn "$SKILLS_ROOT/gitnexus-graph" ~/.cursor/skills/gitnexus-graph
ln -sfn "$SKILLS_ROOT/gitnexus-search" ~/.cursor/skills/gitnexus-search
```
Opcjonalnie cały katalog:
```bash
ln -sfn /home/test-user/cursor/skills ~/.cursor/skills-workspace
```
Wymagany MCP GitNexus w `~/.cursor/mcp.json`:
MCP w `~/.cursor/mcp.json`:
```json
{
@@ -35,28 +51,58 @@ Wymagany MCP GitNexus w `~/.cursor/mcp.json`:
}
```
Lokalnie (ten sam host co Docker): zamień URL na `http://127.0.0.1:4747/api/mcp`.
Po symlinku: **Reload Window** + nowa sesja chatu.
## Hermes (m3gan)
W promptcie systemowym lub `INSTALL-AGENT.md` podaj ścieżkę bezwzględną do skilla:
```text
/home/test-user/cursor/skills/gitnexus-search/SKILL.md
```
Hermes używa REST (skrypt), gdy MCP niedostępny:
Health check:
```bash
python3 /home/test-user/cursor/skills/gitnexus-search/scripts/gitnexus-search.py \
bash "$SKILLS_ROOT/gitnexus-connect/scripts/gitnexus-health.sh"
```
## Hermes — instalacja
W promptcie systemowym lub `INSTALL-AGENT.md` podaj ścieżki do skilli:
```text
$SKILLS_ROOT/gitnexus-connect/SKILL.md
$SKILLS_ROOT/gitnexus-graph/SKILL.md
$SKILLS_ROOT/gitnexus-search/SKILL.md
```
Zmienne środowiskowe:
```bash
export GITNEXUS_SERVER_URL=https://gitnexus.mobile.agency-ai.dev
export GITNEXUS_DEFAULT_REPO=one-gateway
export SKILLS_ROOT="$HOME/Pulpit/cursor/skills"
```
Hermes używa MCP HTTP (ten sam URL co Cursor) lub REST fallback:
```bash
python3 "$SKILLS_ROOT/gitnexus-search/scripts/gitnexus-search.py" \
one-gateway "deploy_runner"
```
Więcej: [one-gateway/docs/hermes/GITNEXUS-CLIENT.md](../one-gateway/docs/hermes/GITNEXUS-CLIENT.md).
## Przykład
## Przykłady
```text
gitnexus-search ai-lawyer-srvr routes_paperless admin
gitnexus-search gateway gitnexus_workspace_dir
```
## Extended documentation (one-gateway)
Szczegółowa dokumentacja deployu i operatora — w repo `one-gateway`:
- `coding-agent/31-gitnexus-deployment-report.md`
- `coding-agent/33-gitnexus-m3gan-remote-client.md`
- `coding-agent/34-gitnexus-npmplus-edge-setup.md`
- `coding-agent/35-cursor-gitnexus-mcp-setup.md`
- `coding-agent/36-gitnexus-repo-connection-guide.md`
Canonical source skilli: **ten katalog** (`cursor/skills`). Kopia `one-gateway/.cursor/skills/gitnexus-graph-first` nie jest utrzymywana — używaj `gitnexus-graph` stąd.