@maccesar/aiskills 1.9.3 → 1.11.0

package/README.md

@@ -114,6 +114,10 @@ Confirmations:
 - `proceed` / `sí` / `commitea` → release on current branch only.
 - `merge` → release + fast-forward merge to main + push main, and leaves you on `main`. Aborts cleanly if main has diverged.
 - `PR` → release + open pull request to main via `gh`.
+- `con tag` / `with tag` (modifier, combinable with any of the above) → on a private repo, force-create the git tag (the GitHub release stays skipped). No effect on public/internal repos.
+
+Private-repo behavior:
+- When `gh repo view` reports the repo as `PRIVATE`, the workflow skips both the git tag and the GitHub release by default — tags/releases are distribution artifacts that aren't usually needed for private projects. The version bump in `package.json` / `tiapp.xml` / etc. plus the `CHANGELOG.md` entry remain. Add `con tag` / `with tag` to your confirmation if you want the tag anyway.
 
 Language policy (two independent axes):
 - **Axis 1 — Interaction with you** — always in your language. The command detects the language from your messages and locks it before printing anything; if you switch, it switches with you.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maccesar/aiskills",
-  "version": "1.9.3",
+  "version": "1.11.0",
   "description": "AI coding assistant skills for Claude Code, Gemini CLI, and Codex CLI",
   "type": "module",
   "bin": {

package/skills/stitch-showcase/SKILL.md

@@ -13,6 +13,10 @@ Converts Google Stitch exports (zips with `code.html` + `screen.png`) into a nav
 
 Scripts require Python 3.8+. No external dependencies (stdlib only).
 
+## Script paths
+
+All commands below use `<SKILL_DIR>/scripts/...` as a placeholder. Replace `<SKILL_DIR>` with the absolute "Base directory for this skill" shown in the system message when this skill loads (e.g. `~/.claude/plugins/cache/<plugin>/<version>/skills/stitch-showcase` for plugin installs, or `~/.claude/skills/stitch-showcase` for standalone installs). Do not assume `~/.claude/skills/...` — the path differs by install type.
+
 ## Workflow: Four Modes
 
 ```dot
@@ -47,7 +51,7 @@ Steps:
 1. Identify the source path from the user's message
 2. Run the build script — **nothing else**:
    ```bash
-   python ~/.claude/skills/stitch-showcase/scripts/build_showcase.py /path/to/source
+   python <SKILL_DIR>/scripts/build_showcase.py /path/to/source
    ```
 3. Parse the script output to get the `showcase/` path
 4. Open the showcase in the default browser:
@@ -61,8 +65,8 @@ Steps:
 Only ask `--type` or `--name` if the **script fails** or the **user explicitly wants to override**:
 ```bash
 # Only if script fails to detect type or user requests it
-python ~/.claude/skills/stitch-showcase/scripts/build_showcase.py /path/to/source --type mobile
-python ~/.claude/skills/stitch-showcase/scripts/build_showcase.py /path/to/source --name "My App" --type mobile
+python <SKILL_DIR>/scripts/build_showcase.py /path/to/source --type mobile
+python <SKILL_DIR>/scripts/build_showcase.py /path/to/source --name "My App" --type mobile
 ```
 
 ## Mode 2: Enrich (on-demand — user asks)
@@ -75,7 +79,7 @@ Steps:
 1. Find the source folder (from the user's message or the project's `showcase.json`)
 2. Run `--extract-text` to get screen summaries:
    ```bash
-   python ~/.claude/skills/stitch-showcase/scripts/build_showcase.py /path/to/source --extract-text
+   python <SKILL_DIR>/scripts/build_showcase.py /path/to/source --extract-text
    ```
    This generates `screen_summaries.txt` — a compact text file with visible text from all screen HTMLs.
 3. Read the existing `DESIGN.md` (in the source folder) + `screen_summaries.txt`
@@ -87,7 +91,7 @@ Steps:
 6. **Verify colors/fonts**: Scan the screen HTMLs for hex colors in CSS variables and font families. Update `## Colors` and `## Typography` sections if they're missing or incomplete.
 7. Re-run the build to regenerate HTMLs with enriched data:
    ```bash
-   python ~/.claude/skills/stitch-showcase/scripts/build_showcase.py /path/to/source
+   python <SKILL_DIR>/scripts/build_showcase.py /path/to/source
    ```
 8. Done — tell the user the showcase has been updated with improved descriptions
 
@@ -136,13 +140,13 @@ Steps:
 
 ```bash
 # Structural components (navbar, footer, sidebar, tabbar)
-python ~/.claude/skills/stitch-showcase/scripts/apply_canonical.py /path/to/showcase/assets/ navbar home_screen
+python <SKILL_DIR>/scripts/apply_canonical.py /path/to/showcase/assets/ navbar home_screen
 
 # Atomic components (button, input, heading, etc.)
-python ~/.claude/skills/stitch-showcase/scripts/apply_canonical.py /path/to/showcase/assets/ button home_screen
+python <SKILL_DIR>/scripts/apply_canonical.py /path/to/showcase/assets/ button home_screen
 
 # Target specific screens only
-python ~/.claude/skills/stitch-showcase/scripts/apply_canonical.py /path/to/showcase/assets/ navbar home_screen --targets login settings profile
+python <SKILL_DIR>/scripts/apply_canonical.py /path/to/showcase/assets/ navbar home_screen --targets login settings profile
 ```
 
 4. Rebuild the showcase: `build_showcase.py /path/to/source`
@@ -177,13 +181,13 @@ The catalog is generated automatically as part of every build. Open `catalog.htm
 
 ```bash
 # Point to the project root — the script discovers the source automatically
-python ~/.claude/skills/stitch-showcase/scripts/build_showcase.py /path/to/project
+python <SKILL_DIR>/scripts/build_showcase.py /path/to/project
 
 # Or point directly to the folder with zips/screens
-python ~/.claude/skills/stitch-showcase/scripts/build_showcase.py /path/to/project/stitch
+python <SKILL_DIR>/scripts/build_showcase.py /path/to/project/stitch
 
 # Single mega-zip (zip containing all screens as subfolders)
-python ~/.claude/skills/stitch-showcase/scripts/build_showcase.py /path/to/export.zip
+python <SKILL_DIR>/scripts/build_showcase.py /path/to/export.zip
 ```
 
 ### Flags

package/skills/stitch-showcase/references/index.html

@@ -186,13 +186,13 @@
       // Update badge text
       viewBadge.textContent = currentView === 'mobile' ? 'Mobile' : 'WEB';
 
-      // Update toggle icon: show the icon of the OTHER mode (what you'll switch to)
+      // Update toggle icon: show the icon of the CURRENT mode (matches the badge)
       if (currentView === 'mobile') {
-        iconPhone.classList.add('hidden');
-        iconMonitor.classList.remove('hidden');
-      } else {
         iconPhone.classList.remove('hidden');
         iconMonitor.classList.add('hidden');
+      } else {
+        iconPhone.classList.add('hidden');
+        iconMonitor.classList.remove('hidden');
       }
     }
     applyViewMode();

package/skills/stitch-showcase/references/viewer.html

@@ -219,6 +219,21 @@
       var frameMobile = document.getElementById('viewer-frame-mobile');
       var frameWeb = document.getElementById('viewer-frame-web');
 
+      // Inject scrollbar-hiding CSS into iframes after load (cosmetic, viewer-level only).
+      // Keeps source HTMLs untouched so they're clean for downstream handoff.
+      function injectScrollbarCSS(frame) {
+        try {
+          var doc = frame.contentDocument || frame.contentWindow.document;
+          if (!doc || doc.getElementById('__no-scrollbar-style')) return;
+          var style = doc.createElement('style');
+          style.id = '__no-scrollbar-style';
+          style.textContent = '*::-webkit-scrollbar{display:none!important}*{scrollbar-width:none!important;-ms-overflow-style:none!important}';
+          doc.head.appendChild(style);
+        } catch (e) { /* cross-origin or not yet ready */ }
+      }
+      frameMobile.addEventListener('load', function () { injectScrollbarCSS(frameMobile); });
+      frameWeb.addEventListener('load', function () { injectScrollbarCSS(frameWeb); });
+
       var screens = SCREENS;
       var currentIndex = 0;
       var VIEW_KEY = 'showcase-view-mode-' + '{{PROJECT_SLUG}}';
@@ -230,13 +245,13 @@
         root.classList.remove('view-mobile', 'view-web');
         root.classList.add('view-' + currentView);
 
-        // Toggle icon shows what you'll switch TO
+        // Toggle icon shows the CURRENT mode (matches the badge)
         if (currentView === 'mobile') {
-          iconPhone.classList.add('hidden');
-          iconMonitor.classList.remove('hidden');
-        } else {
           iconPhone.classList.remove('hidden');
           iconMonitor.classList.add('hidden');
+        } else {
+          iconPhone.classList.add('hidden');
+          iconMonitor.classList.remove('hidden');
         }
 
         // Recalc phone scaling when switching to mobile

package/skills/stitch-showcase/scripts/build_showcase.py

@@ -106,6 +106,18 @@ def build(source_dir: str, project_type: str = None, project_name: str = None) -
         print("Error: no screens found (no zips or folders with code.html).", file=sys.stderr)
         sys.exit(1)
 
+    # Copy shared asset folders (images, fonts, css, js) referenced by relative paths in HTMLs.
+    # Searches in source/, then source.parent/ (project root). Skips if already copied.
+    for asset_name in ('images', 'fonts', 'css', 'js'):
+        for candidate_root in (source, source.parent):
+            candidate = candidate_root / asset_name
+            if candidate.is_dir():
+                dest = assets_dir / asset_name
+                if not dest.exists():
+                    shutil.copytree(candidate, dest)
+                    print(f"  ✓ Copied shared {asset_name}/ from {candidate_root.name}/")
+                break
+
     # Enrich with DESIGN.md metadata
     screens = _enrich_screens(screens_raw, metadata, source)
 
@@ -160,6 +172,18 @@ def build_context(source_dir: str, project_type: str = None, project_name: str =
         print("Error: no screens found (no zips or folders with code.html).", file=sys.stderr)
         sys.exit(1)
 
+    # Copy shared asset folders (images, fonts, css, js) referenced by relative paths in HTMLs.
+    # Searches in source/, then source.parent/ (project root). Skips if already copied.
+    for asset_name in ('images', 'fonts', 'css', 'js'):
+        for candidate_root in (source, source.parent):
+            candidate = candidate_root / asset_name
+            if candidate.is_dir():
+                dest = assets_dir / asset_name
+                if not dest.exists():
+                    shutil.copytree(candidate, dest)
+                    print(f"  ✓ Copied shared {asset_name}/ from {candidate_root.name}/")
+                break
+
     # Enrich with DESIGN.md metadata
     screens = _enrich_screens(screens_raw, metadata, source)
 

package/skills/stitch-showcase/scripts/extract_zips.py

@@ -136,16 +136,11 @@ def _process_dir(dir_path: Path, slug: str, assets: Path) -> dict | None:
     }
 
 
-_NO_SCROLLBAR_CSS = '<style>*::-webkit-scrollbar{display:none!important}*{scrollbar-width:none!important;-ms-overflow-style:none!important}</style>'
-
 def _copy_html(src: Path, dst: Path) -> None:
-    """Copy HTML injecting scrollbar-hiding CSS into <head>."""
-    text = src.read_text(encoding="utf-8", errors="ignore")
-    if "</head>" in text:
-        text = text.replace("</head>", f"{_NO_SCROLLBAR_CSS}</head>", 1)
-    elif "<body" in text:
-        text = text.replace("<body", f"{_NO_SCROLLBAR_CSS}<body", 1)
-    dst.write_text(text, encoding="utf-8")
+    """Copy HTML verbatim. Scrollbar-hiding CSS is now injected at viewer level
+    (see references/viewer.html), keeping the source HTML untouched so it can be
+    handed off cleanly to downstream tools (e.g., Laravel Blade conversion)."""
+    shutil.copy2(src, dst)
 
 
 def _find_file(root: Path, filename: str) -> Path | None: