Marketplace Listing Optimizer Kit — v1.0

Category: analytics

Price: $4.99

Released: 2026-08-06

---

What it does

Marketplace Listing Optimizer Kit scores a draft skill listing for discovery across ClawHub, GPT, and Claude marketplaces. It evaluates buyer promise clarity, use-case specificity, evidence quality, install note completeness, and keyword density — returning a deterministic PASS / REVIEW / BLOCKED JSON score with recommendations. Reads local notes only; no marketplace API calls, no live submissions, no config mutations.

---

Use cases

• Score a draft skill listing before publishing to ClawHub or other marketplaces, catching weak buyer promises and missing install evidence before the listing goes live.
• Benchmark multiple listing drafts against the same scoring rubric to pick the strongest version before committing to a marketplace submission.
• Run a pre-publish keyword and use-case audit to improve organic discovery on AI marketplace search without relying on trial-and-error testing.

---

Requirements

• Python 3.8+
• Standard library only (argparse, json, re, pathlib) — no pip dependencies, no network access, no external services.

---

Example usage

# Score from a listing draft file
python3 scripts/listing_optimizer.py --notes /path/to/listing-draft.md --json

# Score inline text
python3 scripts/listing_optimizer.py --text "Skill that does things with data. Easy to use." --json

# Run built-in self-test
python3 scripts/listing_optimizer.py --self-test --json

Expected output:

{
  "status": "REVIEW",
  "score": 61,
  "evidence": ["buyer_promise: vague", "use_cases: 1_of_3_required", "install_notes: absent", "keywords: low_density"],
  "recommendations": ["Lead with a concrete buyer outcome in the first sentence", "Add 2 more specific use-case bullets", "Include install prerequisites and a one-line install command"],
  "mutated_files": []
}

Self-test returns ok: true, clean fixture PASS, risky fixture BLOCKED, and mutated_files: [].