@ytspar/sweetlink 1.26.0 → 1.26.1-canary.0a1121a

package/claude-skills/resize-for-claude/SKILL.md

@@ -17,10 +17,10 @@ Resize images to optimal dimensions for Claude's vision capabilities. Claude pro
 
 ## How It Works
 
-The script at `scripts/resize-for-claude` (in the tools repo):
+The `resize-for-claude` script **bundled in this skill's directory** (next to this SKILL.md):
 
 1. Reads the image dimensions
-2. If the image aspect ratio is < 3:1, resizes proportionally so the longest side = 1568px
+2. If the image aspect ratio is < 3:1, resizes proportionally so the longest side is ≤ 1568px (downscale only — already-small images are copied unchanged, never upscaled)
 3. If the image is very tall (≥ 3:1 height:width), splits into overlapping tiles before resizing each
 4. Outputs to a `<filename>-claude/` directory next to the original
 
@@ -37,20 +37,25 @@ Images exceeding these dimensions get downscaled by Claude anyway, wasting token
 ## Usage
 
 ```bash
-# Find the script (works from any project linked to tools)
-TOOLS_ROOT="$(readlink -f .claude/skills/../../)"
+# The script ships WITH this skill — invoke it from the skill's own base
+# directory (announced when the skill loads). No tools-repo lookup, no
+# project-root derivation: the skill and its script are one unit, so this
+# works identically from any repo the skill is linked into.
+# Always invoke via `bash` (as below): npm packing does not preserve the
+# executable bit, so `./resize-for-claude` breaks for package consumers.
+SKILL_DIR="<this skill's base directory>"
 
 # Basic usage — resize to 1568px longest side
-"$TOOLS_ROOT/scripts/resize-for-claude" ~/Downloads/mockup.jpg
+bash "$SKILL_DIR/resize-for-claude" ~/Downloads/mockup.jpg
 
 # Custom max side
-"$TOOLS_ROOT/scripts/resize-for-claude" ~/Downloads/mockup.png 1200
+bash "$SKILL_DIR/resize-for-claude" ~/Downloads/mockup.png 1200
 ```
 
-### Direct invocation (if you know the tools path)
+### Direct invocation (absolute path)
 
 ```bash
-$TOOLS_ROOT/scripts/resize-for-claude ~/Downloads/image.jpg
+bash /path/to/<skill-dir>/resize-for-claude ~/Downloads/image.jpg
 ```
 
 ## Output
@@ -72,11 +77,12 @@ Input:  ~/Downloads/full-page.png
 Size:   1440x8640 (4200KB)
 
 Image is very tall (6:1 ratio). Splitting into tiles...
-  Part 1: 1440x1568 (180KB) -> ~/Downloads/full-page-claude/full-page-part1.png
-  Part 2: 1440x1568 (165KB) -> ~/Downloads/full-page-claude/full-page-part2.png
-  Part 3: 1440x1568 (172KB) -> ~/Downloads/full-page-claude/full-page-part3.png
+  Part 1: 784x1568 (180KB) -> ~/Downloads/full-page-claude/full-page-part1.png
+  Part 2: 784x1568 (165KB) -> ~/Downloads/full-page-claude/full-page-part2.png
+  Part 3: 784x1568 (172KB) -> ~/Downloads/full-page-claude/full-page-part3.png
+  Part 4: 261x1568 (48KB)  -> ~/Downloads/full-page-claude/full-page-part4.png
 
-Output: ~/Downloads/full-page-claude/ (3 parts)
+Output: ~/Downloads/full-page-claude/ (4 parts)
 ```
 
 ## Requirements

package/claude-skills/resize-for-claude/resize-for-claude

@@ -0,0 +1,135 @@
+#!/usr/bin/env bash
+# Resize an image for optimal Claude vision consumption.
+# Claude works best with images where the longest side is ≤1568px.
+# For very tall images, splits into multiple parts to preserve detail.
+#
+# Usage: resize-for-claude <image-path> [max-long-side]
+#
+# Examples:
+#   resize-for-claude ~/Downloads/mockup.jpg
+#   resize-for-claude ~/Downloads/mockup.png 1200
+#
+# Requires: macOS (uses sips)
+
+set -euo pipefail
+
+if [[ "${1:-}" == "" ]]; then
+  echo "Usage: resize-for-claude <image-path> [max-long-side]" >&2
+  echo "" >&2
+  echo "  max-long-side  Maximum pixel length of longest side (default: 1568)" >&2
+  exit 1
+fi
+
+MAX_SIDE="${2:-1568}"
+INPUT="$1"
+
+if [[ ! -f "$INPUT" ]]; then
+  echo "Error: File not found: $INPUT" >&2
+  exit 1
+fi
+
+# Get image dimensions
+WIDTH=$(sips -g pixelWidth "$INPUT" | tail -1 | awk '{print $2}')
+HEIGHT=$(sips -g pixelHeight "$INPUT" | tail -1 | awk '{print $2}')
+FILESIZE=$(stat -f "%z" "$INPUT")
+
+# A non-image (or a format sips can't read) yields empty/zero dimensions,
+# which would otherwise surface as a cryptic arithmetic abort below.
+if ! [[ "$WIDTH" =~ ^[0-9]+$ && "$HEIGHT" =~ ^[0-9]+$ ]] || [[ "$WIDTH" -eq 0 || "$HEIGHT" -eq 0 ]]; then
+  echo "Error: Could not read image dimensions from $INPUT (not an image, or a format sips can't read)" >&2
+  exit 1
+fi
+
+echo "Input:  $INPUT"
+echo "Size:   ${WIDTH}x${HEIGHT} ($(( FILESIZE / 1024 ))KB)"
+
+# Determine output path
+DIR=$(dirname "$INPUT")
+BASE=$(basename "$INPUT")
+EXT="${BASE##*.}"
+NAME="${BASE%.*}"
+OUTDIR="$DIR/${NAME}-claude"
+mkdir -p "$OUTDIR"
+
+# Aspect ratio: if height > 3x width, split into tiles to preserve detail
+RATIO=$(( HEIGHT / WIDTH ))
+
+if [[ "$RATIO" -ge 3 ]]; then
+  # Very tall image — split into overlapping tiles then resize each
+  TILE_HEIGHT=$(( WIDTH * 2 ))  # Each tile is ~2:1 aspect ratio
+  OVERLAP=$(( TILE_HEIGHT / 10 ))
+  STEP=$(( TILE_HEIGHT - OVERLAP ))
+  PART=1
+  Y=0
+
+  # A re-run can produce fewer tiles than the previous run left behind;
+  # clear stale parts so the output dir never mixes runs.
+  rm -f "$OUTDIR/${NAME}-part"*."$EXT"
+
+  echo ""
+  echo "Image is very tall (${RATIO}:1 ratio). Splitting into tiles..."
+
+  while [[ "$Y" -lt "$HEIGHT" ]]; do
+    REMAINING=$(( HEIGHT - Y ))
+    CROP_H=$(( REMAINING < TILE_HEIGHT ? REMAINING : TILE_HEIGHT ))
+
+    OUTFILE="$OUTDIR/${NAME}-part${PART}.${EXT}"
+
+    # Crop tile
+    sips -c "$CROP_H" "$WIDTH" --cropOffset "$Y" 0 "$INPUT" --out "$OUTFILE" >/dev/null 2>&1 || {
+      TMPFILE=$(mktemp "/tmp/resize-claude-XXXX.$EXT")
+      cp "$INPUT" "$TMPFILE"
+      sips -c "$CROP_H" "$WIDTH" --cropOffset "$Y" 0 "$TMPFILE" --out "$OUTFILE" >/dev/null 2>&1
+      rm -f "$TMPFILE"
+    }
+
+    # Resize tile to fit within max side
+    TILE_W=$(sips -g pixelWidth "$OUTFILE" | tail -1 | awk '{print $2}')
+    TILE_H=$(sips -g pixelHeight "$OUTFILE" | tail -1 | awk '{print $2}')
+
+    if [[ "$TILE_W" -gt "$MAX_SIDE" || "$TILE_H" -gt "$MAX_SIDE" ]]; then
+      if [[ "$TILE_W" -ge "$TILE_H" ]]; then
+        sips --resampleWidth "$MAX_SIDE" "$OUTFILE" --out "$OUTFILE" >/dev/null 2>&1
+      else
+        sips --resampleHeight "$MAX_SIDE" "$OUTFILE" --out "$OUTFILE" >/dev/null 2>&1
+      fi
+    fi
+
+    NEW_W=$(sips -g pixelWidth "$OUTFILE" | tail -1 | awk '{print $2}')
+    NEW_H=$(sips -g pixelHeight "$OUTFILE" | tail -1 | awk '{print $2}')
+    NEW_SIZE=$(stat -f "%z" "$OUTFILE")
+    echo "  Part $PART: ${NEW_W}x${NEW_H} ($(( NEW_SIZE / 1024 ))KB) -> $OUTFILE"
+
+    Y=$(( Y + STEP ))
+    PART=$(( PART + 1 ))
+  done
+
+  echo ""
+  echo "Output: $OUTDIR/ ($(( PART - 1 )) parts)"
+else
+  # Single image — just resize
+  OUTFILE="$OUTDIR/${NAME}.${EXT}"
+  cp "$INPUT" "$OUTFILE"
+
+  if [[ "$WIDTH" -ge "$HEIGHT" ]]; then
+    LONG="$WIDTH"
+  else
+    LONG="$HEIGHT"
+  fi
+
+  if [[ "$LONG" -gt "$MAX_SIDE" ]]; then
+    if [[ "$WIDTH" -ge "$HEIGHT" ]]; then
+      sips --resampleWidth "$MAX_SIDE" "$OUTFILE" --out "$OUTFILE" >/dev/null 2>&1
+    else
+      sips --resampleHeight "$MAX_SIDE" "$OUTFILE" --out "$OUTFILE" >/dev/null 2>&1
+    fi
+  fi
+
+  NEW_W=$(sips -g pixelWidth "$OUTFILE" | tail -1 | awk '{print $2}')
+  NEW_H=$(sips -g pixelHeight "$OUTFILE" | tail -1 | awk '{print $2}')
+  NEW_SIZE=$(stat -f "%z" "$OUTFILE")
+
+  echo ""
+  echo "Output: $OUTFILE"
+  echo "Size:   ${NEW_W}x${NEW_H} ($(( NEW_SIZE / 1024 ))KB)"
+fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ytspar/sweetlink",
-  "version": "1.26.0",
+  "version": "1.26.1-canary.0a1121a",
   "description": "Autonomous development toolkit for AI agents - screenshots, DOM queries, console logs, and JavaScript execution via WebSocket and Chrome DevTools Protocol",
   "keywords": [
     "autonomous-development",