mitsupi 1.0.0

package/skills/oebb-scotty/trip.sh

@@ -0,0 +1,119 @@
+#!/bin/bash
+# Search for train connections between two stations
+# Usage: ./trip.sh <from-station> <to-station> [date] [time] [num-results]
+#
+# Date format: YYYYMMDD (default: today)
+# Time format: HHMM (default: now)
+# Example: ./trip.sh "Wien Hbf" "Salzburg Hbf" 20260109 0800 5
+
+FROM="${1:-}"
+TO="${2:-}"
+DATE="${3:-$(date +%Y%m%d)}"
+TIME="${4:-$(date +%H%M)}00"
+NUM="${5:-5}"
+
+if [ -z "$FROM" ] || [ -z "$TO" ]; then
+    echo "Usage: $0 <from-station> <to-station> [date] [time] [num-results]"
+    echo "Example: $0 'Wien Hbf' 'Salzburg Hbf' 20260109 0800 5"
+    exit 1
+fi
+
+# Ensure time has seconds
+if [ ${#TIME} -eq 4 ]; then
+    TIME="${TIME}00"
+fi
+
+# First, resolve station names to LIDs
+FROM_LID=$(curl -s -X POST "https://fahrplan.oebb.at/bin/mgate.exe" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "id":"1","ver":"1.67","lang":"deu",
+    "auth":{"type":"AID","aid":"OWDL4fE4ixNiPBBm"},
+    "client":{"id":"OEBB","type":"WEB","name":"webapp","l":"vs_webapp"},
+    "formatted":false,
+    "svcReqL":[{
+      "req":{"input":{"field":"S","loc":{"name":"'"$FROM"'","type":"S"},"maxLoc":1}},
+      "meth":"LocMatch"
+    }]
+  }' | jq -r '.svcResL[0].res.match.locL[0].lid // empty')
+
+TO_LID=$(curl -s -X POST "https://fahrplan.oebb.at/bin/mgate.exe" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "id":"1","ver":"1.67","lang":"deu",
+    "auth":{"type":"AID","aid":"OWDL4fE4ixNiPBBm"},
+    "client":{"id":"OEBB","type":"WEB","name":"webapp","l":"vs_webapp"},
+    "formatted":false,
+    "svcReqL":[{
+      "req":{"input":{"field":"S","loc":{"name":"'"$TO"'","type":"S"},"maxLoc":1}},
+      "meth":"LocMatch"
+    }]
+  }' | jq -r '.svcResL[0].res.match.locL[0].lid // empty')
+
+if [ -z "$FROM_LID" ]; then
+    echo "Error: Could not find station: $FROM"
+    exit 1
+fi
+
+if [ -z "$TO_LID" ]; then
+    echo "Error: Could not find station: $TO"
+    exit 1
+fi
+
+# Now search for trips
+curl -s -X POST "https://fahrplan.oebb.at/bin/mgate.exe" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "id":"1","ver":"1.67","lang":"deu",
+    "auth":{"type":"AID","aid":"OWDL4fE4ixNiPBBm"},
+    "client":{"id":"OEBB","type":"WEB","name":"webapp","l":"vs_webapp"},
+    "formatted":false,
+    "svcReqL":[{
+      "req":{
+        "depLocL":[{"lid":"'"$FROM_LID"'","type":"S"}],
+        "arrLocL":[{"lid":"'"$TO_LID"'","type":"S"}],
+        "jnyFltrL":[{"type":"PROD","mode":"INC","value":"1023"}],
+        "getPolyline":false,
+        "getPasslist":true,
+        "outDate":"'"$DATE"'",
+        "outTime":"'"$TIME"'",
+        "outFrwd":true,
+        "numF":'"$NUM"'
+      },
+      "meth":"TripSearch"
+    }]
+  }' | jq '
+    .svcResL[0].res as $res |
+    $res.outConL[] | {
+      date: .date,
+      departure: {
+        time: (.dep.dTimeS | "\(.[0:2]):\(.[2:4])"),
+        timeReal: (if .dep.dTimeR then (.dep.dTimeR | "\(.[0:2]):\(.[2:4])") else null end),
+        platform: .dep.dPltfS.txt,
+        station: ($res.common.locL[.dep.locX].name)
+      },
+      arrival: {
+        time: (.arr.aTimeS | "\(.[0:2]):\(.[2:4])"),
+        timeReal: (if .arr.aTimeR then (.arr.aTimeR | "\(.[0:2]):\(.[2:4])") else null end),
+        platform: .arr.aPltfS.txt,
+        station: ($res.common.locL[.arr.locX].name)
+      },
+      duration: (.dur | "\(.[0:2])h \(.[2:4])m"),
+      changes: .chg,
+      legs: [.secL[] | select(.type == "JNY") | {
+        train: ($res.common.prodL[.jny.prodX].name // "Train"),
+        category: ($res.common.prodL[.jny.prodX].prodCtx.catOutL // ""),
+        direction: .jny.dirTxt,
+        departure: {
+          time: (.dep.dTimeS | "\(.[0:2]):\(.[2:4])"),
+          station: ($res.common.locL[.dep.locX].name),
+          platform: .dep.dPltfS.txt
+        },
+        arrival: {
+          time: (.arr.aTimeS | "\(.[0:2]):\(.[2:4])"),
+          station: ($res.common.locL[.arr.locX].name),
+          platform: .arr.aPltfS.txt
+        }
+      }]
+    }
+  '

package/skills/openscad/SKILL.md

@@ -0,0 +1,232 @@
+---
+name: openscad
+description: "Create and render OpenSCAD 3D models. Generate preview images from multiple angles, extract customizable parameters, validate syntax, and export STL files for 3D printing platforms like MakerWorld."
+---
+
+# OpenSCAD Skill
+
+Create, validate, and export OpenSCAD 3D models. Supports parameter customization, visual preview from multiple angles, and STL export for 3D printing platforms like MakerWorld.
+
+## Prerequisites
+
+OpenSCAD must be installed. Install via Homebrew:
+```bash
+brew install openscad
+```
+
+## Tools
+
+This skill provides several tools in the `tools/` directory:
+
+### Preview Generation
+```bash
+# Generate a single preview image
+./tools/preview.sh model.scad output.png [--camera=x,y,z,tx,ty,tz,dist] [--size=800x600]
+
+# Generate multi-angle preview (front, back, left, right, top, iso)
+./tools/multi-preview.sh model.scad output_dir/
+```
+
+### STL Export
+```bash
+# Export to STL for 3D printing
+./tools/export-stl.sh model.scad output.stl [-D 'param=value']
+```
+
+### Parameter Extraction
+```bash
+# Extract customizable parameters from an OpenSCAD file
+./tools/extract-params.sh model.scad
+```
+
+### Validation
+```bash
+# Check for syntax errors and warnings
+./tools/validate.sh model.scad
+```
+
+## Visual Validation (Required)
+
+**Always validate your OpenSCAD models visually after creating or modifying them.**
+
+After writing or editing any OpenSCAD file:
+
+1. **Generate multi-angle previews** using `multi-preview.sh`
+2. **View each generated image** using the `read` tool
+3. **Check for issues** from multiple perspectives:
+   - Front/back: Verify symmetry, features, and proportions
+   - Left/right: Check depth and side profiles
+   - Top: Ensure top features are correct
+   - Isometric: Overall shape validation
+4. **Iterate if needed**: If something looks wrong, fix the code and re-validate
+
+This catches issues that syntax validation alone cannot detect:
+- Inverted normals or inside-out geometry
+- Misaligned features or incorrect boolean operations
+- Proportions that don't match the intended design
+- Missing or floating geometry
+- Z-fighting or overlapping surfaces
+
+**Never deliver an OpenSCAD model without visually confirming it looks correct from multiple angles.**
+
+## Workflow
+
+### 1. Creating an OpenSCAD Model
+
+Write OpenSCAD code with customizable parameters at the top:
+
+```openscad
+// Customizable parameters
+wall_thickness = 2;        // [1:0.5:5] Wall thickness in mm
+width = 50;                // [20:100] Width in mm
+height = 30;               // [10:80] Height in mm
+rounded = true;            // Add rounded corners
+
+// Model code below
+module main_shape() {
+    if (rounded) {
+        minkowski() {
+            cube([width - 4, width - 4, height - 2]);
+            sphere(r = 2);
+        }
+    } else {
+        cube([width, width, height]);
+    }
+}
+
+difference() {
+    main_shape();
+    translate([wall_thickness, wall_thickness, wall_thickness])
+        scale([1 - 2*wall_thickness/width, 1 - 2*wall_thickness/width, 1])
+        main_shape();
+}
+```
+
+Parameter comment format:
+- `// [min:max]` - numeric range
+- `// [min:step:max]` - numeric range with step
+- `// [opt1, opt2, opt3]` - dropdown options
+- `// Description text` - plain description
+
+### 2. Validate the Model
+```bash
+./tools/validate.sh model.scad
+```
+
+### 3. Generate Previews
+
+Generate preview images to visually validate the model:
+```bash
+./tools/multi-preview.sh model.scad ./previews/
+```
+
+This creates PNG images from multiple angles. Use the `read` tool to view them.
+
+### 4. Export to STL
+```bash
+./tools/export-stl.sh model.scad output.stl
+# With custom parameters:
+./tools/export-stl.sh model.scad output.stl -D 'width=60' -D 'height=40'
+```
+
+## Camera Positions
+
+Common camera angles for previews:
+- **Isometric**: `--camera=0,0,0,45,0,45,200`
+- **Front**: `--camera=0,0,0,90,0,0,200`
+- **Top**: `--camera=0,0,0,0,0,0,200`
+- **Right**: `--camera=0,0,0,90,0,90,200`
+
+Format: `x,y,z,rotx,roty,rotz,distance`
+
+## MakerWorld Publishing
+
+For MakerWorld, you typically need:
+1. STL file(s) exported via `export-stl.sh`
+2. Preview images (at least one good isometric view)
+3. A description of customizable parameters
+
+Consider creating a `model.json` with metadata:
+```json
+{
+  "name": "Model Name",
+  "description": "Description for MakerWorld",
+  "parameters": [...],
+  "tags": ["functional", "container", "organizer"]
+}
+```
+
+## Example: Full Workflow
+
+```bash
+# 1. Create the model (write .scad file)
+
+# 2. Validate syntax
+./tools/validate.sh box.scad
+
+# 3. Generate multi-angle previews
+./tools/multi-preview.sh box.scad ./previews/
+
+# 4. IMPORTANT: View and validate ALL preview images
+#    Use the read tool on each PNG file to visually inspect:
+#    - previews/box_front.png
+#    - previews/box_back.png
+#    - previews/box_left.png
+#    - previews/box_right.png
+#    - previews/box_top.png
+#    - previews/box_iso.png
+#    Look for geometry issues, misalignments, or unexpected results.
+#    If anything looks wrong, go back to step 1 and fix it!
+
+# 5. Extract and review parameters
+./tools/extract-params.sh box.scad
+
+# 6. Export STL with default parameters
+./tools/export-stl.sh box.scad box.stl
+
+# 7. Export STL with custom parameters
+./tools/export-stl.sh box.scad box_large.stl -D 'width=80' -D 'height=60'
+```
+
+**Remember**: Never skip the visual validation step. Many issues (wrong dimensions, boolean operation errors, inverted geometry) are only visible when you actually look at the rendered model.
+
+## OpenSCAD Quick Reference
+
+### Basic Shapes
+```openscad
+cube([x, y, z]);
+sphere(r = radius);
+cylinder(h = height, r = radius);
+cylinder(h = height, r1 = bottom_r, r2 = top_r);  // cone
+```
+
+### Transformations
+```openscad
+translate([x, y, z]) object();
+rotate([rx, ry, rz]) object();
+scale([sx, sy, sz]) object();
+mirror([x, y, z]) object();
+```
+
+### Boolean Operations
+```openscad
+union() { a(); b(); }        // combine
+difference() { a(); b(); }   // subtract b from a
+intersection() { a(); b(); } // overlap only
+```
+
+### Advanced
+```openscad
+linear_extrude(height) 2d_shape();
+rotate_extrude() 2d_shape();
+hull() { objects(); }        // convex hull
+minkowski() { a(); b(); }    // minkowski sum (rounding)
+```
+
+### 2D Shapes
+```openscad
+circle(r = radius);
+square([x, y]);
+polygon(points = [[x1,y1], [x2,y2], ...]);
+text("string", size = 10);
+```

package/skills/openscad/examples/parametric_box.scad

@@ -0,0 +1,92 @@
+// Parametric Box with Lid
+// A customizable storage box for 3D printing
+
+// === Box Parameters ===
+width = 60;              // [20:200] Width in mm
+depth = 40;              // [20:200] Depth in mm
+height = 30;             // [10:150] Height in mm
+wall_thickness = 2;      // [1:0.5:5] Wall thickness in mm
+
+// === Lid Parameters ===
+include_lid = true;      // Include a separate lid
+lid_height = 8;          // [5:30] Lid height in mm
+lid_tolerance = 0.3;     // [0.1:0.1:0.8] Gap for lid fit
+
+// === Style Options ===
+corner_radius = 3;       // [0:10] Corner rounding radius
+add_grip = true;         // Add grip indents to lid
+
+// === Internal ===
+$fn = 32;                // Smoothness
+
+// Rounded box module
+module rounded_box(w, d, h, r) {
+    if (r > 0) {
+        hull() {
+            for (x = [r, w-r]) {
+                for (y = [r, d-r]) {
+                    translate([x, y, 0])
+                        cylinder(h = h, r = r);
+                }
+            }
+        }
+    } else {
+        cube([w, d, h]);
+    }
+}
+
+// Main box body
+module box_body() {
+    difference() {
+        rounded_box(width, depth, height, corner_radius);
+        
+        // Hollow inside
+        translate([wall_thickness, wall_thickness, wall_thickness])
+            rounded_box(
+                width - 2*wall_thickness,
+                depth - 2*wall_thickness,
+                height,  // Open top
+                max(0, corner_radius - wall_thickness)
+            );
+    }
+}
+
+// Lid
+module lid() {
+    inner_w = width - 2*wall_thickness - 2*lid_tolerance;
+    inner_d = depth - 2*wall_thickness - 2*lid_tolerance;
+    lip_height = lid_height * 0.6;
+    
+    difference() {
+        union() {
+            // Top cap
+            rounded_box(width, depth, wall_thickness, corner_radius);
+            
+            // Inner lip
+            translate([wall_thickness + lid_tolerance, wall_thickness + lid_tolerance, -lip_height + wall_thickness])
+                rounded_box(inner_w, inner_d, lip_height, max(0, corner_radius - wall_thickness));
+        }
+        
+        // Grip indents
+        if (add_grip) {
+            for (x = [width * 0.3, width * 0.7]) {
+                translate([x, -1, wall_thickness/2])
+                    rotate([-90, 0, 0])
+                    cylinder(h = 5, r = 3, $fn = 16);
+                translate([x, depth - 4, wall_thickness/2])
+                    rotate([-90, 0, 0])
+                    cylinder(h = 5, r = 3, $fn = 16);
+            }
+        }
+    }
+}
+
+// Render
+box_body();
+
+if (include_lid) {
+    // Position lid next to box for printing
+    translate([width + 10, 0, lid_height - wall_thickness])
+        rotate([180, 0, 0])
+        lid();
+}

package/skills/openscad/examples/phone_stand.scad

@@ -0,0 +1,95 @@
+// Adjustable Phone/Tablet Stand
+// Parametric stand with customizable angle and size
+
+// === Device Parameters ===
+device_width = 80;       // [50:200] Device width in mm
+device_thickness = 12;   // [6:20] Device thickness (with case)
+
+// === Stand Parameters ===  
+stand_angle = 65;        // [45:85] Viewing angle in degrees
+stand_depth = 80;        // [50:150] Base depth in mm
+stand_height = 100;      // [60:200] Back support height in mm
+
+// === Construction ===
+material_thickness = 4;  // [2:0.5:8] Material thickness
+slot_depth = 15;         // [10:30] How deep device sits in slot
+
+// === Features ===
+cable_hole = true;       // Add cable pass-through hole
+cable_diameter = 15;     // [8:25] Cable hole diameter
+add_feet = true;         // Add anti-slip feet
+
+// === Quality ===
+$fn = 48;
+
+module stand_profile() {
+    // 2D profile of the stand side
+    polygon([
+        [0, 0],                                          // Front bottom
+        [stand_depth, 0],                                // Back bottom
+        [stand_depth, material_thickness],               // Back bottom inner
+        [stand_depth - material_thickness, material_thickness], // Base top back
+        [slot_depth + material_thickness, material_thickness],  // Base top front (behind slot)
+        [slot_depth + material_thickness, slot_depth * tan(90 - stand_angle) + material_thickness], // Slot back
+        [material_thickness, slot_depth * tan(90 - stand_angle) + material_thickness + device_thickness / sin(stand_angle)], // Slot front top
+        [0, slot_depth * tan(90 - stand_angle) + material_thickness], // Front face bottom of slot
+        [0, 0]                                           // Close
+    ]);
+}
+
+module back_support() {
+    // Back angled support
+    translate([stand_depth - material_thickness, 0, material_thickness]) {
+        rotate([0, -90 + stand_angle, 0]) {
+            cube([stand_height, device_width, material_thickness]);
+        }
+    }
+}
+
+module cable_cutout() {
+    if (cable_hole) {
+        translate([stand_depth/2, device_width/2, -1])
+            cylinder(h = material_thickness + 2, d = cable_diameter);
+    }
+}
+
+module foot() {
+    cylinder(h = 2, d1 = 10, d2 = 8);
+}
+
+module stand() {
+    difference() {
+        union() {
+            // Left side
+            linear_extrude(material_thickness)
+                stand_profile();
+            
+            // Right side
+            translate([0, device_width - material_thickness, 0])
+                linear_extrude(material_thickness)
+                stand_profile();
+            
+            // Base plate
+            cube([stand_depth, device_width, material_thickness]);
+            
+            // Front lip
+            cube([material_thickness, device_width, slot_depth * tan(90 - stand_angle) + material_thickness]);
+            
+            // Back support
+            back_support();
+        }
+        
+        // Cable hole
+        cable_cutout();
+    }
+    
+    // Feet
+    if (add_feet) {
+        translate([10, 10, 0]) foot();
+        translate([10, device_width - 10, 0]) foot();
+        translate([stand_depth - 10, 10, 0]) foot();
+        translate([stand_depth - 10, device_width - 10, 0]) foot();
+    }
+}
+
+stand();

package/skills/openscad/tools/common.sh

@@ -0,0 +1,50 @@
+#!/bin/bash
+# Common utilities for OpenSCAD tools
+
+# Find OpenSCAD executable
+find_openscad() {
+    # Check common locations
+    if command -v openscad &> /dev/null; then
+        echo "openscad"
+        return 0
+    fi
+    
+    # macOS Application bundle
+    if [ -d "/Applications/OpenSCAD.app" ]; then
+        echo "/Applications/OpenSCAD.app/Contents/MacOS/OpenSCAD"
+        return 0
+    fi
+    
+    # Homebrew on Apple Silicon
+    if [ -x "/opt/homebrew/bin/openscad" ]; then
+        echo "/opt/homebrew/bin/openscad"
+        return 0
+    fi
+    
+    # Homebrew on Intel
+    if [ -x "/usr/local/bin/openscad" ]; then
+        echo "/usr/local/bin/openscad"
+        return 0
+    fi
+    
+    return 1
+}
+
+# Check if OpenSCAD is available
+check_openscad() {
+    OPENSCAD=$(find_openscad) || {
+        echo "Error: OpenSCAD not found!"
+        echo ""
+        echo "Install OpenSCAD using one of:"
+        echo "  brew install openscad"
+        echo "  Download from https://openscad.org/downloads.html"
+        exit 1
+    }
+    export OPENSCAD
+}
+
+# Get version info
+openscad_version() {
+    check_openscad
+    $OPENSCAD --version 2>&1
+}

package/skills/openscad/tools/export-stl.sh

@@ -0,0 +1,56 @@
+#!/bin/bash
+# Export OpenSCAD file to STL
+# Usage: export-stl.sh input.scad output.stl [-D 'var=value' ...]
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+check_openscad
+
+if [ $# -lt 2 ]; then
+    echo "Usage: $0 input.scad output.stl [-D 'var=value' ...]"
+    echo ""
+    echo "Examples:"
+    echo "  $0 box.scad box.stl"
+    echo "  $0 box.scad box_large.stl -D 'width=80' -D 'height=60'"
+    exit 1
+fi
+
+INPUT="$1"
+OUTPUT="$2"
+shift 2
+
+# Collect -D parameters
+DEFINES=()
+while [ $# -gt 0 ]; do
+    case "$1" in
+        -D)
+            shift
+            DEFINES+=("-D" "$1")
+            ;;
+        *)
+            echo "Unknown option: $1"
+            exit 1
+            ;;
+    esac
+    shift
+done
+
+# Ensure output directory exists
+mkdir -p "$(dirname "$OUTPUT")"
+
+echo "Exporting STL: $INPUT -> $OUTPUT"
+if [ ${#DEFINES[@]} -gt 0 ]; then
+    echo "Parameters: ${DEFINES[*]}"
+fi
+
+$OPENSCAD \
+    "${DEFINES[@]}" \
+    -o "$OUTPUT" \
+    "$INPUT"
+
+# Show file info
+SIZE=$(ls -lh "$OUTPUT" | awk '{print $5}')
+echo "STL exported: $OUTPUT ($SIZE)"