{
  "markdown": "# GoodBarber Skills\n\n> 44 AI-powered skills to manage your GoodBarber app with any MCP-compatible client — eCommerce, Community, Membership, and CMS.\n\nListed on [Smithery](https://smithery.ai/servers/goodbarber/goodbarber-public-mcp).\n\nThese skills connect to the **GoodBarber MCP server** and give your AI assistant structured workflows to manage your products, orders, customers, promotions, subscriptions, content, analytics, and more — all from a conversational interface.\n\n---\n\n## What are Skills?\n\nSkills are instruction files (`.md`) that teach an AI assistant **how** to perform specific tasks using your GoodBarber app's API via MCP (Model Context Protocol). Instead of manually calling API tools one by one, a skill orchestrates the full workflow — from data retrieval to formatted report — in a single natural-language request.\n\nFor example, asking *\"Show me my best sellers this month\"* triggers the `shop-best-sellers` skill, which automatically fetches your orders and catalog, computes rankings, and returns a formatted report.\n\n---\n\n## Quick Start\n\n### Option A — Install as a Claude Code plugin\n\nThe repo is a Claude Code plugin: it ships the GoodBarber MCP server (`.mcp.json`) and the 44 skills in one package.\n\n```bash\ngit clone https://github.com/goodbarber/goodbarber-skills.git\nclaude --plugin-dir ./goodbarber-skills\n```\n\nOnce the plugin is listed in the community marketplace, install it from any session instead:\n\n```\n/plugin marketplace add anthropics/claude-plugins-community\n/plugin install goodbarber@claude-community\n```\n\nOn the first GoodBarber tool call, Claude Code opens the authorization page: paste your **Public API key** and validate. Details in [SETUP.md](SETUP.md).\n\n### Option B — Manual setup (any MCP client)\n\n#### 1. Connect the GoodBarber MCP\n\nYou need to add the GoodBarber MCP server as a **custom connector** in your client. The server implements the **MCP 2026-07-28 protocol** over Streamable HTTP (earlier handshake-era clients still connect). The `/mcp/sse` path name is historical and kept only for backward compatibility.\n\n**MCP Server URLs:**\n\n| Setup | URL |\n|-------|-----|\n| Single app | `https://mcp.goodbarber.dev/mcp/sse` |\n| Multiple apps | `https://mcp.goodbarber.dev/<app_id>/mcp/sse` |\n\nReplace `<app_id>` with your GoodBarber app ID if you manage multiple apps.\n\n> **Authentication:** the GoodBarber MCP server uses a browser-based OAuth flow.\n>\n> When your MCP client connects to the MCP endpoint, it may open an authorization page on `mcp.goodbarber.dev`. On that page, you will be asked to paste your **GoodBarber Public API key** and validate the authorization. Generate your Public API key from your app's GoodBarber backoffice, on the **Public API / MCP server** page.\n>\n> **Important:**\n> - Do **not** open the `/authorize` URL manually in your browser.\n> - Start from the MCP client by connecting to the MCP endpoint.\n> - The client generates the full authorization request parameters automatically (`redirect_uri`, `client_id`, `state`, `code_challenge`, etc.).\n>\n> If you open the authorization page manually without those parameters, the authentication will fail.\n\n**Claude Desktop (Cowork):**\n\n1. Open **Settings > Connectors**\n2. Click **Add custom connector**\n3. Enter the MCP server URL above\n4. The connector opens the GoodBarber authorization page — paste your **Public API key** there and validate\n\n**Claude Code (CLI):**\n\n```bash\n# Single app\nclaude mcp add goodbarber --transport http https://mcp.goodbarber.dev/mcp/sse\n\n# Multiple apps\nclaude mcp add goodbarber --transport http https://mcp.goodbarber.dev/<app_id>/mcp/sse\n```\n\nThen start a Claude Code session — on the first GoodBarber tool call, the CLI will open the GoodBarber authorization page in your browser. Paste your **Public API key** there and validate to complete the OAuth flow.\n\n**Cursor / VS Code / Windsurf:**\n\nAdd to your MCP configuration file (`.cursor/mcp.json`, `.vscode/mcp.json`, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"goodbarber\": {\n      \"url\": \"https://mcp.goodbarber.dev/mcp/sse\"\n    }\n  }\n}\n```\n\nThe first connection from your client triggers the OAuth flow in your browser — paste your **Public API key** on the GoodBarber authorization page and validate.\n\n**Any other MCP-compatible client:**\n\nPoint your client to the MCP endpoint above (Streamable HTTP). The GoodBarber MCP server follows the standard MCP protocol and works with any compliant client.\n\n#### 2. Install the skills\n\nClone this repo and copy only the skills for your app type:\n\n```bash\ngit clone https://github.com/goodbarber/goodbarber-skills.git\n```\n\n> **Note:** the examples below use Claude's local skills directory (`~/.claude/skills/`). If you use another client, copy the skill folders to the directory expected by that client.\n\n**eCommerce app:**\n```bash\ncp -r goodbarber-skills/skills/ecommerce/* ~/.claude/skills/\n```\n\n**Community app:**\n```bash\ncp -r goodbarber-skills/skills/community/* ~/.claude/skills/\n```\n\n**Membership app:**\n```bash\ncp -r goodbarber-skills/skills/membership/* ~/.claude/skills/\n```\n\n**CMS / Content (any app with content sections):**\n```bash\ncp -r goodbarber-skills/skills/cms/* ~/.claude/skills/\n```\n\n> **Tip:** CMS skills are cross-cutting — install them alongside any app type that has content sections (articles, agenda, maps, galleries, videos, sounds).\n>\n> **Tip:** If your GoodBarber app combines multiple types (e.g. eCommerce + Membership), install skills from both directories.\n>\n> **Note:** skill directory names carry their family prefix (`shop-`, `community-`, `membership-`, `cms-`) and are unique, so skills from several families can live in the same destination without collisions.\n\n#### 3. Verify\n\nAsk your AI assistant: *\"What skills do you have?\"* — it should list the installed GoodBarber skills.\n\n---\n\n## Skills by App Type\n\n### eCommerce (18 skills)\n\n<details>\n<summary><strong>Catalog & Products</strong></summary>\n\n| Skill | Description |\n|-------|-------------|\n| `shop-best-sellers` | Rank products by sales volume and revenue over a given period |\n| `shop-catalog-audit` | Detect incomplete product sheets (missing images, descriptions, variants) |\n| `shop-low-performers` | Identify products with zero or very low sales |\n| `shop-orphan-products` | Find products not assigned to any collection |\n| `shop-product-launch` | Guided creation of a full product with variants, images, and SEO |\n| `shop-stock-check` | Audit stock levels — flag out-of-stock and low-stock items |\n| `shop-reorder-planner` | Generate a supplier-ready replenishment queue based on sales velocity |\n\n</details>\n\n<details>\n<summary><strong>Orders & Customers</strong></summary>\n\n| Skill | Description |\n|-------|-------------|\n| `shop-order-followup` | To-do list of orders to process (pending, to ship, to deliver) |\n| `shop-customer-insights` | Segment customers into VIP, loyal, dormant, and one-shot profiles |\n| `shop-rfm-segmentation` | Recency / Frequency / Monetary customer segmentation |\n| `shop-prospect-nurture` | Prioritize prospects and suggest conversion actions |\n\n</details>\n\n<details>\n<summary><strong>Promotions</strong></summary>\n\n| Skill | Description |\n|-------|-------------|\n| `shop-promo-campaign` | Create a promo code + send an announcement push in one workflow |\n| `shop-promo-performance-review` | Analyze promo impact: before, during, and after the campaign |\n\n</details>\n\n<details>\n<summary><strong>Analytics & Communication</strong></summary>\n\n| Skill | Description |\n|-------|-------------|\n| `shop-traffic-report` | App-level analytics: page views, launches, sessions, platforms |\n| `shop-kpi-monitor` | Threshold-based daily/weekly KPI health alerts |\n| `shop-weekly-digest` | Automated weekly business recap |\n| `shop-push-broadcast` | Compose, preview, schedule, and send a push notification to all customers |\n| `shop-push-targeted` | Compose, preview, schedule, and send a push to specific customers or prospects |\n\n</details>\n\n---\n\n### Community (5 skills)\n\n| Skill | Description |\n|-------|-------------|\n| `community-traffic-report` | App analytics: page views, launches, sessions by platform |\n| `community-push-broadcast` | Send a push to everyone or to specific community groups |\n| `community-push-targeted` | Send a push to specific community users |\n| `community-device-landscape` | Platform distribution, top devices, OS versions |\n| `community-weekly-digest` | Weekly community activity recap |\n\n---\n\n### Membership (10 skills)\n\n<details>\n<summary><strong>Subscriptions</strong></summary>\n\n| Skill | Description |\n|-------|-------------|\n| `membership-subscription-audit` | Active vs expired, churn rate, at-risk subscribers, winback opportunities |\n| `membership-expiration-calendar` | Upcoming subscription expirations timeline |\n| `membership-longest-subscribers` | Identify your most loyal long-term subscribers |\n| `membership-internal-subscription-grant` | Create, update, or revoke internal subscriptions |\n\n</details>\n\n<details>\n<summary><strong>Users & Analytics</strong></summary>\n\n| Skill | Description |\n|-------|-------------|\n| `membership-prospect-followup` | Prioritize membership prospects for conversion |\n| `membership-traffic-report` | App analytics: page views, launches, sessions by platform |\n| `membership-push-broadcast` | Send a push notification to all eligible users |\n| `membership-push-targeted` | Send a push to specific users or subscription-status audiences |\n| `membership-device-landscape` | Platform distribution, top devices, OS versions |\n| `membership-weekly-digest` | Weekly membership business recap |\n\n</details>\n\n---\n\n### CMS / Content (11 skills)\n\nSkills for managing editorial content — articles, agenda events, map points of interest, photo galleries, videos, and sounds. Work with any GoodBarber app that has CMS content sections.\n\n<details>\n<summary><strong>Authoring & Publishing</strong></summary>\n\n| Skill | Description |\n|-------|-------------|\n| `cms-article-publish` | Guided creation of a full article: body paragraphs, category, slug, scheduling, paywall |\n| `cms-event-publish` | Create an agenda event with start/end datetime, location, and body content |\n| `cms-place-publish` | Create a map point of interest (address + coordinates) with description |\n| `cms-gallery-builder` | Batch-upload images into a photo gallery and set titles/status |\n| `cms-article-restructure` | Reorder, clean, and fix the body paragraphs of an existing article |\n\n</details>\n\n<details>\n<summary><strong>Quality & Governance</strong></summary>\n\n| Skill | Description |\n|-------|-------------|\n| `cms-content-audit` | Detect incomplete content across all types (no cover, empty body, missing dates/coords) |\n| `cms-draft-review` | Surface stale drafts and unfinished content with a recommended next step |\n| `cms-paywall-audit` | IAP apps: check premium content has a coherent free preview (accessTier, maxFreeParagraphs) |\n| `cms-stale-content-refresh` | Rank aging articles as refresh, re-promote, or retire candidates |\n\n</details>\n\n<details>\n<summary><strong>Planning & Recap</strong></summary>\n\n| Skill | Description |\n|-------|-------------|\n| `cms-editorial-calendar` | Forward view: scheduled publications, upcoming events, expiring content |\n| `cms-weekly-digest` | What published this week + what's scheduled next week, by content type |\n\n</details>\n\n> **Note:** `weekly-digest`, `traffic-report`, `push-broadcast`, and `push-targeted` names recur across app types. The CMS skills are namespaced by a `cms-` prefix in their frontmatter (e.g. `cms-weekly-digest`) to avoid collisions — keep them in a separate folder if you install skills from multiple directories.\n\n---\n\n## Usage Examples\n\n```\n\"Show me my best sellers this month\"\n→ best-sellers\n\n\"Any products running low on stock?\"\n→ stock-check\n\n\"Create a 20% promo code for summer and notify everyone\"\n→ promo-campaign\n\n\"How's my churn rate looking?\"\n→ subscription-audit\n\n\"Send a push to the Paris group: meetup Friday at 7pm\"\n→ push-broadcast (community)\n\n\"Send a push to Marie and Alex: your item is back in stock\"\n→ push-targeted (eCommerce)\n\n\"Notify expired subscribers about the renewal offer tomorrow at 9am\"\n→ push-targeted (membership)\n\n\"Give me my weekly digest\"\n→ weekly-digest\n\n\"Write and publish an article about our new opening hours\"\n→ article-publish (cms)\n\n\"What content is scheduled to go live next week?\"\n→ editorial-calendar (cms)\n\n\"Audit my content for missing covers and empty posts\"\n→ content-audit (cms)\n```\n\n---\n\n## Design Principles\n\nAll skills follow these rules:\n\n- **Pagination-aware** — Large datasets are filtered server-side, not blindly paginated\n- **Fuzzy matching** — Mention a product or collection by name; the skill resolves it\n- **Workflow chaining** — Every skill suggests 2–3 related skills to run next\n- **No destructive actions without confirmation** — Mutations always require explicit user validation\n- **Structured output** — Every skill returns a formatted report, not a one-liner\n\n---\n\n## Compatibility\n\nThese skills work with any MCP-compatible AI client, including:\n\n- Claude Desktop (Cowork)\n- Claude Code (CLI)\n- Cursor\n- VS Code (Copilot, Claude, Cline, etc.)\n- Windsurf\n- Codex CLI\n- Gemini CLI\n- Any client supporting the Model Context Protocol\n\n---\n\n## Repo Structure\n\n```\ngoodbarber-skills/\n├── .claude-plugin/plugin.json\n├── .mcp.json\n├── README.md\n├── SETUP.md\n├── server.json        # manifest published to the official MCP registry (dev.goodbarber/goodbarber-public-mcp)\n└── skills/\n    ├── ecommerce/\n    │   ├── shop-best-sellers/SKILL.md\n    │   ├── shop-catalog-audit/SKILL.md\n    │   ├── shop-customer-insights/SKILL.md\n    │   ├── shop-kpi-monitor/SKILL.md\n    │   ├── shop-low-performers/SKILL.md\n    │   ├── shop-order-followup/SKILL.md\n    │   ├── shop-orphan-products/SKILL.md\n    │   ├── shop-product-launch/SKILL.md\n    │   ├── shop-promo-campaign/SKILL.md\n    │   ├── shop-promo-performance-review/SKILL.md\n    │   ├── shop-prospect-nurture/SKILL.md\n    │   ├── shop-push-broadcast/SKILL.md\n    │   ├── shop-push-targeted/SKILL.md\n    │   ├── shop-reorder-planner/SKILL.md\n    │   ├── shop-rfm-segmentation/SKILL.md\n    │   ├── shop-stock-check/SKILL.md\n    │   ├── shop-traffic-report/SKILL.md\n    │   └── shop-weekly-digest/SKILL.md\n    ├── community/\n    │   ├── community-device-landscape/SKILL.md\n    │   ├── community-push-broadcast/SKILL.md\n    │   ├── community-push-targeted/SKILL.md\n    │   ├── community-traffic-report/SKILL.md\n    │   └── community-weekly-digest/SKILL.md\n    ├── membership/\n    │   ├── membership-device-landscape/SKILL.md\n    │   ├── membership-expiration-calendar/SKILL.md\n    │   ├── membership-internal-subscription-grant/SKILL.md\n    │   ├── membership-longest-subscribers/SKILL.md\n    │   ├── membership-prospect-followup/SKILL.md\n    │   ├── membership-push-broadcast/SKILL.md\n    │   ├── membership-push-targeted/SKILL.md\n    │   ├── membership-subscription-audit/SKILL.md\n    │   ├── membership-traffic-report/SKILL.md\n    │   └── membership-weekly-digest/SKILL.md\n    └── cms/\n        ├── cms-article-publish/SKILL.md\n        ├── cms-article-restructure/SKILL.md\n        ├── cms-content-audit/SKILL.md\n        ├── cms-draft-review/SKILL.md\n        ├── cms-editorial-calendar/SKILL.md\n        ├── cms-event-publish/SKILL.md\n        ├── cms-gallery-builder/SKILL.md\n        ├── cms-paywall-audit/SKILL.md\n        ├── cms-place-publish/SKILL.md\n        ├── cms-stale-content-refresh/SKILL.md\n        └── cms-weekly-digest/SKILL.md\n```\n\n---\n\n## Contributing\n\nWant to add a skill? Create a folder in `skills/<app-type>/` with a `SKILL.md` file. Follow the existing format: YAML frontmatter (`name`, `description`, `compatibility`) + markdown instructions with tool workflow, input/output contracts, and guardrails.\n\n## License\n\n[The Unlicense](LICENSE) — public domain, no restrictions.\n",
  "bytes": 15819,
  "sha": "700e216aa771c2dddf68a1dac0d56d8d919ece8339dc2727cce4e6574757b41b",
  "repo_slug": "goodbarber/goodbarber-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_dev_goodbarber_goodbarber_public_mcp_0644df5e/readme"
}