| name | opendevbrowser-product-presentation-asset |
| description | Collects product metadata, copy, and optional visual assets into a local folder pack for video workflows. |
| version | 2.0.0 |
Product Presentation Asset Skill
Use this skill to build product-video input packs and readiness-gated assembly instructions for UGC-style content production.
Pack Contents
artifacts/asset-pack-assembly.mdartifacts/ugc-creative-guide.mdassets/templates/manifest.schema.jsonassets/templates/copy.mdassets/templates/features.mdassets/templates/video-assembly.mdassets/templates/user-actions.mdassets/templates/ugc-concepts.mdassets/templates/shot-list.mdassets/templates/claims-evidence-map.mdscripts/collect-product.shscripts/capture-screenshots.shscripts/download-images.shscripts/write-manifest.shscripts/render-video-brief.shscripts/validate-skill-assets.sh- Shared robustness matrix:
../opendevbrowser-best-practices/artifacts/browser-agent-known-issues-matrix.md
Fast Start
./skills/opendevbrowser-product-presentation-asset/scripts/validate-skill-assets.sh
./skills/opendevbrowser-product-presentation-asset/scripts/collect-product.sh "https://example.com/product/123"
./skills/opendevbrowser-product-presentation-asset/scripts/write-manifest.sh "https://example.com/product/123" /tmp/product-video-pack
./skills/opendevbrowser-product-presentation-asset/scripts/render-video-brief.sh /path/to/bundle/manifest.json /tmp/product-video-brief
Use the bundle manifest.json path printed by write-manifest.sh; required sidecars must be adjacent to that manifest.
Supporting Surfaces
- Use browser replay (
screencast-start / screencast-stop) when a product flow needs temporal UI proof before you decide which screenshots to keep.
- Use desktop observation only for read-only evidence around external windows or OS-owned dialogs that affected capture.
- Use
--challenge-automation-mode off|browser|browser_with_helper for bounded browser-scoped computer use on provider or auth walls; it is not a desktop agent.
Final Assets Produced
Expected output pack always includes:
manifest.json with canonical product metadata and manifest.readiness.presentation plus manifest.readiness.productVideopresentation-readiness.json with readiness status, warnings, reason codes, selected-record identity, candidate summaries, promoted claims, rejected candidate summaries, evidence references, and compact countsproduct.json and pricing.json; product.json.presentationReadiness and product.json.productVideoReadiness mirror the production gatescopy.md and features.md, which are production input only when readiness allows itraw/source-record.json for auditability and raw evidence preservation
Workflow JSON output also exposes product.presentationReadiness, product.productVideoReadiness, meta.presentationReadiness, and meta.productVideoReadiness so callers can gate automation without opening files first. CLI completion text includes both readiness statuses when available, so transport success is not production authority.
When visual capture succeeds, the pack may also include:
images/ for product stillsscreenshots/ for page context and UI proof
Metadata-first packs with 0 images and 0 screenshots are valid intermediate outputs only when readiness is reviewed. They usually produce partial readiness and need additional visual sourcing before final video publication.
The render-video-brief.sh helper adds:
video-brief.mdshot-list.mdugc-brief.mdclaims-evidence-map.md
Helper behavior:
pass: generates normal production brief files, still requiring human evidence and visual review.partial: generates gated brief files with warnings and reason codes. Treat copy and features as constrained draft input.fail: exits nonzero after writing warning-only diagnostics. Do not label copy, features, or product claims as verified production input.
What the User Should Do
- Pick product URL or product name.
- Before daemon-backed
product-video run workflows, run opendevbrowser status --daemon --output-format json and continue only when data.fingerprintCurrent === true.
- Run collection workflow and confirm output pack path.
- Review
presentation-readiness.json, manifest.readiness.presentation, manifest.readiness.productVideo, product.json.presentationReadiness, product.json.productVideoReadiness, returned meta.presentationReadiness, and returned meta.productVideoReadiness when available.
- Confirm raw evidence remains preserved in
raw/source-record.json, but do not treat raw marketplace text as verified production copy.
- Run
./skills/opendevbrowser-product-presentation-asset/scripts/render-video-brief.sh only after readiness review.
Canonical helper path: ./skills/opendevbrowser-product-presentation-asset/scripts/render-video-brief.sh.
- If readiness is
partial, resolve warnings and reason codes before final publication.
- If readiness is
fail, stop production use and recollect or repair evidence before briefing creators.
- If no visuals were captured, source or capture visuals before handing the brief to the editor or creator pipeline.
Parallel Multitab Alignment
- Apply shared concurrency policy from
../opendevbrowser-best-practices/SKILL.md ("Parallel Operations").
- Validate product-video workflow browser-mode sweeps with
auto, extension, and managed when browser capture is involved.
- For lower-level attach parity, separately validate direct connect or CDP attach sessions where asset capture uses browser action tools.
- Keep one session per worker for concurrent product-page captures; avoid target-switch thrash in one session.
How to Combine the Assets
- Use
manifest.json plus presentation-readiness.json as the readiness source of truth.
- Use
copy.md and features.md as production inputs only when readiness is pass and claims map to evidence.
- For
partial, keep the brief gated and carry reason codes into video-brief.md, shot-list.md, and claims-evidence-map.md.
- For
fail, use helper output as diagnostics only and do not brief production.
- Pair each claim with supporting asset (
images or screenshots) when available.
- If the pack is metadata-first, source visuals before final edit and update
shot-list.md plus claims-evidence-map.md with the new asset paths.
- Sequence assets using
shot-list.md.
- Validate pricing and availability freshness before publishing.
- Validate every claim appears in
claims-evidence-map.md before publish.
Production Rules
success:true, ok:true, or an artifact path means the workflow wrote files. It does not by itself mean production-ready.presentation-readiness.json.summary.status, manifest.readiness.presentation.status, and manifest.readiness.productVideo.status are the production gates.- Raw evidence is preserved for audit and debugging. It must not be copied into creator scripts unless promoted through readiness-backed claims.
- Marketplace chrome, site navigation, catalog labels, seller language, shipping, returns, condition, and unsupported superlatives are rejected unless they are explicitly promoted as evidence-backed product claims.
- Keep partial and fail reason codes visible in every handoff so downstream editors know what still needs review.
Robustness Coverage (Known-Issue Matrix)
Matrix source: ../opendevbrowser-best-practices/artifacts/browser-agent-known-issues-matrix.md
ISSUE-10: normalized price/currency fields for claimsISSUE-11: anchor discount context for pricing claimsISSUE-12: stale price and unsupported-claim prevention via evidence mapping
UGC Key Concepts
- Hook in first 2 seconds with user problem + payoff.
- Show real product usage context before polished close-ups.
- Keep claims concrete and verifiable from captured assets.
- Use one CTA and one primary value proposition per short clip.
- Preserve authenticity: avoid over-produced voice/style mismatches.
References
