Make watermark skill machine-agnostic and clarify ai-rules workflow

- Remove hardcoded absolute font path from watermark.py; resolve font
  from bundled .ttf/.ttc in skill directory or via --font flag
- Improve error message to name Gingerink as the expected font
- Update SKILL.md to document font setup and remove local path reference
- Add rule: run `ai-rules generate` after editing any file in ai-rules/
- Add rule: do not manually edit files in ai-rules/.generated-ai-rules/

Co-authored-by: Claude <noreply@anthropic.com>

Author: afollestad

.claude/skills/ai-rules-generated-watermark-portfolio-images

@@ -0,0 +1 @@
+../../ai-rules/skills/watermark-portfolio-images

.cursor/rules/ai-rules-generated-keep-agents-up-to-date.mdc

@@ -18,3 +18,7 @@ Examples of changes that should trigger a review:
 - `agents` — which AI agents (e.g. `claude`, `cursor`) receive the distributed rules
 - `nested_depth` — how many levels deep to nest rules when distributing them
 - `gitignore` — whether the generated/distributed rule files are added to `.gitignore`
+
+**IMPORTANT**: After editing any `.md` file inside `ai-rules/` or any of its subfolders (including skills), you MUST run `ai-rules generate` from the project root to re-distribute the updated rules to all agent-specific locations.
+
+**DO NOT** manually edit files inside `ai-rules/.generated-ai-rules/` — they are auto-generated by `ai-rules generate` and any manual changes will be overwritten.

.cursor/rules/ai-rules-generated-project-structure-and-stack.mdc

@@ -25,4 +25,6 @@ scripts/
   image-modal.js            — Photo gallery modal (swipe, pinch-to-zoom, keyboard nav)
   scroll-to-gallery.js      — Smooth-scrolls to the "Recent shots" section on button click
 images/                     — Portfolio photos, company logos, social icons
+ai-rules/skills/
+  watermark-portfolio-images/ — Skill + script to apply signature watermark to portfolio images
 ```

.cursor/skills/ai-rules-generated-watermark-portfolio-images

@@ -0,0 +1 @@
+../../ai-rules/skills/watermark-portfolio-images

ai-rules/.generated-ai-rules/ai-rules-generated-AGENTS.md

@@ -32,6 +32,10 @@ Examples of changes that should trigger a review:
 - `nested_depth` — how many levels deep to nest rules when distributing them
 - `gitignore` — whether the generated/distributed rule files are added to `.gitignore`
 
+**IMPORTANT**: After editing any `.md` file inside `ai-rules/` or any of its subfolders (including skills), you MUST run `ai-rules generate` from the project root to re-distribute the updated rules to all agent-specific locations.
+
+**DO NOT** manually edit files inside `ai-rules/.generated-ai-rules/` — they are auto-generated by `ai-rules generate` and any manual changes will be overwritten.
+
 # Project structure and stack
 
 ## Tech Stack
@@ -56,6 +60,8 @@ scripts/
   image-modal.js            — Photo gallery modal (swipe, pinch-to-zoom, keyboard nav)
   scroll-to-gallery.js      — Smooth-scrolls to the "Recent shots" section on button click
 images/                     — Portfolio photos, company logos, social icons
+ai-rules/skills/
+  watermark-portfolio-images/ — Skill + script to apply signature watermark to portfolio images
 ```
 
 # Rules

ai-rules/.generated-ai-rules/ai-rules-generated-keep-agents-up-to-date.md

@@ -13,3 +13,7 @@ Examples of changes that should trigger a review:
 - `agents` — which AI agents (e.g. `claude`, `cursor`) receive the distributed rules
 - `nested_depth` — how many levels deep to nest rules when distributing them
 - `gitignore` — whether the generated/distributed rule files are added to `.gitignore`
+
+**IMPORTANT**: After editing any `.md` file inside `ai-rules/` or any of its subfolders (including skills), you MUST run `ai-rules generate` from the project root to re-distribute the updated rules to all agent-specific locations.
+
+**DO NOT** manually edit files inside `ai-rules/.generated-ai-rules/` — they are auto-generated by `ai-rules generate` and any manual changes will be overwritten.

ai-rules/.generated-ai-rules/ai-rules-generated-project-structure-and-stack.md

@@ -20,4 +20,6 @@ scripts/
   image-modal.js            — Photo gallery modal (swipe, pinch-to-zoom, keyboard nav)
   scroll-to-gallery.js      — Smooth-scrolls to the "Recent shots" section on button click
 images/                     — Portfolio photos, company logos, social icons
+ai-rules/skills/
+  watermark-portfolio-images/ — Skill + script to apply signature watermark to portfolio images
 ```

ai-rules/keep-agents-up-to-date.md

@@ -18,3 +18,7 @@ Examples of changes that should trigger a review:
 - `agents` — which AI agents (e.g. `claude`, `cursor`) receive the distributed rules
 - `nested_depth` — how many levels deep to nest rules when distributing them
 - `gitignore` — whether the generated/distributed rule files are added to `.gitignore`
+
+**IMPORTANT**: After editing any `.md` file inside `ai-rules/` or any of its subfolders (including skills), you MUST run `ai-rules generate` from the project root to re-distribute the updated rules to all agent-specific locations.
+
+**DO NOT** manually edit files inside `ai-rules/.generated-ai-rules/` — they are auto-generated by `ai-rules generate` and any manual changes will be overwritten.

ai-rules/skills/watermark-portfolio-images/SKILL.md

@@ -18,11 +18,20 @@ python ai-rules/skills/watermark-portfolio-images/watermark.py
 
 Requires Pillow (`pip install Pillow`).
 
+### Font setup
+
+The script resolves the font in this order:
+
+1. **Bundled** — any `.ttf` or `.ttc` file placed directly in `ai-rules/skills/watermark-portfolio-images/` is picked up automatically.
+2. **CLI flag** — pass `--font /path/to/font.ttf` to specify it explicitly.
+
+The intended font is **Gingerink** (`GingerinkPersonalUse-rvJd7.ttf`). Download it and drop it into the skill directory (or pass it via `--font`) before running.
+
 ## Parameters
 
 | Setting | Value |
 |---|---|
-| Font | Gingerink — `/Users/afollestad/Downloads/gingerink-font/GingerinkPersonalUse-rvJd7.ttf` |
+| Font | Gingerink (`GingerinkPersonalUse-rvJd7.ttf`) — place in skill directory or pass `--font` |
 | Font size | `max(8, int(width * 0.011))` — 1.1% of image width, min 8px |
 | Text color | White, **50% opacity** (`128/255`) |
 | Shadow color | Black, 39% opacity (`100/255`), blurred |
@@ -58,7 +67,7 @@ python ai-rules/skills/watermark-portfolio-images/watermark.py --file moon.jpg -
 - **Opacity**: change `DEFAULT_OPACITY` or `DARK_OPACITY` in `watermark.py`, or pass `--opacity`
 - **Font size**: adjust the `0.011` multiplier (e.g. `0.014` = slightly larger)
 - **Position**: adjust `0.02` (horizontal) and `0.018` (vertical) padding multipliers
-- **Font**: replace `FONT_PATH` with another `.ttf`/`.ttc` path
+- **Font**: drop a different `.ttf`/`.ttc` into the skill directory, or pass `--font /path/to/font.ttf`
 
 ## Re-running after changes
 

ai-rules/skills/watermark-portfolio-images/watermark.py

@@ -10,12 +10,19 @@
 import argparse
 import glob
 import os
+import sys
 
 from PIL import Image, ImageDraw, ImageFont, ImageFilter
 
 PORTFOLIO_DIR = os.path.join(os.path.dirname(__file__), "../../../images/portfolio")
 SIGNATURE_TEXT = "Aidan Follestad"
-FONT_PATH = "/Users/afollestad/Downloads/gingerink-font/GingerinkPersonalUse-rvJd7.ttf"
+
+# Font search: look for any .ttf/.ttc in the skill directory first
+_SKILL_DIR = os.path.dirname(os.path.abspath(__file__))
+_BUNDLED_FONTS = sorted(
+    f for f in os.listdir(_SKILL_DIR) if f.lower().endswith((".ttf", ".ttc"))
+)
+FONT_PATH = os.path.join(_SKILL_DIR, _BUNDLED_FONTS[0]) if _BUNDLED_FONTS else None
 
 # Images that are mostly dark — use reduced opacity so the white text isn't jarring
 DARK_IMAGES = {"moon.jpg", "moon_thumbnail.jpg"}
@@ -68,8 +75,22 @@ def main() -> None:
     parser = argparse.ArgumentParser()
     parser.add_argument("--opacity", type=float, default=None, help="Override opacity (0.0–1.0) for all images")
     parser.add_argument("--file", type=str, default=None, help="Process a single filename only (e.g. moon.jpg)")
+    parser.add_argument("--font", type=str, default=None, help="Path to a .ttf/.ttc font file")
     args = parser.parse_args()
 
+    global FONT_PATH
+    if args.font:
+        FONT_PATH = args.font
+    if not FONT_PATH or not os.path.isfile(FONT_PATH):
+        print(
+            "Error: no font file found.\n"
+            "  Expected font: Gingerink (GingerinkPersonalUse-rvJd7.ttf)\n"
+            f"  Drop the .ttf file into {_SKILL_DIR}\n"
+            "  or pass --font /path/to/GingerinkPersonalUse-rvJd7.ttf",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
     jpg_files = sorted(glob.glob(os.path.join(PORTFOLIO_DIR, "*.jpg")))
     if args.file:
         jpg_files = [f for f in jpg_files if os.path.basename(f) == args.file]