@heart-of-gold/toolkit 0.1.39 → 0.1.41

package/.claude-plugin/marketplace.json

@@ -15,19 +15,19 @@
       "name": "deep-thought",
       "source": "./plugins/deep-thought",
       "description": "The Answer Computer — reasoning tools for brainstorming, planning, and deep thinking",
-      "version": "0.2.9"
+      "version": "0.2.10"
     },
     {
       "name": "marvin",
       "source": "./plugins/marvin",
       "description": "The Paranoid Android — quality tools for code review, knowledge compounding, and work execution",
-      "version": "0.3.9"
+      "version": "0.3.10"
     },
     {
       "name": "babel-fish",
       "source": "./plugins/babel-fish",
       "description": "Universal Translator — media generation tools for audio, image, and video content",
-      "version": "0.2.7"
+      "version": "0.2.9"
     },
     {
       "name": "quellis",

package/README.md

@@ -2,7 +2,7 @@
 
 > **Don't Panic.**
 
-30 skills for AI coding agents. Five plugins. Works with **Claude Code, Codex, OpenCode, Pi**, and any tool supporting the [agentskills.io](https://agentskills.io) standard. Named after *The Hitchhiker's Guide to the Galaxy* because the universe is absurd and your tools should at least have personality.
+31 skills for AI coding agents. Five plugins. Works with **Claude Code, Codex, OpenCode, Pi**, and any tool supporting the [agentskills.io](https://agentskills.io) standard. Named after *The Hitchhiker's Guide to the Galaxy* because the universe is absurd and your tools should at least have personality.
 
 ## Installation
 
@@ -136,14 +136,15 @@ Configurable sources (RSS, Gmail, HN, web search), narrative briefs, LinkedIn dr
 
 ### [Babel Fish](plugins/babel-fish/) — Universal Translator
 
-Turn words into audio. Turn ideas into images. Visualize anything as a terminal mind map.
+Turn words into audio. Turn ideas into images. Visualize anything as a terminal mind map. Stitch screenshots into a LinkedIn-ready carousel PDF.
 
-3 skills
+4 skills
 
 ```
-/babel-fish:audio     # TTS, podcasts, voice cloning, sound effects
-/babel-fish:image     # AI image generation and editing
-/babel-fish:visualize # terminal mind maps from any structured content
+/babel-fish:audio             # TTS, podcasts, voice cloning, sound effects
+/babel-fish:image             # AI image generation and editing
+/babel-fish:visualize         # terminal mind maps from any structured content
+/babel-fish:linkedin-carousel # screenshots → LinkedIn document-post PDF with matched backgrounds
 ```
 
 ### [Quellis](plugins/quellis/) — AI Coaching Companion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heart-of-gold/toolkit",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "type": "module",
   "description": "Cross-platform installer for Heart of Gold skills — works with Codex, OpenCode, Pi, Claude Code, and more",
   "bin": {

package/plugins/babel-fish/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "babel-fish",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "Universal Translator — media generation tools for audio, image, video, and visualization",
   "author": {
     "name": "ondrej-svec",

package/plugins/babel-fish/README.md

@@ -3,7 +3,7 @@
 > "The Babel fish is small, yellow, leathery, and probably the oddest thing in the universe."
 > It also translates your words into audio and your ideas into images.
 
-A media generation plugin for Claude Code. Turns text into audio, ideas into images, and structured content into terminal mind maps.
+A media generation plugin for Claude Code. Turns text into audio, ideas into images, structured content into terminal mind maps, and screenshots into LinkedIn-ready carousel PDFs.
 
 ## Security & Trust
 
@@ -36,10 +36,14 @@ Supports Gemini and FLUX models via OpenRouter API.
 ### `/babel-fish:visualize`
 Render mind maps and tree visualizations directly in the terminal using Unicode box-drawing characters and ANSI colors. Works over SSH — no browser needed. Use it on brainstorm docs, plan docs, markdown files, or any structured content.
 
+### `/babel-fish:linkedin-carousel`
+Turn an ordered set of screenshots or images into a LinkedIn document-post PDF (carousel). Auto-samples each source's corner pixel so per-page padding blends invisibly into the image, picks a sensible canvas aspect from the source dimensions, and renders at 2× with Lanczos resampling. Powered by ImageMagick.
+
 ## Requirements
 
 - ElevenLabs API key (for audio)
 - OpenRouter API key (for image generation)
+- ImageMagick (`magick` on PATH) — for `linkedin-carousel`
 
 ## Install
 

package/plugins/babel-fish/skills/linkedin-carousel/SKILL.md

@@ -0,0 +1,139 @@
+---
+name: linkedin-carousel
+description: >
+  Turn a set of screenshots or images into a LinkedIn document-post PDF (carousel)
+  with per-page background matching so padding disappears into the source.
+  Triggers: linkedin carousel, carousel pdf, document post, slide pdf, screenshots to pdf, linkedin pdf, carousel from images.
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+---
+
+# LinkedIn Carousel — Babel Fish
+
+Translating a stack of screenshots into a feed-ready document post. The trick isn't the PDF — it's making the padding invisible.
+
+## Boundaries
+
+- **MAY:** read source images, run `magick`, write PNGs and PDFs to the requested output path.
+- **MAY NOT:** upload to LinkedIn, post on the user's behalf, or modify the source images in place.
+
+## Prerequisites
+
+- ImageMagick installed (`magick` on PATH). Check with `which magick`.
+- Sources are raster images (PNG/JPG). For non-image inputs, ask the user to export first.
+
+## Phase 0 — Understand
+
+**Entry:** User asked for a LinkedIn carousel.
+
+Gather, asking only what's missing:
+
+- **Sources**: ordered list of image paths (order = page order in the carousel).
+- **Slug**: kebab-case filename for the PDF (e.g. `harness-lab-carousel`). If the user gives a topic, derive it; otherwise ask.
+- **Output path**: default `thoughts/social-media/carousels/<slug>.pdf` if the repo has that dir; otherwise ask.
+- **Aspect preference**: portrait (best feed performance), square, or landscape. If the user has no preference, **infer from sources** in Phase 1.
+
+**Exit:** Source list, output path, and aspect intent are known.
+
+## Phase 1 — Plan
+
+**Entry:** Inputs gathered.
+
+Reason step-by-step before generating:
+
+1. Run `magick identify` on each source to get width × height.
+2. **Pick canvas aspect** to minimize padding:
+   - User asked for portrait → `1080×1350` (×2 = `2160×2700`).
+   - User asked for square → `1080×1080` (×2 = `2160×2160`).
+   - **No preference** → if the sources cluster around one aspect, pick the **median** w/h ratio — this minimizes total padding across the deck. If sources span a wide range (e.g. 1.6:1 → 2.6:1), pick the aspect that makes the *most* pages padding-free, and accept that the outliers will get bands.
+3. **Sample background color per page** — the move that makes seams invisible. Need the dimensions first, then sample three corners:
+   ```bash
+   read W H < <(magick identify -format "%w %h" "$src")
+   magick "$src" -format \
+     "tl=%[pixel:p{5,5}] tr=%[pixel:p{$((W-5)),5}] bl=%[pixel:p{5,$((H-5))}]\n" \
+     info:
+   ```
+   If all three corners agree, use that color. If they disagree, the source has no clean border — fall back to `#F4EFE3` (or another neutral the user prefers) and tell them.
+4. Render at **2× target resolution** with Lanczos resampling. 300 DPI in the final PDF.
+
+**Exit:** Canvas dimensions chosen, per-page background colors sampled.
+
+## Phase 2 — Build
+
+**Entry:** Plan complete.
+
+Write the build script to a temp file (avoids shell quoting traps), then run it:
+
+```bash
+#!/bin/bash
+set -e
+OUT=/path/to/output/dir
+SLUG=harness-lab-carousel        # from Phase 0
+CANVAS=2160x2700                 # from Phase 1
+declare -a SRCS=(/path/1.png /path/2.png /path/3.png)
+declare -a BGS=('#EFF1F5' '#EFF1F5' '#F2ECEB')   # from Phase 1 sampling
+
+mkdir -p "$OUT"
+PAGES=()
+for i in "${!SRCS[@]}"; do
+  # Zero-pad page number so glob ordering survives 10+ pages.
+  n=$(printf "%02d" $((i+1)))
+  page="$OUT/page${n}.png"
+  magick "${SRCS[$i]}" \
+    -filter Lanczos \
+    -resize "$CANVAS" \
+    -background "${BGS[$i]}" \
+    -gravity center \
+    -extent "$CANVAS" \
+    -quality 95 \
+    "$page"
+  PAGES+=("$page")
+done
+
+# Pass pages explicitly in array order — never rely on shell glob ordering.
+magick "${PAGES[@]}" -density 300 -quality 95 "$OUT/${SLUG}.pdf"
+```
+
+**Notes:**
+- `-resize WxH` (without `>` or `!`) fits inside the box preserving aspect; `-extent` then pads to exact canvas using `-background`.
+- Pages are passed to the final `magick` call from the `PAGES` array, not via glob — `page*.png` would put `page10.png` before `page2.png` lexicographically and reorder the carousel.
+- Keep the intermediate `page*.png` files — useful for spot fixes without rebuilding everything.
+- LinkedIn document posts cap at **100 MB** and **300 pages**. A 3–10 page carousel at 2× is typically 1–5 MB.
+
+**Exit:** PDF and page PNGs exist at the output path.
+
+## Phase 3 — Review
+
+**Entry:** PDF built.
+
+Open the PDF for the user (`open <path>` on macOS). Report:
+
+- Output path
+- Page count, canvas dimensions, file size
+- Per-page background colors used
+- Any fallbacks (e.g., "page 2's corners disagreed — used neutral cream")
+
+Ask whether any page needs a different aspect or a tighter crop. Common follow-ups:
+
+- "Page X has too much padding" → re-sample with a different canvas aspect, or crop that source before rebuilding.
+- "Backgrounds don't match" → the source likely has anti-aliased edges; sample further from the corner (`{20,20}`).
+- "Quality looks soft" → confirm 2× and Lanczos; check the source isn't already low-res.
+
+## Constraints
+
+- Never modify source images in place.
+- Never upload, share, or post the output. Hand the file to the user.
+- Default to per-page background sampling. Single-color fallback only when sources disagree.
+- Always render at 2× target and downsample at PDF assembly time — not the other way around.
+- Keep the intermediate PNGs unless the user asks to clean them up.
+
+## Output
+
+The user receives:
+
+- `<output-dir>/<slug>.pdf` — the carousel, ready to upload via LinkedIn's "Add a document".
+- `<output-dir>/page1.png`, `page2.png`, … — per-page renders for inspection.
+- A short summary message with path, dimensions, page count, and any fallbacks taken.

package/plugins/babel-fish/skills/visualize/scripts/agent-artifact-template.html

@@ -131,21 +131,47 @@
       margin-bottom: var(--space-3);
     }
 
-    .theme-toggle {
+    .theme-switcher {
       display: inline-flex;
       align-items: center;
-      gap: 10px;
-      padding: 10px 14px;
+      gap: 6px;
+      padding: 6px;
       border-radius: 999px;
       border: 1px solid var(--border);
-      background: var(--panel-soft);
+      background: color-mix(in srgb, var(--panel-strong) 82%, transparent);
       box-shadow: var(--shadow-md);
-      color: var(--muted);
       backdrop-filter: blur(14px);
     }
 
-    .theme-toggle strong {
+    .theme-option {
+      display: inline-flex;
+      align-items: center;
+      justify-content: center;
+      gap: 8px;
+      min-width: 44px;
+      padding: 10px 14px;
+      border-radius: 999px;
+      color: var(--muted-2);
+      transition: background-color 160ms ease, color 160ms ease, transform 160ms ease;
+    }
+
+    .theme-option:hover {
       color: var(--text-strong);
+      background: color-mix(in srgb, var(--panel-soft) 80%, transparent);
+    }
+
+    .theme-option[aria-pressed="true"] {
+      background: color-mix(in srgb, var(--accent) 12%, var(--panel-soft));
+      color: var(--text-strong);
+      box-shadow: inset 0 0 0 1px color-mix(in srgb, var(--accent) 24%, var(--border));
+    }
+
+    .theme-option .icon {
+      font-size: 15px;
+      line-height: 1;
+    }
+
+    .theme-option .text {
       font-size: 13px;
       font-weight: 600;
     }
@@ -414,9 +440,17 @@
         justify-content: stretch;
       }
 
-      .theme-toggle {
+      .theme-switcher {
         width: 100%;
-        justify-content: center;
+        justify-content: space-between;
+      }
+
+      .theme-option {
+        flex: 1 1 0;
+      }
+
+      .theme-option .text {
+        display: none;
       }
 
       .hero,
@@ -442,10 +476,20 @@
 <body>
   <main>
     <div class="topbar">
-      <button class="theme-toggle" id="theme-toggle" type="button" aria-label="Toggle light and dark theme">
-        <strong>Theme</strong>
-        <span id="theme-label">Auto</span>
-      </button>
+      <div class="theme-switcher" role="group" aria-label="Theme switcher">
+        <button class="theme-option" id="theme-light" type="button" data-theme-value="light" aria-pressed="false" aria-label="Use light theme" title="Light theme">
+          <span class="icon" aria-hidden="true">☀</span>
+          <span class="text">Light</span>
+        </button>
+        <button class="theme-option" id="theme-auto" type="button" data-theme-value="auto" aria-pressed="true" aria-label="Use automatic theme" title="Auto theme">
+          <span class="icon" aria-hidden="true">◐</span>
+          <span class="text">Auto</span>
+        </button>
+        <button class="theme-option" id="theme-dark" type="button" data-theme-value="dark" aria-pressed="false" aria-label="Use dark theme" title="Dark theme">
+          <span class="icon" aria-hidden="true">☾</span>
+          <span class="text">Dark</span>
+        </button>
+      </div>
     </div>
 
     <section class="hero">
@@ -503,10 +547,9 @@
     (() => {
       const root = document.documentElement;
       const metaTheme = document.querySelector('meta[name="theme-color"]');
-      const button = document.getElementById('theme-toggle');
-      const label = document.getElementById('theme-label');
       const storageKey = 'hog-artifact-theme';
       const media = window.matchMedia('(prefers-color-scheme: dark)');
+      const options = Array.from(document.querySelectorAll('.theme-option'));
 
       const computeTheme = (mode) => {
         if (mode === 'auto') return media.matches ? 'dark' : 'light';
@@ -517,18 +560,21 @@
 
       const apply = (mode) => {
         root.dataset.theme = mode;
-        if (label) label.textContent = mode[0].toUpperCase() + mode.slice(1);
         if (metaTheme) metaTheme.setAttribute('content', themeColor(mode));
+        options.forEach((option) => {
+          option.setAttribute('aria-pressed', option.dataset.themeValue === mode ? 'true' : 'false');
+        });
       };
 
       const saved = localStorage.getItem(storageKey) || 'auto';
       apply(saved);
 
-      button?.addEventListener('click', () => {
-        const current = root.dataset.theme || 'auto';
-        const next = current === 'auto' ? 'dark' : current === 'dark' ? 'light' : 'auto';
-        localStorage.setItem(storageKey, next);
-        apply(next);
+      options.forEach((option) => {
+        option.addEventListener('click', () => {
+          const mode = option.dataset.themeValue || 'auto';
+          localStorage.setItem(storageKey, mode);
+          apply(mode);
+        });
       });
 
       media.addEventListener?.('change', () => {

package/plugins/deep-thought/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "deep-thought",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "description": "The Answer Computer — reasoning tools for brainstorming, planning, architecture design, and deep thinking",
   "author": {
     "name": "ondrej-svec",

package/plugins/marvin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "marvin",
-  "version": "0.3.9",
+  "version": "0.3.10",
   "description": "The Paranoid Android — quality tools for code review, knowledge compounding, and work execution",
   "author": {
     "name": "ondrej-svec",