# Send productOptimizer to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "viq-bc-optimiser",
    "name": "productOptimizer",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/veevortexiq/viq-bc-optimiser",
    "canonicalUrl": "https://clawhub.ai/veevortexiq/viq-bc-optimiser",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/viq-bc-optimiser",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=viq-bc-optimiser",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/bc_optimizer.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "viq-bc-optimiser",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-05T03:26:17.100Z",
      "expiresAt": "2026-05-12T03:26:17.100Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=viq-bc-optimiser",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=viq-bc-optimiser",
        "contentDisposition": "attachment; filename=\"viq-bc-optimiser-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "viq-bc-optimiser"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/viq-bc-optimiser"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/viq-bc-optimiser",
    "downloadUrl": "https://openagent3.xyz/downloads/viq-bc-optimiser",
    "agentUrl": "https://openagent3.xyz/skills/viq-bc-optimiser/agent",
    "manifestUrl": "https://openagent3.xyz/skills/viq-bc-optimiser/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/viq-bc-optimiser/agent.md"
  }
}
```
## Documentation

### BigCommerce Content Optimizer

Autonomous skill that fetches products from a BigCommerce store, generates optimized
titles and descriptions, and updates them back — one page at a time with full progress tracking.

### Prerequisites

The user must provide:

Store Hash — the BigCommerce store identifier (e.g., abc123def)
API Token — a BigCommerce API v3 token with Products read+write scope

### Setup

Before first use, install the requests library:

pip install requests --break-system-packages

The helper script is at: ~/.openclaw/workspace/skills/bigcommerce-content-optimizer/scripts/bc_optimizer.py

Set SCRIPT as the full path to bc_optimizer.py for all commands below.

### Workflow — Autonomous Loop

CRITICAL: Do NOT stop between pages. Process ALL pages continuously until done.

### Step 1: Initialize

python3 $SCRIPT init --store-hash "STORE_HASH" --token "API_TOKEN" --limit 10

This creates progress.json in the current working directory and returns total product/page counts.
If progress.json already exists with status: in_progress, it resumes from the last unprocessed page.

### Step 2: For EACH page (loop until all done)

2a. Fetch the page

python3 $SCRIPT fetch --store-hash "STORE_HASH" --token "API_TOKEN" --page PAGE_NUMBER --limit 10

Outputs page_N_products.json with product data.

2b. Read products and generate content

Read the fetched JSON. For EACH product, generate:

New Title: SEO-friendly, concise, under 70 characters. Capture the product essence.
New Description: Compelling HTML description, 100-300 words. Use <p>, <ul>, <li> tags.
Focus on benefits, use cases, value proposition. No inline styles, no scripts.

Consider: existing name/description, SKU, price, categories, brand, images.
Apply SEO best practices (natural keywords, not stuffing) and persuasive copywriting.
If the user gave brand voice guidelines, follow them.

Write the output as page_N_updates.json:

[
  {
    "id": 123,
    "name": "New Product Title",
    "description": "<p>New compelling description...</p>"
  }
]

2c. Push updates

python3 $SCRIPT update --store-hash "STORE_HASH" --token "API_TOKEN" --updates-file page_N_updates.json

Updates each product and logs success/failure to progress.json.

2d. Report and continue

After each page, briefly state:

Page X of Y complete
N products updated, N failed

Then IMMEDIATELY proceed to the next page. Do NOT wait for user input.

### Step 3: Completion

When all pages are done:

python3 $SCRIPT report

Print the final summary: total processed, successes, failures, time taken.

### Rules

Never stop mid-run — process all pages continuously unless an unrecoverable error occurs
Always use progress.json — if re-invoked, resume from where you left off
Rate limiting — the script handles BigCommerce rate limits with automatic retry
Error handling — if one product fails, log it and continue to the next
Content quality — every title and description must be meaningfully improved, not just rephrased
HTML safety — descriptions use clean simple HTML only (<p>, <ul>, <li>, <strong>, <em>)
One page at a time — fetch, generate, update, then move to next page

### Progress Tracker

progress.json tracks everything:

{
  "store_hash": "abc123",
  "total_products": 150,
  "total_pages": 15,
  "products_per_page": 10,
  "started_at": "2025-01-01T00:00:00Z",
  "pages_completed": [1, 2, 3],
  "products_updated": [],
  "products_failed": [],
  "current_page": 4,
  "status": "in_progress"
}
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: veevortexiq
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-05T03:26:17.100Z
- Expires at: 2026-05-12T03:26:17.100Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/viq-bc-optimiser)
- [Send to Agent page](https://openagent3.xyz/skills/viq-bc-optimiser/agent)
- [JSON manifest](https://openagent3.xyz/skills/viq-bc-optimiser/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/viq-bc-optimiser/agent.md)
- [Download page](https://openagent3.xyz/downloads/viq-bc-optimiser)