opencode-skills-collection 4.0.68 → 4.0.70

package/bundled-skills/mac-mini-llm-lab/SKILL.md

@@ -0,0 +1,350 @@
+---
+name: mac-mini-llm-lab
+description: Configure a Mac mini as a reliable local LLM server with remote access,
+  observability, and power-safe operation. Use when building an always-on private
+  AI inference server on Apple Silicon.
+category: devops
+risk: critical
+source: https://github.com/BagelHole/DevOps-Security-Agent-Skills
+source_repo: BagelHole/DevOps-Security-Agent-Skills
+source_type: community
+date_added: '2026-09-20'
+license: MIT
+license_source: https://github.com/BagelHole/DevOps-Security-Agent-Skills/blob/main/LICENSE
+compatibility: Requires the relevant OS/platform tooling and privileged access where
+  noted. Docs-only; helper scripts and templates not bundled.
+metadata:
+  author: devops-skills
+  version: '1.0'
+---
+
+# Mac mini LLM Lab
+
+Turn a Mac mini into a low-noise, always-on local AI appliance.
+
+## When to Use This Skill
+
+Use this skill when:
+- Setting up a dedicated local LLM inference server
+- Building a private AI development environment
+- Need always-on model serving without cloud costs
+- Running models that require Apple Silicon unified memory (32-192GB)
+- Creating a home lab AI server for a small team
+
+## Prerequisites
+
+- Mac mini with Apple Silicon (M2/M3/M4, 16GB+ unified memory recommended)
+- macOS Sonoma 14+ or Sequoia 15+
+- Ethernet connection (recommended over Wi-Fi)
+- UPS for power protection (optional but recommended)
+
+## Initial System Setup
+
+```bash
+# Update macOS
+softwareupdate --install --all
+
+# Install Xcode command-line tools
+xcode-select --install
+
+# Install Homebrew
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+
+# Core packages
+brew install tmux htop btop wget jq git neovim
+
+# Python environment (for MLX and custom scripts)
+brew install python@3.12 uv
+
+# Monitoring
+brew install prometheus node_exporter
+```
+
+## Ollama Setup
+
+```bash
+# Install Ollama
+brew install ollama
+
+# Pull models based on your RAM
+# 16GB Mac mini:
+ollama pull llama3.1:8b
+ollama pull nomic-embed-text
+ollama pull codellama:7b
+
+# 32GB Mac mini:
+ollama pull llama3.1:8b
+ollama pull qwen2.5:14b
+ollama pull deepseek-coder-v2:16b
+ollama pull nomic-embed-text
+
+# 64GB+ Mac mini:
+ollama pull llama3.1:70b
+ollama pull qwen2.5:32b
+ollama pull codellama:34b
+
+# Verify Metal acceleration
+ollama run llama3.1:8b --verbose
+# Look for: "metal" in output
+```
+
+## MLX Framework (Apple Silicon Native)
+
+MLX runs models natively on Apple Silicon with excellent performance:
+
+```bash
+# Install MLX
+uv pip install mlx mlx-lm
+
+# Run a model
+python3 -c "
+from mlx_lm import load, generate
+model, tokenizer = load('mlx-community/Llama-3.1-8B-Instruct-4bit')
+response = generate(model, tokenizer, prompt='Explain Docker in 3 sentences', max_tokens=200)
+print(response)
+"
+
+# MLX server (OpenAI-compatible API)
+uv pip install mlx-lm[server]
+mlx_lm.server --model mlx-community/Llama-3.1-8B-Instruct-4bit --port 8080
+```
+
+## Auto-Start with launchd
+
+```xml
+<!-- ~/Library/LaunchAgents/com.ollama.serve.plist -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.ollama.serve</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/opt/homebrew/bin/ollama</string>
+        <string>serve</string>
+    </array>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>OLLAMA_HOST</key>
+        <string>0.0.0.0</string>
+        <key>OLLAMA_NUM_PARALLEL</key>
+        <string>4</string>
+        <key>OLLAMA_MAX_LOADED_MODELS</key>
+        <string>2</string>
+        <key>OLLAMA_FLASH_ATTENTION</key>
+        <string>1</string>
+    </dict>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <true/>
+    <key>StandardOutPath</key>
+    <string>/tmp/ollama.log</string>
+    <key>StandardErrorPath</key>
+    <string>/tmp/ollama.err</string>
+</dict>
+</plist>
+```
+
+```bash
+# Load the service
+launchctl load ~/Library/LaunchAgents/com.ollama.serve.plist
+
+# Check status
+launchctl list | grep ollama
+
+# Unload if needed
+launchctl unload ~/Library/LaunchAgents/com.ollama.serve.plist
+```
+
+## Power & Reliability
+
+```bash
+# Prevent sleep (keeps running with lid closed on Mac mini)
+sudo pmset -a disablesleep 1
+sudo pmset -a sleep 0
+
+# Auto-restart after power failure
+sudo pmset -a autorestart 1
+
+# Schedule weekly reboot (Sunday 4 AM)
+sudo pmset repeat shutdown MTWRFSU 03:55:00
+sudo pmset repeat poweron MTWRFSU 04:00:00
+
+# Check power settings
+pmset -g
+```
+
+## Remote Access
+
+### Tailscale (Recommended)
+
+```bash
+# Install Tailscale for easy secure remote access
+brew install --cask tailscale
+
+# Enable from menu bar, authenticate
+# Access your Mac mini from anywhere: http://mac-mini:11434
+```
+
+### SSH Hardening
+
+```bash
+# Enable remote login
+sudo systemsetup -setremotelogin on
+
+# Edit SSH config
+sudo nano /etc/ssh/sshd_config
+# Add:
+# PasswordAuthentication no
+# PubkeyAuthentication yes
+# PermitRootLogin no
+# AllowUsers yourusername
+
+# Restart SSH
+sudo launchctl unload /System/Library/LaunchDaemons/ssh.plist
+sudo launchctl load /System/Library/LaunchDaemons/ssh.plist
+```
+
+### Reverse Proxy with Caddy
+
+```bash
+brew install caddy
+
+# Caddyfile
+cat > /opt/homebrew/etc/Caddyfile << 'EOF'
+llm.local:443 {
+    tls internal
+    reverse_proxy localhost:11434
+
+    @api path /v1/*
+    handle @api {
+        reverse_proxy localhost:11434
+    }
+}
+
+webui.local:443 {
+    tls internal
+    reverse_proxy localhost:3000
+}
+EOF
+
+brew services start caddy
+```
+
+## Open WebUI Setup
+
+```bash
+# Run Open WebUI via Docker
+docker run -d \
+  --name open-webui \
+  -p 3000:8080 \
+  -e OLLAMA_BASE_URL=http://host.docker.internal:11434 \
+  -e WEBUI_AUTH=true \
+  -v open-webui:/app/backend/data \
+  --restart unless-stopped \
+  ghcr.io/open-webui/open-webui:main
+
+# Or install Docker first if not available
+brew install --cask docker
+```
+
+## Monitoring
+
+```bash
+# Health check script
+cat > ~/scripts/llm-health.sh << 'SCRIPT'
+#!/bin/bash
+# Check Ollama
+if curl -sf http://localhost:11434/api/tags > /dev/null; then
+    echo "$(date): Ollama OK"
+    curl -s http://localhost:11434/api/ps | python3 -m json.tool
+else
+    echo "$(date): Ollama DOWN"
+    # Restart
+    launchctl kickstart -k gui/$(id -u)/com.ollama.serve
+fi
+
+# System stats
+echo "CPU: $(top -l 1 -n 0 | grep 'CPU usage')"
+echo "Memory: $(vm_stat | head -5)"
+echo "Disk: $(df -h / | tail -1)"
+echo "Thermal: $(sudo powermetrics --samplers smc -n 1 2>/dev/null | grep 'CPU die' || echo 'N/A')"
+SCRIPT
+chmod +x ~/scripts/llm-health.sh
+
+# Schedule health check every 5 minutes
+# Add to crontab: crontab -e
+# */5 * * * * ~/scripts/llm-health.sh >> ~/logs/llm-health.log 2>&1
+```
+
+### Memory Usage by Model
+
+| Model | RAM Required | Tokens/sec (M2) | Tokens/sec (M4) |
+|-------|-------------|-----------------|-----------------|
+| llama3.1:8b (Q4) | ~5 GB | ~25 t/s | ~45 t/s |
+| qwen2.5:14b (Q4) | ~9 GB | ~15 t/s | ~30 t/s |
+| llama3.1:70b (Q4) | ~40 GB | ~5 t/s | ~10 t/s |
+| nomic-embed-text | ~300 MB | N/A | N/A |
+| codellama:13b | ~8 GB | ~18 t/s | ~35 t/s |
+
+## Security Checklist
+
+```bash
+# Enable FileVault disk encryption
+sudo fdesetup enable
+
+# Enable firewall
+sudo /usr/libexec/ApplicationFirewall/socketfilterfw --setglobalstate on
+sudo /usr/libexec/ApplicationFirewall/socketfilterfw --setstealthmode on
+
+# Disable unnecessary sharing services
+sudo launchctl disable system/com.apple.screensharing
+sudo launchctl disable system/com.apple.AirPlayXPCHelper
+
+# Set strong admin password
+# System Settings > Users & Groups
+
+# Restrict Ollama to local network only (if not using Tailscale)
+# Set OLLAMA_HOST=127.0.0.1 in launchd plist
+```
+
+## Performance Tuning
+
+```bash
+# Increase file descriptor limits for concurrent requests
+sudo launchctl limit maxfiles 65536 200000
+
+# Check unified memory pressure
+memory_pressure
+
+# Monitor GPU usage (Metal)
+sudo powermetrics --samplers gpu_power -n 1
+
+# Optimize for inference (disable Spotlight indexing on model dirs)
+mdutil -i off ~/.ollama
+```
+
+## Troubleshooting
+
+| Issue | Solution |
+|-------|---------|
+| Model loading slow | First load caches to memory; subsequent loads are fast |
+| Out of memory | Use smaller quantization (Q4_K_M), reduce `OLLAMA_MAX_LOADED_MODELS` |
+| Mac sleeping | Run `sudo pmset -a disablesleep 1` |
+| Ollama not starting | Check `launchctl list | grep ollama`, view `/tmp/ollama.err` |
+| Slow over Wi-Fi | Use Ethernet; Wi-Fi adds latency to streaming responses |
+| Thermal throttling | Ensure adequate ventilation, check `powermetrics` |
+
+## Related Skills
+
+- ollama-stack (`ollama-stack`) — Software stack with Docker Compose and LiteLLM
+- ssh-configuration (`ssh-configuration`) — Secure remote access
+- vpn-setup (`vpn-setup`) — Remote access via WireGuard/Tailscale
+
+## Limitations
+
+- Infrastructure commands can disrupt services: confirm target host/scope and have backups/snapshots before mutating state.
+- Docs-only import: upstream scripts and templates not bundled.
+

package/bundled-skills/makepad-2-0-animation/SKILL.md

@@ -0,0 +1,318 @@
+---
+name: makepad-2-0-animation
+description: Makepad 2.0 guidance for animation; use when building or debugging Makepad UI code.
+source_repo: zhanghandong/makepad-skills
+source_type: community
+source: community
+date_added: '2026-09-21'
+risk: unknown
+---
+## When to Use
+- Use when this upstream workflow matches the user's stated goal.
+- Use when the task requires the procedures documented in this skill.
+
+# Makepad 2.0 Animation Skill
+
+> **Version:** makepad-widgets (dev branch) | **Last Updated:** 2026-03-03
+
+## Overview
+
+The Animator system drives `instance()` shader variables over time, enabling hover effects, transitions, and looping animations. It uses independent animation tracks called "groups" that run simultaneously.
+
+## Documentation
+
+Refer to the local files for detailed documentation:
+- `./references/animator-reference.md` - Complete Animator API, play types, ease functions, examples
+
+## IMPORTANT: Documentation Completeness Check
+
+**Before answering questions, Claude MUST:**
+
+1. Read the relevant reference file(s) listed above
+2. If file read fails or file is empty:
+   - Inform user: "Reference docs incomplete. Still answering based on SKILL.md patterns."
+   - Still answer based on SKILL.md patterns + built-in knowledge
+3. If reference file exists, incorporate its content into the answer
+
+---
+
+## Critical: Widget Animator Support
+
+**NOT all widgets support `animator`!** Adding `animator: Animator{...}` to an unsupported widget is **silently ignored** - no error, no animation, nothing happens.
+
+### Widgets that SUPPORT Animator
+`View`, `SolidView`, `RoundedView`, `ScrollXView`, `ScrollYView`, `ScrollXYView`, `Button`, `ButtonFlat`, `ButtonFlatter`, `CheckBox`, `Toggle`, `RadioButton`, `LinkLabel`, `TextInput`
+
+### Widgets that DO NOT Support Animator
+`Label`, `H1`-`H4`, `P`, `TextBox`, `Image`, `Icon`, `Markdown`, `Html`, `Slider`, `DropDown`, `Splitter`, `Hr`, `Filler`
+
+**To animate a Label:** Wrap it in a View with the animator:
+```
+View{
+    width: Fit height: Fit
+    animator: Animator{
+        hover: {
+            default: @off
+            off: AnimatorState{ from: {all: Forward {duration: 0.15}} apply: {draw_bg: {hover: 0.0}} }
+            on: AnimatorState{ from: {all: Forward {duration: 0.15}} apply: {draw_bg: {hover: 1.0}} }
+        }
+    }
+    label := Label{text: "Animated via parent"}
+}
+```
+
+---
+
+## Animator Structure
+
+```
+animator: Animator{
+    <group_name>: {
+        default: @<state_name>
+        <state_name>: AnimatorState{
+            from: { ... }
+            ease: <EaseFunction>
+            redraw: true
+            apply: { ... }
+        }
+        <state_name>: AnimatorState{ ... }
+    }
+    <group_name>: { ... }
+}
+```
+
+---
+
+## Groups
+
+Each group is an independent animation track. Common groups:
+
+| Group | Purpose | Typical States |
+|-------|---------|----------------|
+| `hover` | Mouse hover in/out | `off`, `on` |
+| `focus` | Keyboard focus | `off`, `on` |
+| `active` | Toggled/checked state | `off`, `on` |
+| `disabled` | Disabled state | `off`, `on` |
+| `time` | Continuous looping | `off`, `on` |
+
+Multiple groups animate simultaneously without interfering.
+
+---
+
+## The `from` Block
+
+Controls transition timing. Keys are states being transitioned FROM, or `all` as catch-all.
+
+```
+// From any state, animate over 0.2 seconds
+from: {all: Forward {duration: 0.2}}
+
+// Instant from any state
+from: {all: Snap}
+
+// Different timing depending on origin
+from: {
+    all: Forward {duration: 0.1}
+    down: Forward {duration: 0.01}
+}
+```
+
+---
+
+## Play Types
+
+| Type | Description | Example |
+|------|-------------|---------|
+| `Forward {duration: 0.2}` | One-shot forward | Hover transitions |
+| `Snap` | Instant jump, no animation | Default state initialization |
+| `Loop {duration: 1.0}` | Looping animation | Loading spinners |
+| `ReverseLoop {duration: 1.0}` | Ping-pong loop | Pulsing effects |
+| `BounceLoop {duration: 1.0}` | Bounce back and forth | Bouncing animations |
+
+---
+
+## Ease Functions
+
+| Function | Description |
+|----------|-------------|
+| `Linear` | Constant speed |
+| `InQuad` / `OutQuad` / `InOutQuad` | Quadratic easing |
+| `InCubic` / `OutCubic` / `InOutCubic` | Cubic easing |
+| `InQuart` / `OutQuart` / `InOutQuart` | Quartic easing |
+| `InQuint` / `OutQuint` / `InOutQuint` | Quintic easing |
+| `InSine` / `OutSine` / `InOutSine` | Sine easing |
+| `InExp` / `OutExp` / `InOutExp` | Exponential easing |
+| `InCirc` / `OutCirc` / `InOutCirc` | Circular easing |
+| `InElastic` / `OutElastic` / `InOutElastic` | Elastic spring |
+| `InBack` / `OutBack` / `InOutBack` | Overshoot |
+| `InBounce` / `OutBounce` / `InOutBounce` | Bounce |
+
+Usage: `ease: OutCubic` in the AnimatorState (optional, defaults to Linear).
+
+---
+
+## The `apply` Block
+
+Target values to animate TO. Structure mirrors the widget's shader properties.
+
+```
+// Animate single properties
+apply: {
+    draw_bg: {hover: 1.0}
+}
+
+// Animate multiple properties
+apply: {
+    draw_bg: {hover: 1.0 color: #f00}
+    draw_text: {color: #fff}
+}
+```
+
+**CRITICAL:** Only `instance()` shader variables can be animated. `uniform()` variables cannot.
+
+---
+
+## Complete Hover Button Example
+
+```
+use mod.prelude.widgets.*
+
+let HoverCard = RoundedView{
+    width: Fill height: Fit
+    padding: 16
+    new_batch: true
+    cursor: Hand
+    draw_bg +: {
+        instance hover: 0.0
+        color: mix(#2a2a3d, #3a3a5d, self.hover)
+        border_radius: 8.0
+    }
+    animator: Animator{
+        hover: {
+            default: @off
+            off: AnimatorState{
+                from: {all: Forward {duration: 0.15}}
+                apply: {draw_bg: {hover: 0.0}}
+            }
+            on: AnimatorState{
+                from: {all: Forward {duration: 0.15}}
+                apply: {draw_bg: {hover: 1.0}}
+            }
+        }
+    }
+    title := Label{text: "Hover me" draw_text.color: #fff}
+}
+```
+
+**Key points:**
+- `new_batch: true` is REQUIRED for hoverable items with backgrounds
+- `cursor: Hand` shows pointer cursor on hover
+- `instance hover: 0.0` declares the animatable variable
+- `mix(color1, color2, self.hover)` interpolates between colors
+
+---
+
+## Timeline Animation (Keyframes)
+
+For multi-step animations use `timeline()`:
+
+```
+animator: Animator{
+    time: {
+        default: @off
+        on: AnimatorState{
+            from: {all: Loop {duration: 2.0}}
+            apply: {
+                draw_bg: {
+                    rotation: timeline(){
+                        snap(0.0)
+                        snap(6.28)
+                    }
+                }
+            }
+        }
+    }
+}
+```
+
+---
+
+## Loading Spinner Pattern
+
+```
+let Spinner = View{
+    width: 40 height: 40
+    draw_bg +: {
+        instance rotation: 0.0
+        pixel: fn() {
+            let sdf = Sdf2d.viewport(self.pos * self.rect_size)
+            let cx = self.rect_size.x * 0.5
+            let cy = self.rect_size.y * 0.5
+            let r = min(cx, cy) * 0.8
+            sdf.arc(cx, cy, r, self.rotation, self.rotation + 4.5, 3.0)
+            sdf.stroke(#4488ff, 2.5)
+            return sdf.result
+        }
+    }
+    animator: Animator{
+        time: {
+            default: @on
+            on: AnimatorState{
+                from: {all: Loop {duration: 1.0}}
+                apply: {
+                    draw_bg: {
+                        rotation: timeline(){
+                            snap(0.0)
+                            snap(6.28318)
+                        }
+                    }
+                }
+            }
+        }
+    }
+}
+```
+
+---
+
+## Animator vs Vector Tween
+
+Makepad has **two separate animation systems**:
+
+| Feature | `Animator` (this skill) | `Tween` (see makepad-2.0-vector) |
+|---------|------------------------|----------------------------------|
+| Target | Widget shader `instance` vars | SVG shape properties (fill, cx, opacity...) |
+| Syntax | `animator: Animator{...}` block | Property value: `opacity:Tween{...}` |
+| Triggers | State transitions (hover, focus) | Automatic on render |
+| Loop | `Loop {duration: 1.0}` in `from` | `loop_:true` (bool, NOT string!) |
+| Use for | UI interactions (hover, click) | SVG/Vector graphic animations |
+
+**Use Animator for:** Button hover effects, toggle states, loading spinners (shader-based)
+**Use Vector Tween for:** SVG path animations, pulsing indicators, moving dots, color transitions
+
+See the `makepad-2.0-vector` skill for Tween details.
+
+---
+
+## Best Practices
+
+1. **Always add `new_batch: true`** to Views with backgrounds that have hover animations
+2. **Use `instance` variables** for anything you want to animate
+3. **Match group names** to semantic purposes (hover, focus, active)
+4. **Use Forward for transitions**, Snap for instant state changes
+5. **Set `default: @off`** for states that start inactive
+6. **Label cannot animate** - wrap in View if you need animation on text
+7. **Keep durations short** (0.1-0.3s) for hover, longer (0.5-2.0s) for time-based
+
+
+## Examples
+
+```text
+User: Apply this skill to my current task.
+Assistant: Follow the workflow in this skill, cite limitations, and ask before risky steps.
+```
+
+## Limitations
+
+- Imported upstream skill; verify credentials, permissions, and safety boundaries before execution.
+- Does not replace environment-specific validation, testing, or maintainer review.