Humblytics Marketing Skills

A Cursor plugin that turns your agent into a marketing team. It bundles the full Humblytics marketing-skills catalog (12 skills) plus the hosted Humblytics MCP server, so you can analyze live analytics, diagnose funnels, and launch no-code A/B tests from plain-English prompts — no prompt engineering required.

• Who it's for: marketers, founders, and growth engineers using Humblytics for analytics, funnels, A/B testing, and ad attribution.
• What you get: 12 skills (5 wired to live Humblytics data via MCP tools, 7 strategy/copy playbooks) and a preconfigured MCP server connection.

Install

1. Install this plugin in Cursor (Settings -> Plugins, or from the marketplace).
2. Configure the HUMBLYTICS_API_KEY variable (see below).
3. Ask your agent a marketing question — the right skill activates automatically.

Configuration

This plugin declares a single variable, HUMBLYTICS_API_KEY, used to authenticate the bundled MCP server.

• Get your key: Humblytics dashboard -> API & MCP. It's an account-level key (starts with hmb_) that covers every property on your account. Requires the Plus plan or higher.
• Set it in Cursor: Plugins -> Configure -> HUMBLYTICS_API_KEY. Cursor substitutes it into the ${HUMBLYTICS_API_KEY} placeholder in mcp.json at runtime.
• No secrets in this repo: the plugin only declares the variable name; the value lives in your Cursor settings and is never committed here. Never paste your API key into chat.

The MCP server resolves propertyId per call. If your key can access multiple properties, the agent calls list_properties and passes the right propertyId.

Skills

Live data (via Humblytics MCP)

These five call live analytics through MCP tools. Each carries an adapter preamble instructing the agent to use MCP tools instead of raw HTTP.

Skill	What it does
cro-optimizer	Live funnel analysis + scored A/B test hypotheses
ab-test-generator	Generate & launch no-code split tests from analytics
heatmap-analyst	Click, scroll & rage-click friction analysis
revenue-attributor	Ad spend to Stripe revenue, ROAS + reallocation
funnel-reporter	End-to-end SaaS funnel reporting

Context-only (marketing expertise, no analytics calls)

Skill	What it does
page-cro	10-point landing page conversion audit
email-sequences	Onboarding, nurture & re-engagement drips
seo-strategist	Keyword research, gaps, on-page + technical SEO
marketing-strategist	Funnels, GTM, positioning, growth strategy
copywriting	Conversion copy for pages, emails & ads
ad-expert	Paid ads: Meta, Google, TikTok, LinkedIn
content-strategist	Articles, newsletters, social, video, SEO

Several skills share reference material under skills/_shared/ (CRO benchmark library + reasoning frameworks); skills link to it by relative path.

Example prompts

• "Find my worst-performing page and fix it" (cro-optimizer -> page-cro -> ab-test-generator)
• "Weekly performance report with recommendations" (funnel-reporter -> cro-optimizer)
• "Cut my worst ad and improve the landing page" (revenue-attributor -> cro-optimizer -> ad-expert)

Bundled MCP server

mcp.json connects to the hosted Humblytics MCP server over Streamable HTTP at https://mcp.humblytics.com/v1, authenticated with Authorization: Bearer ${HUMBLYTICS_API_KEY}. It exposes typed tools across:

• Properties — list_properties
• Analytics — traffic, pages, clicks, forms breakdowns and details
• Funnels — query, sankey, suggestions, saved funnels
• Split testing — recommendations, create/list/get/update/stop
• Ads attribution & connections — Google Ads and Meta (read-only)

create_split_test activates a test immediately — the skills present recommendations for confirmation before creating.

Skill provenance & syncing

Skills are vendored from Humblytics/humblytics-marketing-skills (see skills/UPSTREAM for the pinned commit). The 5 live-data skills additionally carry an MCP adapter preamble (endpoint -> tool mapping + output conventions) so they use MCP tools rather than the upstream curl/.env instructions. To resync, re-copy the upstream skills and re-apply the preamble to the five API-connected skills.

Development

Validate the plugin before submitting:

node scripts/validate-plugin.mjs

License

MIT