# SkillsMB Onboarding Instructions

## Quick Start

Follow these steps to configure the SkillsMB CLI and install the required skills.

### Step 1: Configure npm Registry

Set the corporate npm registry (MOEX Nexus):

```bash
npm config set registry https://llm-nexus-dev.tech.moex.com/repository/mlplatform-npm-static-group
npm config set strict-ssl false
```

### Step 2: Install SkillsMB CLI

#### Option A: Install from Nexus (Recommended)

```bash
npm install -g skillsmb --strict-ssl=false --ignore-scripts
```

#### Option B: Install from Server (Fallback)

If the package is not available in Nexus, download and install from the server:

```bash
# Download CLI package
# For HTTPS servers in corporate network, use --insecure flag:
curl --insecure -o skillsmb.tgz https://https://skills.manastdio.tech/api/onboarding/cli.tgz

# Install globally (skip native compilation scripts)
npm install -g ./skillsmb.tgz --strict-ssl=false --ignore-scripts
```

### Step 3: Verify Installation

```bash
skillsmb version
skillsmb config get
```

You should see the CLI version and current configuration.

### Step 4: Configure Server URL

```bash
skillsmb config set server https://https://skills.manastdio.tech
```

Replace `https://skills.manastdio.tech` with your server address (e.g., `localhost:3000` or `https://skillsmb.moex.com`).

### Step 5: Install find-skills-mb Skill 

```bash
# Install globally (default)
skillsmb install find-skills-mb --all-agents

# Or specify an agent
skillsmb install find-skills-mb --agents kilo,cursor
```

Available agents: `claude`, `kilo`, `opencode`, `cline`, `cursor`, `global`

### Step 6: Verify Skill Installation

```bash
# List installed skills
skillsmb installed

# List all available skills
skillsmb list
```
### Step 7: User onboarding

 Describe what can be done with the skillsmb CLI. Расскажи что ты можешь с помощью skillsmb, примеры как тебя попросить. И какие есть навыки в репозитории?. Connect and use "find-skills-mb" skill to have full information about cli functionality.

## API Endpoints

- **GET /api/onboarding/instruction** — This instruction (Markdown format)
- **GET /api/onboarding/cli.tgz** — Download CLI npm package

## Troubleshooting

### CLI not found after installation

Ensure the npm global bin directory is in your PATH:

- **Windows:** `%APPDATA%\npm`
- **macOS/Linux:** `~/.npm-global/bin`

Add to PATH if needed:
```bash
# Windows (PowerShell)
$env:Path += ";$env:APPDATA\npm"

# macOS/Linux
export PATH="$HOME/.npm-global/bin:$PATH"
```

### Compilation errors on Windows (bufferutil, node-gyp)

The `@clack/prompts` package has optional native dependencies (`bufferutil`, `utf-8-validate`) that require compilation. In a corporate network, `node-gyp` cannot download Node.js headers from `nodejs.org`, so the install fails.

**Solution:** Use the standard install command (it already includes `--ignore-scripts`):

```bash
npm install -g skillsmb --strict-ssl=false --ignore-scripts
```

This is safe — `bufferutil` is optional and the CLI will work without it.

### 403 Error when downloading skills

The skill may be in quarantine. Contact the server administrator to allow download:

```bash
# Admin only
curl -X POST https://https://skills.manastdio.tech/api/skills/{skill-id}/allow-download
```

### Skills not appearing in agent

Verify the skill was installed to the correct directory:

```bash
skillsmb installed --global
skillsmb installed --project
```

Check agent-specific directories:
- **Kilo Code:** `~/.kilocode/skills`
- **Cursor:** `~/.cursor/skills`
- **Claude:** `~/.claude/skills`
- **OpenCode:** `~/.opencode/skills`
- **Cline:** `~/.cline/skills`
- **Global:** `~/.agents/skills`

## Docker Quick Start

For a complete setup with Docker:

```bash
# Build and start server
docker compose build
docker compose up -d

# Install CLI from server
curl -o skillsmb.tgz http://https://skills.manastdio.tech/api/onboarding/cli.tgz
npm install -g ./skillsmb.tgz --strict-ssl=false --ignore-scripts

# Configure and install skills
skillsmb config set server http://https://skills.manastdio.tech
skillsmb install find-skills-mb
```