BetterReviews Skill for AI Agents

Last updated: March 27, 2026

The BetterReviews skill teaches AI agents how to interact with your store's review API. Install it in Claude Code or any AI coding assistant that supports the SKILL.md format.

What the Skill Does

  • Send review links to customers and get shareable hub URLs
  • Moderate reviews — approve, reject, or delete
  • Optimize product descriptions with AI and publish to Shopify
  • Analyze your brand — tone, values, positioning from your store URL
  • Generate content — FAQs, SEO descriptions, feature lists from reviews
  • Connect review platforms — Okendo, Judge.me, Yotpo import and webhooks
  • Configure settings — toggle automation, set delays, manage auto-approve rules
  • Search and analyze reviews — keywords, sentiment, natural language Q&A

Install in Claude Code

Option 1: Download and extract (recommended)

Run this single command in your project root:

curl -fSL https://betterreviews.app/downloads/betterreviews-api-skill.tar.gz | tar -xz -C "$(mkdir -p .claude/skills && echo .claude/skills)" && echo "Installed to .claude/skills/betterreviews-api/"

Option 2: Manual setup

Create the directory .claude/skills/betterreviews-api/ in your project and copy the SKILL.md and reference files from the GitHub repository.

Direct download (.tar.gz, 8KB)

Setup

  1. Open the BetterReviews app in Shopify admin
  2. Go to Settings → Developer
  3. Click Create token (Read & Write permissions)
  4. Copy the token and store it securely — it is only shown once
  5. When your AI agent asks for the API key, provide the token

Example Usage

Once installed, ask your AI agent things like:

  • "Send a review link to customer@example.com for product 7125386199075"
  • "Show me all pending reviews"
  • "Approve all 5-star reviews"
  • "What are my review stats for the last 7 days?"
  • "Optimize the product description for our best seller"
  • "Analyze our brand positioning"
  • "Connect our Okendo account"
  • "Turn on automated review collection with a 5-day delay"

Skill Files

The package contains these files:

betterreviews-api/
  SKILL.md                         # Overview, auth, common workflows
  reference/
    review-requests.md             # Send links, list, cancel
    reviews.md                     # List, moderate, stats, search
    optimizations.md               # AI product descriptions lifecycle
    brand-content.md               # Brand analysis, SEO, FAQ generation
    integrations.md                # Okendo, Judge.me, Yotpo connections
    products.md                    # Product catalog, metrics, lookup
    settings.md                    # Collection + moderation config

API Reference

For the full endpoint documentation (also readable by AI agents via URL), see the API Reference.