opendevbrowser 0.0.12 → 0.0.16

package/skills/opendevbrowser-product-presentation-asset/artifacts/asset-pack-assembly.md

@@ -0,0 +1,23 @@
+# Asset Pack Assembly
+
+## Inputs
+
+- product URL or product name
+- provider hint (optional)
+- output directory (optional)
+
+## Build sequence
+
+1. Collect base product pack (`collect-product.sh`)
+2. Ensure screenshots/images exist
+3. Validate manifest schema fields
+4. Generate video brief (`render-video-brief.sh`)
+5. Review claim-to-evidence mapping (`claims-evidence-map.md`)
+6. Review shot sequence and CTA consistency
+
+## Release checks
+
+- pricing timestamp is recent
+- screenshot/image files are present and readable
+- copy claims map to feature evidence
+- every promoted claim is backed by a concrete asset path

package/skills/opendevbrowser-product-presentation-asset/artifacts/ugc-creative-guide.md

@@ -0,0 +1,21 @@
+# UGC Creative Guide
+
+## Creative pillars
+
+- Authenticity over polish
+- Problem-first storytelling
+- Demonstrable product proof
+
+## Shot rhythm
+
+1. Hook (problem + promise)
+2. Product reveal
+3. Feature demonstration
+4. Outcome proof
+5. CTA
+
+## Message constraints
+
+- Keep one primary benefit per short
+- Keep language conversational
+- Avoid unsupported superlatives

package/skills/opendevbrowser-product-presentation-asset/assets/templates/claims-evidence-map.md

@@ -0,0 +1,5 @@
+# Claims Evidence Map
+
+| Claim | Evidence Asset | Source Field | Verified |
+|---|---|---|---|
+|  |  |  | no |

package/skills/opendevbrowser-product-presentation-asset/assets/templates/copy.md

@@ -0,0 +1,5 @@
+# Product Copy
+
+- Headline:
+- Value proposition:
+- CTA:

package/skills/opendevbrowser-product-presentation-asset/assets/templates/features.md

@@ -0,0 +1,4 @@
+# Product Features
+
+- Feature 1
+- Feature 2

package/skills/opendevbrowser-product-presentation-asset/assets/templates/manifest.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ProductAssetManifest",
+  "type": "object",
+  "required": ["run_id", "created_at", "source_url", "provider", "product", "assets"],
+  "properties": {
+    "run_id": { "type": "string" },
+    "created_at": { "type": "string", "format": "date-time" },
+    "source_url": { "type": "string" },
+    "provider": { "type": "string" },
+    "product": { "type": "object" },
+    "assets": { "type": "object" }
+  }
+}

package/skills/opendevbrowser-product-presentation-asset/assets/templates/shot-list.md

@@ -0,0 +1,7 @@
+# Shot List
+
+| Scene | Goal | Asset | Voiceover | Duration |
+|---|---|---|---|---:|
+| 1 | Hook | screenshots/screenshot-01.png | | 2s |
+| 2 | Feature proof | images/image-01.jpg | | 4s |
+| 3 | Outcome + CTA | images/image-02.jpg | | 4s |

package/skills/opendevbrowser-product-presentation-asset/assets/templates/ugc-concepts.md

@@ -0,0 +1,17 @@
+# UGC Concepts
+
+## Hook ideas
+
+- "I wish I had this earlier for <problem>."
+- "This fixed my <pain point> in minutes."
+
+## Proof patterns
+
+- before/after usage
+- side-by-side comparison
+- time-to-result demonstration
+
+## CTA patterns
+
+- direct value CTA
+- urgency tied to verified pricing window

package/skills/opendevbrowser-product-presentation-asset/assets/templates/user-actions.md

@@ -0,0 +1,7 @@
+# User Action Checklist
+
+- [ ] Collected assets from target product
+- [ ] Reviewed manifest fields for correctness
+- [ ] Generated video brief files
+- [ ] Confirmed pricing recency and currency
+- [ ] Approved shot order and CTA

package/skills/opendevbrowser-product-presentation-asset/assets/templates/video-assembly.md

@@ -0,0 +1,18 @@
+# Video Assembly Instructions
+
+## Assets
+
+- Manifest: `manifest.json`
+- Product metadata: `product.json`
+- Pricing: `pricing.json`
+- Copy and features: `copy.md`, `features.md`
+- Visuals: `images/*`, `screenshots/*`
+- Claim evidence map: `claims-evidence-map.md`
+
+## Assembly Steps
+
+1. Build script from top 3 verified benefits.
+2. Match each line to one visual asset.
+3. Create sequence: hook -> proof -> CTA.
+4. Verify all price/discount statements against `pricing.json`.
+5. Mark `claims-evidence-map.md` rows as verified before publishing.

package/skills/opendevbrowser-product-presentation-asset/examples/sample-input.json

@@ -0,0 +1,6 @@
+{
+  "product_url": "https://example.com/product/123",
+  "include_screenshots": true,
+  "include_all_images": true,
+  "include_copy": true
+}

package/skills/opendevbrowser-product-presentation-asset/examples/sample-manifest.json

@@ -0,0 +1,18 @@
+{
+  "run_id": "example-run-id",
+  "created_at": "2026-02-16T00:00:00.000Z",
+  "source_url": "https://example.com/product/123",
+  "provider": "shopping/others",
+  "product": {
+    "title": "Example Product",
+    "brand": "Example",
+    "price": { "amount": 29.99, "currency": "USD", "retrieved_at": "2026-02-16T00:00:00.000Z" },
+    "features": ["Feature 1", "Feature 2"],
+    "copy": "Example copy"
+  },
+  "assets": {
+    "images": ["images/image-01.jpg"],
+    "screenshots": ["screenshots/screenshot-01.png"],
+    "raw": ["raw/source-record.json"]
+  }
+}

package/skills/opendevbrowser-product-presentation-asset/scripts/capture-screenshots.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: capture-screenshots.sh <product-url>"
+  exit 1
+fi
+
+opendevbrowser product-video run --product-url "$1" --include-screenshots --include-all-images=false

package/skills/opendevbrowser-product-presentation-asset/scripts/collect-product.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: collect-product.sh <product-url|product-name>"
+  exit 1
+fi
+
+VALUE="$1"
+if [[ "$VALUE" == http* ]]; then
+  opendevbrowser product-video run --product-url "$VALUE"
+else
+  opendevbrowser product-video run --product-name "$VALUE"
+fi

package/skills/opendevbrowser-product-presentation-asset/scripts/download-images.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: download-images.sh <product-url>"
+  exit 1
+fi
+
+opendevbrowser product-video run --product-url "$1" --include-all-images --include-screenshots=false

package/skills/opendevbrowser-product-presentation-asset/scripts/render-video-brief.sh

@@ -0,0 +1,96 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: render-video-brief.sh <manifest-json> [output-dir]" >&2
+  exit 1
+fi
+
+manifest="$1"
+outdir="${2:-$(dirname "$manifest")}" 
+mkdir -p "$outdir"
+
+node - "$manifest" "$outdir" <<'NODE'
+const fs = require("fs");
+const path = require("path");
+
+const manifestPath = process.argv[2];
+const outdir = process.argv[3];
+
+const data = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+const product = data.product || {};
+const pricing = product.price || {};
+
+const title = product.title || "Unknown product";
+const brand = product.brand || "Unknown brand";
+const amount = typeof pricing.amount === "number" ? pricing.amount.toFixed(2) : "N/A";
+const currency = pricing.currency || "USD";
+const features = Array.isArray(product.features) ? product.features.slice(0, 5) : [];
+const copy = typeof product.copy === "string" ? product.copy.trim().slice(0, 600) : "";
+const images = Array.isArray(data?.assets?.images) ? data.assets.images : [];
+const screenshots = Array.isArray(data?.assets?.screenshots) ? data.assets.screenshots : [];
+
+const claimRows = (features.length ? features : ["Add verified feature claims"]).map((claim, index) => {
+  const evidence = screenshots[index] || images[index] || images[0] || screenshots[0] || "<asset>";
+  return `| ${claim} | ${evidence} | product.features[${index}] | no |`;
+});
+
+const videoBrief = [
+  "# Video Brief",
+  "",
+  `- Product: ${title}`,
+  `- Brand: ${brand}`,
+  `- Price: ${amount} ${currency}`,
+  "",
+  "## Verified Features",
+  ...(features.length ? features.map((entry) => `- ${entry}`) : ["- Add verified feature bullets"]),
+  "",
+  "## Suggested Hook",
+  `- "${title} solves <problem> faster with <core benefit>."`,
+  "",
+  "## Copy Input",
+  copy ? copy : "(No copy captured)",
+  "",
+  "## Assets",
+  `- Images: ${images.length}`,
+  `- Screenshots: ${screenshots.length}`,
+  "- Claims evidence map: claims-evidence-map.md"
+].join("\n");
+
+const shotList = [
+  "# Shot List",
+  "",
+  "| Scene | Goal | Asset | Voiceover | Duration |",
+  "|---|---|---|---|---:|",
+  `| 1 | Hook | ${screenshots[0] || images[0] || "<asset>"} | Problem + promise | 2s |`,
+  `| 2 | Feature demo | ${images[0] || screenshots[0] || "<asset>"} | Show proof | 4s |`,
+  `| 3 | Outcome + CTA | ${images[1] || screenshots[1] || images[0] || "<asset>"} | Benefit + CTA | 4s |`
+].join("\n");
+
+const ugcBrief = [
+  "# UGC Brief",
+  "",
+  "## Creator Direction",
+  "- Speak as a real user solving a real problem.",
+  "- Show product in use before listing specs.",
+  "- Keep claims aligned with captured assets and manifest data.",
+  "",
+  "## CTA",
+  "- Use one clear CTA tied to the strongest verified benefit."
+].join("\n");
+
+const claimsEvidenceMap = [
+  "# Claims Evidence Map",
+  "",
+  "| Claim | Evidence Asset | Source Field | Verified |",
+  "|---|---|---|---|",
+  ...claimRows
+].join("\n");
+
+fs.writeFileSync(path.join(outdir, "video-brief.md"), videoBrief);
+fs.writeFileSync(path.join(outdir, "shot-list.md"), shotList);
+fs.writeFileSync(path.join(outdir, "ugc-brief.md"), ugcBrief);
+fs.writeFileSync(path.join(outdir, "claims-evidence-map.md"), claimsEvidenceMap);
+
+process.stdout.write(`Video brief files written to ${outdir}\n`);
+NODE

package/skills/opendevbrowser-product-presentation-asset/scripts/validate-skill-assets.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+skill_file="$root/SKILL.md"
+
+required=(
+  "artifacts/asset-pack-assembly.md"
+  "artifacts/ugc-creative-guide.md"
+  "assets/templates/manifest.schema.json"
+  "assets/templates/copy.md"
+  "assets/templates/features.md"
+  "assets/templates/video-assembly.md"
+  "assets/templates/user-actions.md"
+  "assets/templates/ugc-concepts.md"
+  "assets/templates/shot-list.md"
+  "assets/templates/claims-evidence-map.md"
+  "scripts/collect-product.sh"
+  "scripts/capture-screenshots.sh"
+  "scripts/download-images.sh"
+  "scripts/write-manifest.sh"
+  "scripts/render-video-brief.sh"
+  "scripts/validate-skill-assets.sh"
+)
+
+status=0
+for rel in "${required[@]}"; do
+  if [[ ! -f "$root/$rel" ]]; then
+    echo "Missing required asset: $rel" >&2
+    status=1
+  fi
+  if ! grep -Fq "$rel" "$skill_file"; then
+    echo "SKILL.md missing reference: $rel" >&2
+    status=1
+  fi
+done
+
+for rel in scripts/collect-product.sh scripts/capture-screenshots.sh scripts/download-images.sh scripts/write-manifest.sh scripts/render-video-brief.sh scripts/validate-skill-assets.sh; do
+  if [[ -f "$root/$rel" && ! -x "$root/$rel" ]]; then
+    echo "Script is not executable: $rel" >&2
+    status=1
+  fi
+done
+
+if [[ -f "$root/assets/templates/manifest.schema.json" ]]; then
+  if ! node -e 'const fs=require("fs"); JSON.parse(fs.readFileSync(process.argv[1], "utf8"));' "$root/assets/templates/manifest.schema.json" >/dev/null 2>&1; then
+    echo "Invalid JSON template: assets/templates/manifest.schema.json" >&2
+    status=1
+  fi
+fi
+
+if [[ $status -ne 0 ]]; then
+  exit $status
+fi
+
+echo "Product presentation asset skill pack validated."

package/skills/opendevbrowser-product-presentation-asset/scripts/write-manifest.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 2 ]]; then
+  echo "Usage: write-manifest.sh <product-url|product-name> <output-dir>"
+  exit 1
+fi
+
+VALUE="$1"
+OUTDIR="$2"
+mkdir -p "$OUTDIR"
+
+cmd=(opendevbrowser product-video run --output-dir "$OUTDIR" --output-format json)
+if [[ "$VALUE" == http* ]]; then
+  cmd+=(--product-url "$VALUE")
+else
+  cmd+=(--product-name "$VALUE")
+fi
+
+json_output="$("${cmd[@]}")"
+printf '%s\n' "$json_output"
+
+bundle_path="$(printf '%s\n' "$json_output" | node -e 'const fs=require("fs");const input=fs.readFileSync(0,"utf8").split(/\r?\n/).map((line)=>line.trim()).filter(Boolean);let payload=null;for(const line of input){try{payload=JSON.parse(line);}catch{}}const p=payload?.data?.path; if(typeof p==="string") process.stdout.write(p);')"
+manifest_out="$OUTDIR/manifest.json"
+
+if [[ ! -f "$manifest_out" ]]; then
+  source_manifest=""
+  if [[ -n "$bundle_path" && -f "$bundle_path/manifest.json" ]]; then
+    source_manifest="$bundle_path/manifest.json"
+  else
+    source_manifest="$(find "$OUTDIR" -maxdepth 6 -type f -name manifest.json | head -n 1)"
+  fi
+  if [[ -n "$source_manifest" && -f "$source_manifest" ]]; then
+    cp "$source_manifest" "$manifest_out"
+  fi
+fi
+
+if [[ ! -f "$manifest_out" ]]; then
+  echo "Manifest not found in output dir: $OUTDIR" >&2
+  exit 2
+fi
+
+echo "Manifest ready: $manifest_out"

package/skills/opendevbrowser-research/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: opendevbrowser-research
+description: Deterministic multi-source research workflow with strict timebox and artifact outputs.
+version: 2.0.0
+---
+
+# Research Skill
+
+Use this skill when you need benchmark-style research across `web|community|social|shopping` with strict timebox semantics and stable output modes.
+
+## Pack Contents
+
+- `artifacts/research-workflows.md`
+- `assets/templates/compact.md`
+- `assets/templates/context.json`
+- `assets/templates/report.md`
+- `scripts/run-research.sh`
+- `scripts/render-output.sh`
+- `scripts/write-artifacts.sh`
+- `scripts/validate-skill-assets.sh`
+- Shared robustness matrix: `../opendevbrowser-best-practices/artifacts/browser-agent-known-issues-matrix.md`
+
+## Fast Start
+
+```bash
+./skills/opendevbrowser-research/scripts/validate-skill-assets.sh
+./skills/opendevbrowser-research/scripts/run-research.sh "browser automation" 30 context
+./skills/opendevbrowser-research/scripts/render-output.sh "browser automation" compact
+```
+
+## Core Rules
+
+- Define timebox first (`--days` or `--from/--to`).
+- Prefer explicit sources for high-stakes claims.
+- Persist artifacts and return reproducible paths.
+- Mark unsupported claims as tentative; do not overstate certainty.
+- Honor bounded retries and backoff windows under 429 pressure.
+
+## Parallel Multitab Alignment
+
+- Apply shared concurrency policy from `../opendevbrowser-best-practices/SKILL.md` ("Parallel Operations").
+- Run research acceptance in `managed`, `extension`, and `cdpConnect` where browser-backed evidence capture is used.
+- Keep provider query orchestration mode-agnostic; isolate browser interaction per session worker.
+
+## Robustness Coverage (Known-Issue Matrix)
+
+Matrix source: `../opendevbrowser-best-practices/artifacts/browser-agent-known-issues-matrix.md`
+
+- `ISSUE-06`: upstream throttling and retry discipline
+- `ISSUE-09`: pagination/result drift across sources
+- `ISSUE-10`: locale/currency normalization consistency
+- `ISSUE-12`: stale evidence and claim traceability
+
+## Workflow
+
+1. Resolve timebox (`days` or `from/to`).
+2. Choose sources (`auto|web|community|social|shopping|all`).
+3. Run `opendevbrowser research run`.
+4. Return requested mode output and artifact path.
+
+## Commands
+
+```bash
+opendevbrowser research run --topic "<topic>" --days 30 --mode context
+opendevbrowser research run --topic "<topic>" --source-selection all --mode json
+opendevbrowser research run --topic "<topic>" --sources web,shopping --mode md
+```
+
+## Notes
+
+- `auto` resolves to `web|community|social` in v1.
+- Use `--source-selection all` or `--sources shopping,...` to include shopping.
+- Use `--mode path` with `scripts/write-artifacts.sh` when you need replayable handoff bundles.

package/skills/opendevbrowser-research/artifacts/research-workflows.md

@@ -0,0 +1,29 @@
+# Research Workflows
+
+## Deterministic baseline workflow
+
+1. Define topic and strict time window
+2. Resolve source selection (`auto|all|explicit`)
+3. Run research workflow command
+4. Persist context/report artifacts
+5. Validate source diversity and freshness
+
+## Cross-source corroboration workflow
+
+1. Identify claims from first-pass output
+2. Require at least two independent source records for critical claims
+3. Mark unsupported claims as tentative
+4. Escalate when corroboration is missing
+
+## Backoff/retry workflow
+
+1. Detect repeated 429/upstream throttling
+2. Honor retry windows and bounded retries
+3. Resume from persisted context artifact
+4. Report partial coverage when limits persist
+
+## Compact handoff workflow
+
+1. Produce compact summary with key findings
+2. Include unresolved risks and missing evidence
+3. Attach artifact paths for replay

package/skills/opendevbrowser-research/assets/templates/compact.md

@@ -0,0 +1,7 @@
+# Compact Research Template
+
+- Top findings:
+- Source diversity:
+- Key risks:
+- Rate-limit/backoff notes:
+- Open evidence gaps:

package/skills/opendevbrowser-research/assets/templates/context.json

@@ -0,0 +1,18 @@
+{
+  "topic": "",
+  "timebox": {
+    "days": 30
+  },
+  "issue_ids": [
+    "ISSUE-06",
+    "ISSUE-09",
+    "ISSUE-10",
+    "ISSUE-12"
+  ],
+  "highlights": [],
+  "records": [],
+  "meta": {
+    "source_count": 0,
+    "warnings": []
+  }
+}

package/skills/opendevbrowser-research/assets/templates/report.md

@@ -0,0 +1,9 @@
+# Research Report
+
+## Executive Summary
+
+## Findings
+
+## Confidence and Gaps
+
+## Sources

package/skills/opendevbrowser-research/examples/sample-input.json

@@ -0,0 +1,6 @@
+{
+  "topic": "ai browser automation",
+  "days": 30,
+  "sourceSelection": "auto",
+  "mode": "context"
+}

package/skills/opendevbrowser-research/examples/sample-output.md

@@ -0,0 +1,4 @@
+# Sample Output
+
+1. Example finding one
+2. Example finding two

package/skills/opendevbrowser-research/scripts/render-output.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 2 ]]; then
+  echo "Usage: render-output.sh <topic> <mode>"
+  exit 1
+fi
+
+TOPIC="$1"
+MODE="$2"
+
+opendevbrowser research run --topic "$TOPIC" --mode "$MODE"

package/skills/opendevbrowser-research/scripts/run-research.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: run-research.sh <topic> [days] [mode] [source-selection] [sources]"
+  exit 1
+fi
+
+TOPIC="$1"
+DAYS="${2:-30}"
+MODE="${3:-context}"
+SOURCE_SELECTION="${4:-}"
+SOURCES="${5:-}"
+
+cmd=(opendevbrowser research run --topic "$TOPIC" --days "$DAYS" --mode "$MODE")
+if [[ -n "$SOURCE_SELECTION" ]]; then
+  cmd+=(--source-selection "$SOURCE_SELECTION")
+fi
+if [[ -n "$SOURCES" ]]; then
+  cmd+=(--sources "$SOURCES")
+fi
+
+"${cmd[@]}"

package/skills/opendevbrowser-research/scripts/validate-skill-assets.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+skill_file="$root/SKILL.md"
+
+required=(
+  "artifacts/research-workflows.md"
+  "assets/templates/compact.md"
+  "assets/templates/context.json"
+  "assets/templates/report.md"
+  "scripts/run-research.sh"
+  "scripts/render-output.sh"
+  "scripts/write-artifacts.sh"
+  "scripts/validate-skill-assets.sh"
+)
+
+status=0
+for rel in "${required[@]}"; do
+  if [[ ! -f "$root/$rel" ]]; then
+    echo "Missing required asset: $rel" >&2
+    status=1
+  fi
+  if ! grep -Fq "$rel" "$skill_file"; then
+    echo "SKILL.md missing reference: $rel" >&2
+    status=1
+  fi
+done
+
+for rel in scripts/run-research.sh scripts/render-output.sh scripts/write-artifacts.sh scripts/validate-skill-assets.sh; do
+  if [[ -f "$root/$rel" && ! -x "$root/$rel" ]]; then
+    echo "Script is not executable: $rel" >&2
+    status=1
+  fi
+done
+
+if [[ -f "$root/assets/templates/context.json" ]]; then
+  if ! node -e 'const fs=require("fs"); JSON.parse(fs.readFileSync(process.argv[1], "utf8"));' "$root/assets/templates/context.json" >/dev/null 2>&1; then
+    echo "Invalid JSON template: assets/templates/context.json" >&2
+    status=1
+  fi
+fi
+
+if [[ $status -ne 0 ]]; then
+  exit $status
+fi
+
+echo "Research skill assets validated."