relocate skill files, add desktop docs and CI/CD builds

.github/workflows/build.yml

@@ -0,0 +1,105 @@
+name: Build Desktop Apps
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+  pull_request:
+  workflow_dispatch:
+
+env:
+  # No code-signing identity in CI; builds are unsigned by design.
+  CSC_IDENTITY_AUTO_DISCOVERY: "false"
+
+jobs:
+  test:
+    name: Test & lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: app/package-lock.json
+      - name: Install dependencies
+        run: npm ci
+        working-directory: app
+      - name: Run tests
+        run: npm test
+        working-directory: app
+      - name: Run lint
+        run: npm run lint
+        working-directory: app
+
+  package:
+    name: Package ${{ matrix.name }}
+    needs: test
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - name: mac
+            os: macos-latest
+            args: --mac dmg zip --x64 --arm64
+            artifact: |
+              app/release/*.dmg
+              app/release/*.zip
+              app/release/latest-mac.yml
+          - name: win
+            os: windows-latest
+            args: --win nsis --x64
+            artifact: |
+              app/release/*.exe
+              app/release/latest.yml
+          - name: linux
+            os: ubuntu-latest
+            args: --linux AppImage --x64
+            artifact: |
+              app/release/*.AppImage
+              app/release/latest-linux.yml
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: app/package-lock.json
+      - name: Cache electron-builder
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/Library/Caches/electron-builder
+            ~/.cache/electron-builder
+            ~\AppData\Local\electron-builder\Cache
+          key: electron-builder-${{ runner.os }}-${{ hashFiles('app/package-lock.json') }}
+      - name: Install dependencies
+        run: npm ci
+        working-directory: app
+      - name: Build app
+        run: npx electron-builder ${{ matrix.args }}
+        working-directory: app
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: oi-skill-${{ matrix.name }}
+          if-no-files-found: error
+          path: ${{ matrix.artifact }}
+
+  release:
+    name: Publish GitHub Release
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs: package
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+      - uses: softprops/action-gh-release@v2
+        with:
+          files: dist/**
+          generate_release_notes: true

.gitignore

@@ -10,13 +10,19 @@ __pycache__/
 *.swo
 *~
 
+# Local worktrees
+.worktrees/
+
 # OS
 .DS_Store
 Thumbs.db
 
 # Runtime user data (should never be committed)
 ~/.oi-skill/
 
+# Skills CLI project installs
+.agents/skills/
+
 # Promo build artifacts
 promo.mp4
 promo-60fps.mp4