@hailer/mcp 1.1.14 → 1.1.16

package/.claude/skills/SDK-init-skill/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: SDK-init-skill
+description: Initialize a new Hailer SDK project
+version: 1.0.0
+triggers: New project, init workspace, setup SDK, create workspace
+---
+
+# SDK Project Initialization
+
+Setting up a new Hailer SDK workspace project.
+
+## Overview
+
+A Hailer SDK project connects to a Hailer workspace and allows you to manage its configuration as infrastructure-as-code.
+
+---
+
+## Prerequisites
+
+- Node.js 18+
+- Access to a Hailer workspace
+- Workspace API credentials
+
+---
+
+## Project Structure
+
+A new SDK project has this structure:
+
+```
+project/
+├── workspace/              # SDK configuration (git-tracked)
+│   ├── workflows.ts        # Workflow registry
+│   ├── enums.ts           # Auto-generated IDs
+│   ├── teams.ts           # Team definitions
+│   ├── groups.ts          # Group definitions
+│   └── [Workflow]_[id]/   # Per-workflow config
+├── .env                   # Credentials (git-ignored)
+├── config.json            # Workspace configuration
+├── package.json           # Dependencies
+├── tsconfig.json          # TypeScript config
+└── vitest.config.ts       # Test configuration
+```
+
+---
+
+## Setup Steps
+
+### 1. Create Project
+
+```bash
+mkdir my-hailer-project
+cd my-hailer-project
+npm init -y
+```
+
+### 2. Install SDK
+
+```bash
+npm install @hailer/sdk typescript vitest --save-dev
+```
+
+### 3. Configure Credentials
+
+Create `.env`:
+```
+HAILER_API_KEY=your_api_key
+HAILER_WORKSPACE_ID=your_workspace_id
+```
+
+Create `config.json`:
+```json
+{
+  "workspaceId": "your_workspace_id",
+  "apiUrl": "https://api.hailer.com"
+}
+```
+
+### 4. Pull Initial Configuration
+
+```bash
+npm run pull
+```
+
+This downloads the current workspace configuration into `workspace/`.
+
+### 5. Add Claude Code Setup (Optional)
+
+```bash
+/setup-hailer
+```
+
+This copies agents, skills, and hooks from the reference.
+
+---
+
+## First Workflow
+
+The SDK creates workspace with one default workflow. To add more:
+
+1. Edit `workspace/workflows.ts`
+2. Run `npm run workflows-sync:force`
+3. Run `npm run pull` to get new IDs
+
+---
+
+## Git Setup
+
+```bash
+git init
+echo ".env" >> .gitignore
+echo "node_modules" >> .gitignore
+git add -A
+git commit -m "Initial SDK setup"
+```
+
+---
+
+## Verification
+
+After setup, verify by running:
+
+```bash
+npm run pull
+```
+
+Should complete without errors and populate `workspace/` with your configuration.