opencode-skills-collection 3.0.34 → 3.0.35

package/bundled-skills/user-thoughts/scripts/show_raw.py

@@ -0,0 +1,42 @@
+"""Show unprocessed raw files."""
+import sys
+from pathlib import Path
+
+from common import find_ustht, is_processed
+
+HELP = """Usage: python show_raw.py [--help]
+
+Show unprocessed #raw/ files, including filenames, entry counts, and content.
+"""
+
+
+def main():
+    if "--help" in sys.argv or "-h" in sys.argv:
+        print(HELP)
+        sys.exit(0)
+
+    ustht = find_ustht()
+    if ustht is None:
+        print("Error: .ustht/ was not found. Run /ustht init first.")
+        sys.exit(1)
+
+    raw_dir = ustht / "raw"
+    if not raw_dir.exists():
+        print("No unprocessed records.")
+        return
+
+    files = [f for f in sorted(raw_dir.glob("*.md"), reverse=True) if not is_processed(f)]
+    if not files:
+        print("No unprocessed records. All raw files are marked processed.")
+        return
+
+    for f in files:
+        content = f.read_text(encoding="utf-8").strip()
+        entry_count = sum(1 for line in content.splitlines() if line.strip().startswith("- ["))
+        print(f"#{f.name} ({entry_count} unprocessed entries):")
+        print(content)
+        print()
+
+
+if __name__ == "__main__":
+    main()

package/bundled-skills/user-thoughts/scripts/sortin.py

@@ -0,0 +1,211 @@
+"""Soft-maintain raw user-thought entries into mdbase."""
+import re
+import sys
+from collections import defaultdict
+from datetime import datetime
+from pathlib import Path
+
+from common import find_ustht, read_define_ini, write_define_ini, is_processed, validate_dim_name
+
+HELP = """Usage: python sortin.py [--dry] [--help]
+
+Soft maintenance: parse unprocessed #raw/*.md files, append entries to matching
+mdbase dimensions, mark raw files as processed, and update LAST_SORTIN.
+
+Options:
+  --dry   Preview changes without writing
+  --help  Show this help text
+"""
+
+
+def parse_raw_file(filepath: Path):
+    """Parse raw entries from one file."""
+    entries = []
+    date = filepath.stem.split("-", 3)
+    if len(date) >= 3:
+        date = "-".join(date[:3])
+    else:
+        date = datetime.now().strftime("%Y-%m-%d")
+
+    for line in filepath.read_text(encoding="utf-8").splitlines():
+        line = line.strip()
+        match = re.match(r"^- \[(\d{2}:\d{2})\] (.*)$", line)
+        if not match:
+            continue
+        time, content = match.groups()
+        dim = "general"
+        text = content
+        if " | suggested-dim:" in content:
+            text, dim = content.rsplit(" | suggested-dim:", 1)
+            dim = dim.strip()
+            if not validate_dim_name(dim):
+                dim = "general"
+        entries.append({"time": time, "text": text.strip(), "dimension": dim, "date": date})
+    return entries
+
+
+def dim_path(mdbase: Path, dim: str) -> Path:
+    """Return the target file path for a dimension."""
+    if dim == "backlog":
+        return mdbase / "backlog.md"
+    return mdbase / "details" / f"{dim}.md"
+
+
+def count_entries(path: Path) -> int:
+    if not path.exists():
+        return 0
+    return sum(1 for line in path.read_text(encoding="utf-8").splitlines() if line.strip().startswith("- "))
+
+
+def append_entries(path: Path, entries):
+    """Append entries grouped by date to one dimension file."""
+    by_date = defaultdict(list)
+    for entry in entries:
+        by_date[entry["date"]].append(entry)
+
+    path.parent.mkdir(parents=True, exist_ok=True)
+    if not path.exists():
+        title = path.stem.replace("-", " ").title()
+        path.write_text(f"# {title}\n\n> Project memory for `{path.stem}`.\n\n", encoding="utf-8")
+
+    content = path.read_text(encoding="utf-8").rstrip()
+    for date, date_entries in sorted(by_date.items()):
+        lines = [f"- {entry['text']}" for entry in date_entries]
+        block = "\n".join(lines)
+        heading = f"## {date}"
+        if heading in content:
+            content_lines = content.splitlines()
+            heading_idx = next(i for i, line in enumerate(content_lines) if line.strip() == heading)
+            insert_idx = len(content_lines)
+            for i in range(heading_idx + 1, len(content_lines)):
+                if content_lines[i].startswith("## "):
+                    insert_idx = i
+                    break
+            before = content_lines[:insert_idx]
+            after = content_lines[insert_idx:]
+            if before and before[-1].strip():
+                before.append("")
+            before.extend(lines)
+            if after:
+                before.append("")
+                before.extend(after)
+            content = "\n".join(before).rstrip()
+        else:
+            content = f"{content}\n\n{heading}\n\n{block}".rstrip()
+    path.write_text(content + "\n", encoding="utf-8")
+
+
+def mark_processed(filepath: Path):
+    """Insert the processed marker at the top of a raw file."""
+    content = filepath.read_text(encoding="utf-8")
+    if content.split("\n", 1)[0].strip() != "<!-- processed -->":
+        filepath.write_text("<!-- processed -->\n" + content, encoding="utf-8")
+
+
+def update_index(mdbase: Path):
+    """Rebuild mdbase/README.ai.md with dimension counts."""
+    now = datetime.now().strftime("%Y-%m-%d %H:%M")
+    details = mdbase / "details"
+    dims = []
+    if details.exists():
+        dims = sorted(p.relative_to(details).with_suffix("").as_posix() for p in details.rglob("*.md"))
+
+    rows = ["| File | Dimension | Entries |", "|------|-----------|---------|"]
+    backlog = mdbase / "backlog.md"
+    if backlog.exists():
+        rows.append(f"| [backlog.md](backlog.md) | backlog | {count_entries(backlog)} |")
+    for dim in dims:
+        path = details / f"{dim}.md"
+        rows.append(f"| [details/{dim}.md](details/{dim}.md) | {dim} | {count_entries(path)} |")
+
+    content = "\n".join([
+        "# user-thoughts mdbase Index",
+        "",
+        "This directory stores user-provided project decisions, constraints, preferences, and plans.",
+        "",
+        f"Last updated: {now}",
+        "",
+        "## Maintenance Rules",
+        "",
+        "- Preserve user wording and constraints.",
+        "- Append entries by date under `## yyyy-mm-dd` headings.",
+        "- Prefer existing dimensions before creating new ones.",
+        "- Mark deprecated content instead of silently deleting history.",
+        "",
+        "## Document Index",
+        "",
+        *rows,
+        "",
+    ])
+    (mdbase / "README.ai.md").write_text(content, encoding="utf-8")
+
+
+def main():
+    if "--help" in sys.argv or "-h" in sys.argv:
+        print(HELP)
+        sys.exit(0)
+
+    dry = "--dry" in sys.argv
+    ustht = find_ustht()
+    if ustht is None:
+        print("Error: .ustht/ was not found. Run /ustht init first.")
+        sys.exit(1)
+
+    cfg = read_define_ini(ustht)
+    if cfg.get("SKILL_STATUS") == "off":
+        print("SKILL is off; write ignored. Run /ustht skill on to enable it.")
+        sys.exit(0)
+
+    raw_dir = ustht / "raw"
+    if not raw_dir.exists():
+        print("No unprocessed records.")
+        return
+
+    raw_files = [f for f in sorted(raw_dir.glob("*.md")) if not is_processed(f)]
+    if not raw_files:
+        print("No unprocessed records. All raw files are marked processed.")
+        return
+
+    all_entries = []
+    entries_by_file = {}
+    for f in raw_files:
+        entries = parse_raw_file(f)
+        entries_by_file[f] = entries
+        all_entries.extend(entries)
+
+    if not all_entries:
+        print("No valid entries found in raw files.")
+        return
+
+    grouped = defaultdict(list)
+    for entry in all_entries:
+        grouped[entry["dimension"]].append(entry)
+
+    print("Preview mode:" if dry else f"Soft maintenance complete. Processed {len(all_entries)} thoughts:")
+    mdbase = ustht / "mdbase"
+    for dim, entries in sorted(grouped.items()):
+        target = dim_path(mdbase, dim)
+        label = f"{dim}.md" if target.exists() else f"{dim}.md [new dimension]"
+        sample = entries[0]["text"][:60]
+        print(f"  -> {label}: +{len(entries)} ({sample})")
+
+    if dry:
+        print(f"  {len(all_entries)} total entries; no files were changed.")
+        return
+
+    for dim, entries in grouped.items():
+        append_entries(dim_path(mdbase, dim), entries)
+
+    for f in raw_files:
+        if entries_by_file.get(f):
+            mark_processed(f)
+
+    now = datetime.now().strftime("%Y-%m-%d %H:%M")
+    cfg["LAST_SORTIN"] = now
+    write_define_ini(ustht, cfg)
+    update_index(mdbase)
+    print(f"  LAST_SORTIN updated to {now}")
+
+
+if __name__ == "__main__":
+    main()

package/bundled-skills/user-thoughts/scripts/status.py

@@ -0,0 +1,56 @@
+"""Show current user-thoughts runtime status."""
+import sys
+from pathlib import Path
+
+from common import find_ustht, read_define_ini, is_processed
+
+HELP = """Usage: python status.py [--help]
+
+Show SKILL_STATUS, INSTANT_STATUS, LAST_SORTIN, raw file counts, and mdbase
+dimension counts.
+"""
+
+
+def count_raw(raw_dir: Path):
+    """Return total and unprocessed raw file counts."""
+    if not raw_dir.exists():
+        return 0, 0
+    files = list(raw_dir.glob("*.md"))
+    unprocessed = sum(1 for f in files if not is_processed(f))
+    return len(files), unprocessed
+
+
+def count_dims(mdbase: Path):
+    """Count dimension files under mdbase/details/."""
+    details = mdbase / "details"
+    if not details.exists():
+        return 0
+    return len(list(details.rglob("*.md")))
+
+
+def main():
+    if "--help" in sys.argv or "-h" in sys.argv:
+        print(HELP)
+        sys.exit(0)
+
+    ustht = find_ustht()
+    if ustht is None:
+        print("Error: .ustht/ was not found. Run /ustht init first.")
+        sys.exit(1)
+
+    cfg = read_define_ini(ustht)
+    skill_status = cfg.get("SKILL_STATUS", "unknown")
+    instant_status = cfg.get("INSTANT_STATUS", "unknown")
+    last_sortin = cfg.get("LAST_SORTIN", "never") or "never"
+    total_raw, unprocessed_raw = count_raw(ustht / "raw")
+    dims = count_dims(ustht / "mdbase")
+
+    print(f"SKILL_STATUS={skill_status}")
+    print(f"INSTANT_STATUS={instant_status}")
+    print(f"LAST_SORTIN={last_sortin}")
+    print(f"raw={unprocessed_raw} unprocessed / {total_raw} total")
+    print(f"dims={dims}")
+
+
+if __name__ == "__main__":
+    main()

package/bundled-skills/user-thoughts/scripts/toggle.py

@@ -0,0 +1,68 @@
+"""Toggle SKILL_STATUS and INSTANT_STATUS."""
+import sys
+
+from common import find_ustht, read_define_ini, write_define_ini
+
+HELP = """Usage: python toggle.py skill|instant [on|off] [--help]
+
+Subcommands:
+  skill           Show SKILL_STATUS
+  skill on|off    Set SKILL_STATUS
+  instant         Show INSTANT_STATUS
+  instant on|off  Set INSTANT_STATUS
+
+Note: instant on requires SKILL_STATUS=on.
+"""
+
+
+def main():
+    if "--help" in sys.argv or "-h" in sys.argv:
+        print(HELP)
+        sys.exit(0)
+
+    ustht = find_ustht()
+    if ustht is None:
+        print("Error: .ustht/ was not found. Run /ustht init first.")
+        sys.exit(1)
+
+    if len(sys.argv) < 2:
+        print(f"Usage: {sys.argv[0]} skill|instant [on|off]")
+        sys.exit(1)
+
+    cmd = sys.argv[1]
+    if cmd not in {"skill", "instant"}:
+        print(f"Unknown command: {cmd}. Available: skill, instant")
+        sys.exit(1)
+
+    cfg = read_define_ini(ustht)
+    ini_key = "SKILL_STATUS" if cmd == "skill" else "INSTANT_STATUS"
+
+    if len(sys.argv) == 2:
+        print(f"{ini_key}={cfg.get(ini_key, 'unknown')}")
+        return
+
+    val = sys.argv[2]
+    if val not in {"on", "off"}:
+        print(f"Invalid value: {val}. Available values: on | off")
+        sys.exit(1)
+
+    if cmd == "instant" and val == "on" and cfg.get("SKILL_STATUS") == "off":
+        print("SKILL is off; instant capture cannot be enabled. Run /ustht skill on first.")
+        sys.exit(1)
+
+    cfg[ini_key] = val
+    if cmd == "skill" and val == "off":
+        cfg["INSTANT_STATUS"] = "off"
+    write_define_ini(ustht, cfg)
+
+    if cmd == "skill":
+        if val == "off":
+            print("SKILL is off. Instant capture has been paused.")
+        else:
+            print("SKILL is on.")
+    else:
+        print("Instant capture is on." if val == "on" else "Instant capture is off.")
+
+
+if __name__ == "__main__":
+    main()

package/bundled-skills/user-thoughts/scripts/write_raw.py

@@ -0,0 +1,106 @@
+"""Append one thought to today's raw file."""
+import sys
+from datetime import datetime
+from pathlib import Path
+
+from common import find_ustht, read_define_ini, validate_dim_name
+
+HELP = """Usage: python write_raw.py "thought text" [--dim dimension] [--help]
+
+Append one thought to today's #raw/ markdown file.
+
+Arguments:
+  "thought text"     Thought text to record (required)
+  --dim dimension    Suggested dimension, such as rules or ui/outline
+  --help             Show this help text
+
+Behavior:
+  - If today's raw file is already processed, creates a numbered file such as 2026-06-01-2.md.
+  - If the day has more than five raw entries, suggests /ustht sortin.
+  - If SKILL_STATUS=off, exits without writing.
+"""
+
+
+def count_today_raw(raw_dir: Path) -> int:
+    """Count unprocessed entries across today's raw files."""
+    today = datetime.now().strftime("%Y-%m-%d")
+    count = 0
+    for f in sorted(raw_dir.glob(f"{today}*.md")):
+        content = f.read_text(encoding="utf-8")
+        first_line = content.split("\n", 1)[0].strip()
+        if first_line == "<!-- processed -->":
+            continue
+        count += sum(1 for line in content.splitlines() if line.strip().startswith("- ["))
+    return count
+
+
+def main():
+    if "--help" in sys.argv or "-h" in sys.argv:
+        print(HELP)
+        sys.exit(0)
+
+    ustht = find_ustht()
+    if ustht is None:
+        print("Error: .ustht/ was not found. Run /ustht init first.")
+        sys.exit(1)
+
+    cfg = read_define_ini(ustht)
+    if cfg.get("SKILL_STATUS") == "off":
+        print("SKILL is off; write ignored.")
+        sys.exit(0)
+
+    thought = None
+    dim = None
+    args = sys.argv[1:]
+    i = 0
+    while i < len(args):
+        if args[i] == "--dim" and i + 1 < len(args):
+            dim = args[i + 1]
+            i += 2
+        elif thought is None:
+            thought = args[i]
+            i += 1
+        else:
+            i += 1
+
+    if not thought:
+        print("Error: missing thought text.")
+        print(f"Usage: {sys.argv[0]} \"thought text\" [--dim dimension]")
+        sys.exit(1)
+
+    if dim and not validate_dim_name(dim):
+        print(f"Invalid dimension name: {dim}. Use lowercase letters, digits, hyphens, and optional / subdirectories.")
+        sys.exit(1)
+
+    raw_dir = ustht / "raw"
+    raw_dir.mkdir(exist_ok=True)
+
+    today = datetime.now().strftime("%Y-%m-%d")
+    now = datetime.now().strftime("%H:%M")
+    raw_file = raw_dir / f"{today}.md"
+
+    if raw_file.exists():
+        first_line = raw_file.read_text(encoding="utf-8").split("\n", 1)[0].strip()
+        if first_line == "<!-- processed -->":
+            seq = 2
+            while (raw_dir / f"{today}-{seq}.md").exists():
+                seq += 1
+            raw_file = raw_dir / f"{today}-{seq}.md"
+
+    thought_clean = thought.replace("\n", " ").replace("\r", "")
+    suffix = f" | suggested-dim:{dim}" if dim else ""
+    entry = f"- [{now}] {thought_clean}{suffix}"
+
+    if raw_file.exists():
+        content = raw_file.read_text(encoding="utf-8").rstrip()
+        raw_file.write_text(f"{content}\n{entry}\n", encoding="utf-8")
+    else:
+        raw_file.write_text(f"{entry}\n", encoding="utf-8")
+
+    count = count_today_raw(raw_dir)
+    if count > 5:
+        print(f"Today has {count} recorded thoughts. Consider running /ustht sortin.")
+
+
+if __name__ == "__main__":
+    main()

package/bundled-skills/vibe-code-cleanup/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vibe-code-cleanup
-description: "Safe production cleanup and hardening for vibe-coded fullstack apps (Next.js, React, Node.js, etc.). Removes dead imports, unused files, broken references, and standardizes helpers without breaking routes or APIs."
+description: "Safe production cleanup and hardening for vibe-coded fullstack apps (Next.js, React, Node.js, etc.). Removes dead imports, unused files, and broken references without breaking routes or APIs."
 category: fullstack
 risk: safe
 source: self
@@ -48,8 +48,8 @@ Before changing anything, map the codebase:
 
 ```bash
 # List all pages/routes
-find . -path "*/app/**/page.{js,jsx,ts,tsx}" | sort
-find . -path "*/pages/**/*.{js,jsx,ts,tsx}" | grep -v "_" | sort
+find . -type f \( -name 'page.js' -o -name 'page.jsx' -o -name 'page.ts' -o -name 'page.tsx' \)
+find pages -type f \( -name '*.js' -o -name '*.jsx' -o -name '*.ts' -o -name '*.tsx' \) | rg -v '/_' | sort
 
 # Find broken imports (TS projects)
 npx tsc --noEmit 2>&1 | head -80
@@ -185,7 +185,7 @@ If build or typecheck breaks → **revert the last batch** before continuing.
 
 Each commit should be a single logical unit:
 
-```
+```text
 fix: remove broken import in app/blog/page.js
 refactor: consolidate social metadata into lib/socialMetadata.js  
 chore: remove verified-unused utils/oldHelper.js

package/bundled-skills/vibecode-production-qa-validator/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vibecode-production-qa-validator
-description: "End-to-end production QA, build verification, and launch-readiness checklist for fullstack Next.js apps before going live or shipping a major update. Covers TypeScript, linting, tests, build, SEO tags, route regression, and sitemap validation."
+description: "End-to-end production QA, build verification, and launch-readiness checklist for fullstack Next.js apps. Covers TypeScript, linting, tests, build, SEO tags, route regression, and sitemap validation."
 category: devops
 risk: safe
 source: self
@@ -69,6 +69,7 @@ grep "Static pages\|○\|●" build.log | tail -5
 ```
 
 ### Route symbols explained
+
 | Symbol | Meaning | Expected? |
 |--------|---------|-----------|
 | `○` | Static (rendered at build time) | ✓ Good for most pages |
@@ -179,7 +180,7 @@ git status | grep -E "\.next|node_modules"
 ```
 
 Good commit message format:
-```
+```text
 type(scope): brief description
 
 fix(seo): add canonical tags to all blog pages

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-skills-collection",
-  "version": "3.0.34",
+  "version": "3.0.35",
   "description": "OpenCode CLI plugin that automatically downloads and keeps skills up to date.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/skills_index.json

@@ -25211,7 +25211,7 @@
     "path": "skills/schema-markup-generator",
     "category": "seo",
     "name": "schema-markup-generator",
-    "description": "Generate and implement JSON-LD structured data for web apps, tool pages, blogs, FAQs, and SaaS sites. Supports WebSite, SoftwareApplication, BlogPosting, FAQPage, HowTo, BreadcrumbList, and Organization schemas.",
+    "description": "Generate and implement JSON-LD structured data for web apps, blogs, FAQs, and SaaS sites. Supports WebSite, SoftwareApplication, BlogPosting, FAQPage, HowTo, and more.",
     "risk": "safe",
     "source": "self",
     "date_added": "2026-05-31",
@@ -27561,7 +27561,7 @@
     "path": "skills/social-metadata-hardening",
     "category": "seo",
     "name": "social-metadata-hardening",
-    "description": "Fix social sharing previews so URLs render as rich cards on Facebook, LinkedIn, X/Twitter, WhatsApp, Telegram, Slack, and Discord. Covers OG tags, Twitter cards, absolute image URLs, and metadata debugging.",
+    "description": "Fix social sharing previews so URLs render as rich cards on Facebook, LinkedIn, X/Twitter, WhatsApp, Telegram, and more. Covers OG tags, Twitter cards, absolute image URLs, and debugging.",
     "risk": "safe",
     "source": "self",
     "date_added": "2026-05-31",
@@ -30732,6 +30732,28 @@
       "reasons": []
     }
   },
+  {
+    "id": "user-thoughts",
+    "path": "skills/user-thoughts",
+    "category": "web-development",
+    "name": "user-thoughts",
+    "description": "Persist user decisions and project constraints to mdbase across sessions. Trigger on /user-thoughts or /ustht, or when the user discusses architecture, tech stack, rules, UI/UX, or project memory.",
+    "risk": "safe",
+    "source": "https://github.com/JularDepick/user-thoughts.SKILL",
+    "date_added": "2026-05-31",
+    "plugin": {
+      "targets": {
+        "codex": "supported",
+        "claude": "supported"
+      },
+      "setup": {
+        "type": "none",
+        "summary": "",
+        "docs": null
+      },
+      "reasons": []
+    }
+  },
   {
     "id": "using-git-worktrees",
     "path": "skills/using-git-worktrees",
@@ -31225,7 +31247,7 @@
     "path": "skills/vibe-code-cleanup",
     "category": "fullstack",
     "name": "vibe-code-cleanup",
-    "description": "Safe production cleanup and hardening for vibe-coded fullstack apps (Next.js, React, Node.js, etc.). Removes dead imports, unused files, broken references, and standardizes helpers without breaking routes or APIs.",
+    "description": "Safe production cleanup and hardening for vibe-coded fullstack apps (Next.js, React, Node.js, etc.). Removes dead imports, unused files, and broken references without breaking routes or APIs.",
     "risk": "safe",
     "source": "self",
     "date_added": "2026-05-31",
@@ -31247,7 +31269,7 @@
     "path": "skills/vibecode-production-qa-validator",
     "category": "devops",
     "name": "vibecode-production-qa-validator",
-    "description": "End-to-end production QA, build verification, and launch-readiness checklist for fullstack Next.js apps before going live or shipping a major update. Covers TypeScript, linting, tests, build, SEO tags, route regression, and sitemap validation.",
+    "description": "End-to-end production QA, build verification, and launch-readiness checklist for fullstack Next.js apps. Covers TypeScript, linting, tests, build, SEO tags, route regression, and sitemap validation.",
     "risk": "safe",
     "source": "self",
     "date_added": "2026-05-31",