OpenClaw CWS Publisher

OpenClaw CWS Publisher

Search intent: chrome web store publisher, extension release publisher, cws publisher, chrome extension publish

Goal

Prepare a Chrome extension repo for release with less metadata drift:

• package the extension
• validate the exact ZIP intended for upload against source manifest and CWS listing copy
• scan tracked and untracked non-ignored files for obvious leak risks
• run local reviewer/E2E gates
• enforce design, UI, screenshot, and claim-alignment score gates
• enforce storefront media uniqueness so portfolio waves do not reuse the same icon motif, promo layout, visual signature, thumbnail template, or exact asset
• enforce public landing, privacy, support, reviewer, SEO, and Cloudflare canonical-page gates before dashboard submission
• check current Chrome Stable release data before declaring E2E coverage fresh
• run a lightweight competitor and positioning differentiation check
• require a repo-local product-share/traffic-source gate when present, before treating a new extension as submission-ready
• detect repo-local reviewer gates
• generate GitHub metadata
• generate optional ClawHub metadata and explicit tags
• render reproducible publish commands

Use This Skill When

• the user wants a Chrome extension repo prepared for GitHub release
• the user wants CWS ZIP/listing/privacy/design/E2E readiness checked before dashboard submission
• the user wants ClawHub tags and GitHub topics kept in sync
• the user wants a leakage check before public release
• the user already has a specific repo path to release

Companion Scripts

The public ClawHub artifact is instruction-only so install-gate audits can return PASS. When the companion repository is available, set:

export OPENCLAW_CWS_PUBLISHER_DIR=/path/to/openclaw-cws-publisher/scripts/openclaw-cws-publisher

Then use $OPENCLAW_CWS_PUBLISHER_DIR/.py in the commands below.

Operating Order

1. Run the repo-local product-share gate when present.
   • Example: npm run check:product-share or python3 scripts/check_product_share_gate.py --product
   • Block submission when the first traffic source, trust reason, share moment, free MVP window, 30-60 day kill criteria, or ecosystem path is missing.
2. Build the extension ZIP intended for upload.
   • python3 "$OPENCLAW_CWS_PUBLISHER_DIR/build_extension_zip.py" --extension-dir /extension --out
3. Validate the exact ZIP, source manifest, and listing contract.
   • python3 "$OPENCLAW_CWS_PUBLISHER_DIR/validate_cws_package.py" --zip --source-manifest /extension/manifest.json --listing-json /docs/cws/listing.json
   • Default posture blocks stale ZIPs, Manifest V2, tabs, debugger, ``, persistent host permissions, declarative content scripts, remote script/eval patterns, missing permission justifications, privacy-practice drift, and no-host ZIPs whose listing still carries host-permission copy.
   • If a product genuinely needs host permissions, use --allow-host-permissions only after the listing and reviewer instructions explain the shipped user-facing need.
4. Scan tracked and untracked non-ignored files for obvious publish leaks.
   • python3 "$OPENCLAW_CWS_PUBLISHER_DIR/scan_publish_surface.py" --root --json-out --markdown-out
5. Run local reviewer/E2E gates.
   • python3 "$OPENCLAW_CWS_PUBLISHER_DIR/run_local_e2e_gates.py" --repo-root --json-out --markdown-out
   • The script discovers check:cws, check:public, check:public:visual, test:e2e:reviewer, test:e2e, and scripts/reviewer_gate.py when present.
6. Enforce the design/UI/UX evidence gate.
   • python3 "$OPENCLAW_CWS_PUBLISHER_DIR/check_design_gate.py" --design-report /docs/design-gate.json --screenshot-metadata /assets/listing/screenshot-1.png.source.json
   • Every changed public page, popup, CWS screenshot, promo tile, hero, and media asset must score at least 8/10 for product clarity, visual trust, evidence integrity, responsive polish, accessibility, and claim alignment.
   • For multi-extension or portfolio submissions, docs/design-gate.json must include media_identities with unique icon_motif, promo_layout, and visual_signature values plus store-icon, small-promo, and marquee-promo asset paths for each item. Recolored copies of the same thumbnail template are a blocker even when dimensions and basic scores pass.
7. Enforce public landing and SEO gates.
   • The CWS-facing site must have a polished product-first landing page, a readable privacy policy, support page, reviewer guide, robots.txt, sitemap.xml, canonical URLs, Open Graph/Twitter metadata, and factual SoftwareApplication JSON-LD when applicable.
   • Prefer Cloudflare Pages or another owned HTTPS host as the canonical CWS listing surface. GitHub source-viewer URLs and temporary fallback mirrors must not remain in active listing metadata.
   • Block submission when SEO metadata points to an old domain, when public pages look like policy stubs, or when privacy/support/reviewer pages do not reflect the exact package permissions and user-data behavior.
8. Check current Chrome Stable release data.
   • python3 "$OPENCLAW_CWS_PUBLISHER_DIR/check_chrome_release.py" --tested-chrome-version --json-out --markdown-out
   • Source: Chrome for Testing last-known-good Stable feed, cross-checked with ChromiumDash, Chrome Releases, and Chrome for Developers release notes when making decisions.
9. Run a competitor/differentiation check.
   • python3 "$OPENCLAW_CWS_PUBLISHER_DIR/check_competitors.py" --listing-json /docs/cws/listing.json --competitors-json /docs/cws/competitors.json --min-competitors 3 --markdown-out
   • Record at least three comparable products or explicit substitutes; flag risky claims like #1, best, official, and close-copy positioning.
10. Generate launch metadata.

• python3 "$OPENCLAW_CWS_PUBLISHER_DIR/generate_launch_manifest.py" --repo-root --owner --public-site-base --out
• If you already export CWS_PUBLIC_SITE_BASE, you can omit --public-site-base and the script will reuse that public reviewer-facing base.

1. Render publish commands.

• python3 "$OPENCLAW_CWS_PUBLISHER_DIR/render_publish_commands.py" --manifest --out

Rules

• Operate on the repo path the user named, not on arbitrary sibling directories.
• Inspect the ZIP intended for upload, not only the source tree, before calling a Chrome Web Store package ready.
• Prefer activeTab plus scripting after an explicit user gesture over persistent host permissions.
• Do not publish when the leak scan has unresolved findings.
• Do not publish a new product when a repo-local product-share gate is missing, failing, or says rework, park, or kill.
• Do not publish when the target repo has a reviewer gate and it fails.
• Do not publish when package/listing/privacy claims disagree with the ZIP manifest.
• Do not publish when the design/UI gate is missing or any score is below 8/10.
• Do not publish when a store icon, small promo tile, marquee promo tile, or portfolio thumbnail reuses another product's motif/layout/signature or exact asset bytes.
• Do not publish when public SEO/canonical metadata is missing, points at a fallback domain, or contradicts the CWS listing contract.
• Do not publish when local E2E was only run on an older Chrome milestone without recording the current Stable release check.
• Do not publish listing copy that claims official affiliation, best-in-class status, background crawling, server sync, or broad permissions unless the shipped product and public evidence prove it.
• Keep GitHub topics and ClawHub tags explicit in the generated manifest.
• Use a dedicated public site base for support, privacy-policy, and reviewer-instructions links when the extension has one.
• If a Chrome Web Store draft is already pending review, do not recommend canceling or replacing it unless a verified acceptance blocker exists.
• Do not assume generated artifacts should be committed.

Current Policy Anchors

• Chrome Web Store Program Policies: https://developer.chrome.com/docs/webstore/program-policies/policies
• Manifest V3 remote-code requirements: https://developer.chrome.com/docs/webstore/program-policies/mv3-requirements
• activeTab plus scripting model: https://developer.chrome.com/docs/extensions/develop/concepts/activeTab
• Permission warnings and host permission warnings: https://developer.chrome.com/docs/extensions/develop/concepts/declare-permissions
• Chrome release notes: https://developer.chrome.com/release-notes/
• Chrome release feed: https://chromiumdash.appspot.com/fetch_releases

Companion Repo Scripts

• scripts/openclaw-cws-publisher/build_extension_zip.py
• scripts/openclaw-cws-publisher/validate_cws_package.py
• scripts/openclaw-cws-publisher/scan_publish_surface.py
• scripts/openclaw-cws-publisher/run_local_e2e_gates.py
• scripts/openclaw-cws-publisher/check_design_gate.py
• scripts/openclaw-cws-publisher/check_chrome_release.py
• scripts/openclaw-cws-publisher/check_competitors.py
• scripts/openclaw-cws-publisher/generate_launch_manifest.py
• scripts/openclaw-cws-publisher/render_publish_commands.py