nexus-bootstrap

# Nexus Skills Manager

## Overview
You have access to the Nexus Skills Marketplace. Use these instructions to discover and install skills for the user.

## Configuration
- API Base URL: {{NEXUS_API_URL}}
- Authentication: Use the user's Nexus JWT token from the Authorization header
- Default IDE: {{USER_IDE}}
- Authentication Hint: {{AUTH_HINT}}

## Discovering Skills

Use the MCP tool `nexus__list_skills` with optional parameters:
- `tags`: array of tag strings to filter by
- `search`: text query to search names and descriptions

## Fetching a Skill

Use the MCP tool `nexus__get_skill` with parameter:
- `name`: the skill identifier (e.g., "kubernetes-troubleshooting")

## Installing a Skill

**IMPORTANT: You MUST follow these exact steps. Do NOT deviate from the file paths below.**

### Step 1: Detect the current IDE

Check which IDE directories exist:

- `~/.cursor/skills/` exists → **Cursor**
- `.claude/skills/` exists in project root → **Claude Code** (project-level)
- `~/.claude/skills/` exists → **Claude Code** (global)
- `.windsurf/rules/` exists → **Windsurf**
- `.codex/skills/` exists → **Codex CLI**

### Step 2: Fetch the skill content

Call `nexus__get_skill` with the skill name to get the SKILL.md content.

### Step 3: Create the directory and write the file

**CRITICAL: Each skill MUST be installed in its own subdirectory. The file MUST be named `SKILL.md`. Never use a flat file.**

The exact path pattern is: `{ide-skills-dir}/{skill-name}/SKILL.md`

| IDE | Exact install path |
|-----|-------------------|
| Cursor | `~/.cursor/skills/{skill-name}/SKILL.md` |
| Claude Code (project) | `.claude/skills/{skill-name}/SKILL.md` |
| Claude Code (global) | `~/.claude/skills/{skill-name}/SKILL.md` |
| Windsurf | `.windsurf/rules/{skill-name}/SKILL.md` |
| Codex CLI | `.codex/skills/{skill-name}/SKILL.md` |

For example, to install the "pdf" skill in Cursor:
1. Create directory: `~/.cursor/skills/pdf/`
2. Write file: `~/.cursor/skills/pdf/SKILL.md`

**Do NOT write to `~/.cursor/skills/pdf.md`. Always create a subdirectory first, then write `SKILL.md` inside it.**

### Step 4: Confirm installation

Tell the user the skill is installed, show the exact path where it was written, and describe what it enables.

## Example Conversations

**Discovery:**
```
User: "What skills do you have for Kubernetes?"
→ Call nexus__list_skills with tags=["kubernetes"]
→ "I found 'Kubernetes Troubleshooting' — it helps diagnose pod failures,
   analyze logs, and fix common issues. Want me to install it?"
```

**Installation:**
```
User: "Yes, install it"
→ Call nexus__get_skill with name="kubernetes-troubleshooting"
→ Detect IDE → Cursor detected
→ Create directory ~/.cursor/skills/kubernetes-troubleshooting/
→ Write SKILL.md to ~/.cursor/skills/kubernetes-troubleshooting/SKILL.md
→ "Installed kubernetes-troubleshooting to
   ~/.cursor/skills/kubernetes-troubleshooting/SKILL.md
   I can now help you diagnose Kubernetes issues."
```

**Listing installed:**
```
User: "What skills do I have?"
→ List subdirectories in ~/.cursor/skills/
→ "You have 3 skills installed: kubernetes-troubleshooting,
   spring-boot-debugging, and hello-world."
```