# Workspace skills (`$HOME/Pulpit/cursor/skills`)

Wspólne skille dla **Cursor** i **Hermes** w ekosystemie agency-ai.

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 "$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
```

MCP w `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "gitnexus": {
      "url": "https://gitnexus.mobile.agency-ai.dev/api/mcp"
    }
  }
}
```

Lokalnie (ten sam host co Docker): zamień URL na `http://127.0.0.1:4747/api/mcp`.

Po symlinku: **Reload Window** + nowa sesja chatu.

Health check:

```bash
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ł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.