Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 

Repository files navigation

Clarisights Claude Plugins

Official Clarisights plugin marketplace for Claude Code and Claude apps.

Installation

Add the marketplace, then install a plugin:

/plugin marketplace add clarisights/claude-plugins
/plugin install use-clarisights@clarisights

Plugins

use-clarisights

Turns Claude into a marketing performance analyst for your company. It pairs a structured analysis framework (overview → diagnostic drill-down → pointed queries) with the Clarisights MCP connector for querying live paid-media data.

Use it to:

  • Get weekly/monthly performance reviews and period-over-period comparisons
  • Diagnose why a metric (CPA, ROAS, CTR, spend) moved, with progressive drill-down by market, channel, and campaign
  • Analyze campaign, ad group, and creative performance
  • Produce marketing reports (PDF) and slide decks (PPTX)

Requires: the Clarisights MCP connector configured in your Claude environment.

The skill works out of the box with generic defaults, but it gets dramatically better once customized — see Customization below.

Customization

plugins/use-clarisights/skills/marketing-performance-analyst/SKILL.md has 13 customizable spots, each marked with an inline <!-- CUSTOMIZE: FIELD_NAME ... --> comment telling you what to replace. Unfilled sections fall back to safe generic behavior (the skill discovers data via the MCP tools and asks when ambiguous), so partial customization is fine — fill what you know.

Clarisights users: the MCP Settings page in the Clarisights app has a Skill Customizer that asks these same questions in a form and generates a fully filled SKILL.md (copy or download) — prefer that over hand-editing. The field names below match that form one-to-one.

Company-wide fields — agree on these once per company (in the Clarisights Skill Customizer they are admin-only):

Field What to fill in Example
COMPANY_CONTEXT What the company does — business model, markets, what a "conversion" and "revenue" mean "Food delivery marketplace in 40+ countries across Europe, MENA, and APAC…"
COMPANY_TERMINOLOGY Abbreviations, naming conventions, default assumptions the agent should always honor "'UA' means prospecting. 'Revenue' means gross order value. Assume Adjust attribution unless stated."
ATTRIBUTION_SOURCES Attribution source(s) in use and which to default to "Primary: Adjust (MMP). Platform-reported only when explicitly asked. DWH for order-level truth."
ATTRIBUTION_METRIC_IDENTIFICATION Naming patterns that identify each attribution variant in your metric names "'aj_' prefix = Adjust; 'dwh' = warehouse; bare 'CPA' means the Adjust-based CPA."

Per-user fields — personal to each user's role and markets:

Field What to fill in Example
USER_CONTEXT Your role, the brands/markets/channels you own, who you report to "Senior PM Manager for Paid Social in MENA; channels Meta and TikTok."
USER_CHANNELS The ad platforms / data sources you manage "Facebook, TikTok, Snapchat, Google Ads, Apple Search Ads"
USER_KEY_METRICS Metrics you track daily/weekly/monthly, using exact Clarisights metric names "Daily: Spend, CPI, Installs. Weekly: CPA, DWH Acquisitions, ROAS."
USER_KEY_DIMENSIONS The breakdowns you use most, using exact Clarisights dimension names "Country, Marketing Channel, Campaign; for creative: Ad, Asset Type, Creative Concept."
EFFICIENCY_DEFINITION Which metric(s) "efficiency" means, with targets if any "Efficiency = CPA; target €8 EU / €5 MENA. App: CPI, target €1.50."
EFFECTIVENESS_DEFINITION Which outcome metric(s) "effectiveness" means "Effectiveness = DWH Acquisitions; secondary ROAS and install→first-order CVR."
TARGETS_AND_BENCHMARKS KPI targets, budget targets, internal benchmarks "CPA €8; monthly budget utilization 95–105%; ROAS 3.0x."
CREATIVE_ANALYSIS_CONFIG How you analyze creatives: dimensions, what "good" looks like, minimum-spend threshold "Compare within market+channel; good = low CPA at ≥€500 spend; track CTR, Thumbstop Rate."
COMMON_WORKFLOWS Your recurring analyses in your own words — periods, metrics, breakdowns, thresholds "'Weekly review' = this week vs last, flag CPA movers >15%, break top 3 movers down by campaign."

Two general rules: use metric and dimension names exactly as they appear in Clarisights (the skill resolves them to keys via list_metrics / list_dimensions), and don't state targets you don't actually have — the skill is instructed never to invent them.

Repository structure

.claude-plugin/marketplace.json          # Marketplace manifest
plugins/
  use-clarisights/
    .claude-plugin/plugin.json           # Plugin manifest
    skills/
      marketing-performance-analyst/
        SKILL.md                         # The skill

Contributing

To add a plugin: create plugins/<name>/ with a .claude-plugin/plugin.json manifest and its skills/commands/agents, then register it in .claude-plugin/marketplace.json.

About

Claude & Claude Code skills template for Clarisights MCP Server

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors