CI

coupler-io/skills

Developer tools
40 stars Quality 64 Trend 47MIT

AI agent skills for marketing, sales, finance, ecommerce, PPC, and reporting analysis with live Coupler.io data.

Overview

Ready-to-use AI agent skills for marketing, PPC, sales, finance, ecommerce, and business reporting. Coupler.io skills give AI assistants repeatable analytics workflows backed by live data from your Coupler.io workspace through the Coupler.io MCP server. Use them to analyze campaign performance, sales pipelines, financial metrics, ecommerce data, generate reports, investigate anomalies, and turn business data into actionable insights. - Analyze marketing performance across Google Ads, Meta Ads, TikTok Ads, Microsoft Ads, LinkedIn Ads, Amazon Ads, and other channels - Find wasted PPC spend and opportunities to scale campaigns - Review sales pipelines, win rates, deal velocity, and rep performance - Analyze P&L, MRR, ARR, cash runway, and financial performance - Measure ecommerce conversion, AOV, retention, and repeat purchases - Generate structured business reports with validated metrics - Investigate anomalies and explain changes in business KPIs - Create and configure Coupler.

README

Coupler.io AI Agent Skills for Business Analytics

Ready-to-use AI agent skills for marketing, PPC, sales, finance, ecommerce, and business reporting. Coupler.io skills give AI assistants repeatable analytics workflows backed by live data from your Coupler.io workspace through the Coupler.io MCP server. Use them to analyze campaign performance, sales pipelines, financial metrics, ecommerce data, generate reports, investigate anomalies, and turn business data into actionable insights.

Contents

What can you do with Coupler.io skills?

Use AI agent skills to:

  • Analyze marketing performance across Google Ads, Meta Ads, TikTok Ads, Microsoft Ads, LinkedIn Ads, Amazon Ads, and other channels
  • Find wasted PPC spend and opportunities to scale campaigns
  • Review sales pipelines, win rates, deal velocity, and rep performance
  • Analyze P&L, MRR, ARR, cash runway, and financial performance
  • Measure ecommerce conversion, AOV, retention, and repeat purchases
  • Generate structured business reports with validated metrics
  • Investigate anomalies and explain changes in business KPIs
  • Create and configure Coupler.io dataflows through AI

Quick start

Add the Coupler.io skills marketplace:

/plugin marketplace add coupler-io/skills

Then install the skill set you need:

/plugin install coupler-marketing-ads@coupler-io-skills
/plugin install coupler-seo-and-geo@coupler-io-skills
/plugin install coupler-finance@coupler-io-skills
/plugin install coupler-sales@coupler-io-skills
/plugin install coupler-ecommerce@coupler-io-skills

Install only what you need. Every skill’s description stays in context for the whole session, so a plugin costs tokens in proportion to how many skills it carries. See Installation for the full plugin list, team setup, and manual install.

You also need a Coupler.io account with the MCP server connected, so the skills have live data to work against.

Skills library

Skills are organized by business function - Finance, Sales, Ecommerce, Marketing & Ads, and SEO & GEO - with additional shared capabilities and utilities.

Marketing & PPC

Skill What it does
marketing-analytics Marketing performance — campaign analysis, cross-channel comparison, anomaly detection. Covers paid, organic, email, and social.
ppc-analytics Paid-ads (PPC) performance — per-platform funnel traces, efficiency-first comparison (ranked on CPA/ROAS), budget pacing, ad-fatigue checks, and honest attribution (never blends conversions across platforms; offers an independent-source cross-check and blended CAC). Facebook + Google Ads first-class.

Eight Google-Ads-only skills in marketing-and-ads/google-ads/. Each one owns a single question and hands off to the others rather than duplicating them — ppc-analytics stays the cross-platform paid view. When a request needs a field no packaged report type carries, they route to capability/google-ads-custom-gaql.

Skill What it does
google-ads-performance-report The baseline read — what changed in the account and why. Period comparison, cost-per-lead moves, impression-share loss. Run this before deciding anything else.
google-ads-wasted-spend-and-scaling The cutting view — search-term waste, negative-keyword candidates, what to pause, and a budget-neutral reallocation proposal.
google-ads-keyword-and-quality-score-analysis The earning view — which keywords deserve more money, which overcharge for the same clicks, match-type and quality-score diagnosis.
google-ads-budget-pacing Month-end arithmetic — on-track or overspending, daily target, which campaigns are budget-capped, and whether more budget would do anything.
google-ads-conversion-tracking-audit Whether the conversion numbers can be trusted at all — double-counting, Analytics disagreement, untracked spend. Run before any cost or return conclusion.
google-ads-account-settings-audit Account configuration priced in the spend flowing through it — search partners, Display expansion, location intent, auto-apply, ad rotation, conversion windows, bid strategies.
google-ads-performance-max-analysis Opening the Performance Max black box — Shopping cannibalisation, brand-traffic buying, asset-group performance.
google-ads-client-report The monthly client write-up — what to say, how to present a missed target. Built only when asked.

TikTok Ads deep dives

Eleven TikTok-only skills in marketing-and-ads/tiktok-ads/. Same shape as the Google pack — each owns a single question and routes to its siblings rather than duplicating them, with ppc-analytics still the cross-platform paid view.

Skill What it does
tiktok-ads-performance-report The baseline read — what moved, which campaigns moved it, and how much of the change each one caused. Run this before deciding anything else.
tiktok-ads-wasted-spend-and-scaling The cutting view — what to turn off and what to fund with the money, as one decision rather than two.
tiktok-ads-creative-performance-analysis Which videos earn their spend, where the losing ones lose people, and what the next round should be.
tiktok-ads-creative-fatigue-and-refresh-cadence Which videos are dying, how long they have left, and how many new ones a month the account needs to keep up.
tiktok-ads-audience-targeting-analysis Which audiences earn their spend — and whether targeting is doing any work the creative was not already doing.
tiktok-ads-budget-pacing Where the month ends if nothing changes, the daily spend to land on plan, and which ad groups will not take more money.
tiktok-ads-conversion-tracking-and-pixel-audit Whether the conversion numbers can be trusted before you move budget on them. Run before any cost or return conclusion.
tiktok-ads-account-structure-and-learning-phase-review Whether the account is split into more ad groups than its budget can feed, priced in what that costs in delivery.
tiktok-ads-placement-location-and-device-breakdown Where and when the money actually goes, and what each of those places is worth.
tiktok-shop-and-gmv-max-review What GMV Max is actually buying, whether it cannibalises campaigns already making those sales, and which products carry it.
tiktok-ads-client-report The monthly client write-up — the kind that survives being questioned. Built only when asked.

Meta / Facebook Ads deep dives

Eleven Meta-only skills in marketing-and-ads/facebook-ads/. Same shape as the Google pack — each owns a single question and routes to its siblings rather than duplicating them, with ppc-analytics still the cross-platform paid view.

Skill What it does
facebook-ads-performance-report The baseline read — what moved this period and which campaigns moved it. Cost decomposed into CPM, CTR and conversion rate. Run this before deciding anything else.
facebook-ads-wasted-spend-and-scaling The cutting view — ad sets spending without results, creative past its fatigue threshold, each cut paired with where the money should go instead.
facebook-ads-creative-performance-analysis Which ads win and why — thumbstop and hook rate, what the winners have in common, and the brief for the next production round.
facebook-ads-creative-fatigue How long the winners have left — CTR decay against first-week baseline, CPM drift, a refresh queue ranked by spend at risk, and monthly creative volume needed.
facebook-ads-audience-targeting-analysis Which audiences earn their spend — lookalike vs interest vs broad vs retargeting, saturation as audiences age, and who is being paid for twice.
facebook-ads-budget-pacing Month-end arithmetic — on-track or overspending, required daily spend, which ad sets are capped, and whether more budget would do anything.
facebook-ads-conversion-tracking-and-pixel-audit Whether the conversion numbers can be trusted — pixel and CAPI coverage, deduplication, view-through share, the platform-vs-store gap. Run before any cost or return conclusion.
facebook-ads-account-settings-audit Configuration priced in the spend flowing through it — optimisation goals, bid strategy, Advantage+ and expansion toggles, attribution setting. Most of these default in Meta’s favour.
facebook-ads-account-structure-and-learning-phase-review How the account is organised and what that costs in learning — ad sets stuck below event volume, fragmentation, audience overlap, consolidation with the spend affected.
facebook-ads-placement-location-and-device-breakdown Where the budget actually goes — Feed vs Reels vs Stories vs Audience Network, region, device and delivery hour, each with what it is worth.
facebook-ads-client-report The monthly client write-up — KPIs against goal, creative winners, the attribution caveat stated once and plainly. Built only when asked.

Microsoft Ads deep dives

Eleven Microsoft Ads (Bing) skills in marketing-and-ads/microsoft-ads/. Same shape as the Google pack, with triggers anchored to Microsoft, Bing and UET so the two packs don’t collide. Adds what Microsoft carries and Google doesn’t: share of voice with click share, LinkedIn profile targeting (company, industry, job function), and the negative keyword conflict report.

Skill What it does
bing-ads-performance-report The Microsoft Ads baseline read — what the account did, why it changed, the demand it is missing, and what to do, with a number on each.
bing-ads-budget-pacing Where Microsoft Ads spend lands by month end, which campaigns are capped by budget, and whether more money would buy anything.
bing-ads-wasted-spend-and-scaling Finds Microsoft Ads spend past the point of being early with nothing to show, builds safe negatives, and moves the money to capped campaigns.
bing-ads-conversion-tracking-audit Whether Microsoft Ads conversions can be trusted — goals counting, double counts, untracked spend, dated breaks — before anyone moves money.
bing-ads-keyword-and-quality-score-analysis Which Microsoft Ads keywords earn their money, quality weighted by spend, which part of quality is failing, and what low quality costs.
bing-ads-account-settings-audit Prices every Microsoft Ads setting that costs money — syndication, location intent, audience setting, bid strategies, Google Import overwrites.
bing-ads-audience-targeting-analysis Which Microsoft Ads audiences earn their spend — lists, age and gender, and LinkedIn profile cuts by industry and job function — with bid adjustments.
bing-ads-location-device-and-dayparting Where, on what device and at what hour Microsoft Ads spend earns — share of spend against share of results, with adjustments sized.
bing-ads-impression-share-and-auction-insights The Microsoft Ads account’s position in the auction — share won, lost to budget or rank, top of page, click share — and where to defend.
bing-shopping-ads-product-performance Which products Microsoft Shopping makes money on, which spend without selling or never serve, and how to restructure the product groups.
bing-ads-client-report The monthly Microsoft Ads report a client can read — scored against agreed targets, misses explained honestly, next month’s plan attached.

LinkedIn Ads deep dives

Ten LinkedIn-only skills in marketing-and-ads/linkedin-ads/. Member demographics and country/region come from single-dimension ad analytics (one member dimension per source, not crossable with campaign), and there’s no hourly split, so there’s no separate audience or dayparting skill. Adds a native lead gen form skill instead.

Skill What it does
linkedin-ads-performance-report The LinkedIn Ads baseline read — what the account did, why it changed, reach and frequency, and what to do, with a number on each.
linkedin-ads-budget-pacing Where LinkedIn Ads spend lands by month end, which campaigns spend their full budget, and why the underspenders can’t spend.
linkedin-ads-wasted-spend-and-scaling Finds LinkedIn Ads spend past the point of being early with nothing to show — campaigns, creatives, Audience Network, saturation — and moves it.
linkedin-ads-conversion-tracking-audit Whether LinkedIn Ads conversions can be trusted — rules, attribution overcount, view-through share, untracked spend, dated breaks.
linkedin-lead-gen-form-performance Which LinkedIn lead gen forms earn their leads — cost per lead, form completion, and who the leads are from their own answers, never as individuals.
linkedin-ads-creative-performance-analysis Which LinkedIn Ads creatives win within their own format, what winners share, and a brief for the next round.
linkedin-ads-creative-fatigue Which LinkedIn Ads creatives are wearing out, roughly how long each has left, whether it’s the audience, and how many new creatives a month.
linkedin-ads-placement-and-device-breakdown What LinkedIn Ads spend earns on LinkedIn against the Audience Network, by placement and device, with what to switch off.
linkedin-ads-account-settings-and-structure-audit Prices every LinkedIn Ads setting and structural choice costing money — objectives, bids, Audience Network, expansion, overlapping campaigns.
linkedin-ads-client-report The monthly LinkedIn Ads report a client can read — scored against agreed targets, misses explained honestly, next month’s plan attached.

Amazon Ads deep dives

Ten Amazon-only skills in marketing-and-ads/amazon-ads/, built on the standard Amazon Ads connector, with extra coverage from Amazon Ads (Unified) where that connector is enabled on the account. Every run declares one sales basis (ACOS or ROAS, one attribution window) and never totals marketplaces in different currencies.

Skill What it does
amazon-ads-performance-report The Amazon Ads baseline read — what the account did, why ACOS moved, split by ad product, and what to do, with a number on each.
amazon-ads-budget-pacing Where Amazon Ads spend lands by month end, which campaigns run out of budget early, portfolio caps, and whether more money would pay back.
amazon-ads-wasted-spend-and-scaling Finds Amazon search terms and product matches spending without selling, builds safe negatives, harvests winners, and moves the money.
amazon-ads-keyword-and-product-targeting Which Amazon keywords and product targets earn, what each should bid from its own revenue per click, and how match types and auto groups compare.
amazon-ads-placement-and-top-of-search-share Where on Amazon the ads earn — top of search, rest of search, product pages — placement adjustments sized, and top-of-search share.
amazon-ads-product-and-asin-performance Which advertised Amazon products earn their spend, which spend without selling, what shoppers buy instead, and when it’s the listing.
amazon-ads-new-to-brand-and-halo-sales What Amazon Sponsored Brands, Display, TV and DSP buy beyond ACOS — new-to-brand customers, halo sales, branded searches.
amazon-ads-attribution-and-metrics-audit Whether Amazon Ads sales and ACOS are comparable and trustworthy — windows, halo and views, currency, restatement, ad share of total sales.
amazon-ads-account-settings-and-structure-audit Prices every Amazon Ads setting and structural choice costing money — effective top-of-search bids, self-competition, brand mixing, crowded ad groups.
amazon-ads-client-report The monthly Amazon Ads report a client can read — scored against agreed targets, misses explained honestly, next month’s plan attached.

Black Friday deep dives

Five sale-season skills in marketing-and-ads/black-friday/, one per stage of a Black Friday, Cyber Monday, Prime Day or store sale. They read Google Ads, Meta / Facebook Ads and TikTok Ads together with Shopify, and hand off to the per-platform and Shopify skills for anything outside the sale.

Skill What it does
black-friday-last-year-report Weeks before the sale — which campaigns and products really drove last year’s Black Friday, when orders peaked and how much CPMs rose, so this year’s plan starts from your own numbers.
black-friday-ads-readiness-check 4–6 weeks out — what to fix in the Google, Meta and TikTok accounts and tracking while there’s still time, and how to ramp the budget.
black-friday-daily-ad-spend-decisions During the sale — which campaigns to scale, cut or leave alone today, with the wait stated for conversions still arriving.
black-friday-ad-spend-on-low-stock-products During the sale — product ads still running on items about to sell out in Shopify, and how much spend to move off them before they do.
black-friday-ads-and-sales-report After the sale — spend against budget, what you kept after returns, and what to change next year.

SEO & GEO

Thirteen organic- and AI-search skills in seo-and-geo/, installed as their own coupler-seo-and-geo plugin.

SEO

Twelve organic-search skills built on Google Search Console, with GA4 and Google Ads where a question needs them. Same shape as the ad packs — each owns a single question and routes to its siblings rather than duplicating them.

Skill What it does
google-search-console-keyword-opportunities The earning view — queries ranking just off page one, pages seen but not clicked, and pages cannibalising each other for the same query, each with the action.
content-decay-analysis Pages quietly losing organic traffic — whether it’s a ranking slip or fewer people searching, and which are worth refreshing first.
seo-landing-page-performance Search to outcome — search clicks and rankings next to engagement, conversions and revenue per landing page. Needs GSC and GA4.
google-search-console-country-and-device-performance Where and on what — clicks, CTR and position by market and by device, against the site’s own average.
branded-vs-non-branded-search-traffic Whether search growth is new reach or just people who already know you — brand vs non-brand share, trend, and new non-brand queries.
new-page-indexing-tracker Whether new pages get seen — days from publish to first impression, first click and a settled ranking, and which pages went nowhere.
ai-traffic-vs-organic-search-report Traffic from ChatGPT, Perplexity, Gemini and Claude against organic search — sessions, engagement, conversions, revenue. Measures referrals, not citations. GA4 only.
organic-traffic-drop-diagnosis Why organic traffic dropped suddenly — the break date, the lost clicks split by section, page, country, device and brand, and the most likely cause with the one check to run first. GA4 optional.
content-refresh-impact Whether updated pages won back search traffic — before and after each refresh, net of how the rest of the site moved, with a verdict per page. Refresh dates from you.
topic-cluster-performance Search traffic by topic instead of page — share of clicks against share of pages, trend, and how much each topic rests on one URL. Topics from a saved rule, URL folders or your patterns.
paid-vs-organic-search-overlap Google Ads search terms against Search Console queries — spend on searches you already rank for, paid covering gaps, brand on its own line, and a holdout test plan. Needs Google Ads and GSC.
seo-client-report The monthly SEO report a client reads — KPIs against target, last month and last year, non-brand separated from brand, wins, misses and recommendations. GA4 optional.

GEO

Generative engine optimization skills, also in seo-and-geo/, built on AI-visibility exports (Peec AI and similar) joined to GA4, Search Console and your business data.

Skill What it does
ai-search-citations-to-revenue Follows the pages ChatGPT, Perplexity and Gemini cite to AI-referred, organic, referral and direct sessions, Search Console clicks, GA4 key events and the orders, deals or payments behind them — and names the stage where the chain breaks.

Sales

Skill What it does
sales-analytics Sales pipeline — win rates, velocity, cycle length, rep performance, stage conversion. Works with Salesforce, HubSpot, Pipedrive, Close, Zoho, and more.

Finance

Skill What it does
finance-analytics Financial performance — P&L review, MRR/ARR bridge, cash runway, cost-center investigation. Works with QuickBooks, Xero, NetSuite, Stripe, Sage, and more.

Ecommerce

Skill What it does
ecom-analytics E-commerce performance — funnel conversion, AOV, cohort retention, repeat purchase, anomaly detection. Works with Shopify, WooCommerce, GA4, Klaviyo, Stripe, and more.

Shopify deep dives

Seven Shopify-only skills in ecommerce/shopify/. Same shape as the ads packs — each owns a single question and routes to its siblings rather than duplicating them, with ecom-analytics still the cross-platform store view. They share their definitions deliberately: store performance is the baseline the others read against, and sell-through, inventory value and dead-stock cash live in one skill only.

Skill What it does
shopify-sales-report The baseline read — the full sales ladder, orders, AOV, refunds vs returns, new vs returning, and which of the three drivers moved revenue. Run this before deciding anything else.
shopify-product-and-variant-performance Which products and variants earn their place — ranked by money and by margin on the right cost basis, with stock-out distortion flagged instead of buried.
shopify-inventory-report-and-stockout-forecast What runs out, when, what it costs, and the date you must order by — plus inventory value split four ways and the cash parked in dead stock.
shopify-customer-retention-and-ltv Which campaign and which first offer bought customers who came back — cohorts cut by UTM and discount status, with open cohorts excluded from every comparison.
shopify-discount-code-performance What each discount code and automatic discount costs, who uses it, and how deep a discount the store’s margin can carry, with markdowns kept apart from discounts.
shopify-refunds-and-returns-report Which products and sizes come back, how much goes back on the shelf, and what refunds cost, with confirmed returns kept apart from refunds where nothing came back.
shopify-sales-by-country-and-market Which countries the store sells to, how each is growing, and which lose money to refunds or discounts, compared on a like-for-like tax basis.

Klaviyo, Gorgias and Cin7 deep dives

Store-side skills for the tools around the shop, in ecommerce/klaviyo/, ecommerce/gorgias/ and ecommerce/cin7/. Same shape as the Shopify pack, and they route to it where the question is about store sales.

Skill What it does
klaviyo-flow-performance-vs-benchmarks How each Klaviyo flow earns per recipient against its own history and Klaviyo’s published benchmarks, per channel, and which flows are missing.
klaviyo-email-deliverability-check Spam complaints, bounces and unsubscribes on every send against Klaviyo’s limits, and which campaigns, flows or segments are causing them.
klaviyo-revenue-share-of-shopify-sales How much of the store’s revenue Klaviyo credits to email and SMS, split by flows and campaigns, on a stated attribution basis. Needs Klaviyo and Shopify.
gorgias-support-tickets-per-order Support tickets per order, what customers contact the store about, and which cause to fix first. Needs Gorgias and Shopify.
cin7-reorder-point-and-stock-cover Which SKUs to reorder and by when, per location, from the real sales rate and supplier lead times, with safety stock at a chosen service level. Cin7 Core.

Capabilities

Shared building blocks. Compose these with any domain skill above.

Skill What it does
get-started Onboard a brand-new or empty workspace from zero to the user’s own data in the chat — anchor on stated intent, route template-or-scratch, script the guided credential round-trip, build + run the first dataflow, then offer a refresh schedule.
create-dataflow Configure a Coupler.io dataflow end to end — pick an integration, attach a credential, wire source → destination, test it with a preview run, then offer the full run.
google-ads-custom-gaql Build a Custom GAQL source when no packaged Google Ads report type carries the field — and name the packaged type when one does. Covers resource choice, date macros, and the raw column names and micros that come back.
generate-data-set-context Produce an AI-readable description for a dataset so future sessions inherit its schema context.
refine-prompt Sharpen a vague or underspecified analytics request into a detailed, actionable prompt — filling in time period, metrics, data sources, and output format — before analysis.
report-generation Industry-agnostic report formatter and validator. Turns analysis output into a structured TL;DR → Metrics → Context → Recommendations → Next Questions report, then runs a Phase 2 validation pass (arithmetic, units, claim-vs-data, logical gates). Compose with a domain skill for domain-flavored reports.

Utilities

Skill What it does
humanizer-remove-ai-writing-patterns Rewrites AI-generated text to remove detectable patterns and add human voice. Also available as the /humanize slash command.
coupler-io-live-dashboard Builds a live Cowork artifact — a persistent, re-openable HTML widget backed by a Coupler.io dataflow that auto-refreshes (live dashboards, daily-check pages, data explorers).

Example questions

Marketing & PPC

  • Why did Google Ads ROAS decline last week?
  • Which campaigns are wasting budget?
  • Which Meta Ads creatives are showing signs of fatigue?
  • Are we on track to spend our advertising budget this month?

Sales

  • What is our current pipeline coverage?
  • Which stage has the biggest conversion drop?
  • Which reps have the shortest sales cycles?

Finance

  • What changed in our P&L this month?
  • How many months of cash runway do we have?
  • Explain the movement in MRR versus last month.

Ecommerce

  • Which products contributed most to revenue growth?
  • How has repeat purchase rate changed?
  • Which customer cohorts have the strongest retention?

How Coupler.io skills work

A skill is a reusable set of instructions that tells an AI agent how to perform a specific analytics task.

The skill uses Coupler.io MCP tools to discover datasets, inspect schemas, query live business data, and return a structured analysis.

Skills define how to analyze your data. Coupler.io MCP provides access to the data and tools needed to perform the analysis.

Skills work in all popular AI tools, such as Claude, ChatGPT, and Cursor. Any AI assistant connected to the Coupler.io MCP server can load them, even without installing the plugins.


Installation

From the marketplace — add this repo as a plugin marketplace, then install the per-cluster plugin(s) you want:

/plugin marketplace add coupler-io/skills
/plugin install coupler-finance@coupler-io-skills

Each business function is its own plugin, so you install only what you need. Available plugins:

Plugin Skills it installs
coupler-finance finance-analytics
coupler-sales sales-analytics
coupler-ecommerce ecom-analytics, + the 7 Shopify, 3 Klaviyo, 1 Gorgias and 1 Cin7 deep dives
coupler-marketing-ads marketing-analytics, ppc-analytics, + the 8 Google Ads, 11 Meta / Facebook Ads, 11 TikTok Ads, 11 Microsoft Ads, 10 LinkedIn Ads and 10 Amazon Ads deep dives, + the 5 Black Friday skills
coupler-seo-and-geo the 12 SEO skills and 1 GEO skill
coupler-capability get-started, create-dataflow, google-ads-custom-gaql, generate-data-set-context, refine-prompt, report-generation
coupler-utilities coupler-io-live-dashboard
humanizer humanizer-remove-ai-writing-patterns (+ /humanize command)

Plugin skills are namespaced by their plugin, so they can be invoked explicitly as /coupler-finance:finance-analytics. Most of them are model-invoked too — Claude reaches for them when the request matches their description. If the install summary says Run /reload-plugins to activate., run that.

Install only the plugin you need. Every skill’s description stays in context for the whole session, so a plugin’s cost scales with how many skills it carries. coupler-marketing-ads bundles 68 and adds roughly 13k tokens to every session; the single-skill plugins add a few hundred. Check any plugin before installing it:

claude plugin details coupler-marketing-ads@coupler-io-skills

For a whole team — register the marketplace in the repository’s .claude/settings.json so collaborators get it once they trust the folder:

{
  "extraKnownMarketplaces": {
    "coupler-io-skills": {
      "source": {
        "source": "github",
        "repo": "coupler-io/skills"
      }
    }
  }
}

This adds the marketplace, not the plugins. Each person still runs /plugin install @coupler-io-skills to pick what they want. To pre-enable plugins as well, see enabledPlugins.

Manual — copy any skill folder (each contains a SKILL.md) into your project’s .claude/skills/ directory. Skills installed this way are not namespaced, and Claude activates them when the request matches their description.


Coupler.io MCP tools

These are the tools the Coupler.io MCP server exposes. Skills use them automatically — you only need to know them if you are writing a new skill or calling tools directly.

Skills

Tool Description
list-skills Names + one-line descriptions of every available skill. Always the first call.
get-skill Full procedure for a named skill.

Discovery

Tool Description
list-templates Pre-built recipes filtered by source, metric, or category. Fastest path to skip manual setup.
list-integrations Every integration the platform supports (400+).
list-credentials What the user is already authorized for.
list-datasets Every dataset across every dataflow. Use for full-picture browsing.
search-datasets Narrows datasets by name, source, or free-text. Prefer over list-datasets when you have a keyword.

Inspection

Tool Description
get-integration Parameters and auth shape for one integration. Required before configuring anything.
get-integration-field-options Resolves dynamic dropdown values (e.g. Salesforce objects, Google Ads accounts). Call when get-integration flags resolve_options_with_tool: true.
get-dataflow Current state of one dataflow — sources, destinations, schedule, last run.
get-schema Column types and AI context for one dataset. Required before querying.
get-data SQL against the dataset’s data table. Start with SELECT * FROM data LIMIT 5 to confirm shape.

Configuration

Tool Description
create-dataflow Create a new empty dataflow.
create-dataflow-from-template Create a fully configured dataflow from a template. Use when list-templates returns a match — skips manual assembly.
create-dataflow-source Attach a source (Stripe, Postgres, …) to a dataflow.
create-dataflow-destination Attach a destination (Sheets, BigQuery, Looker Studio, …) to a dataflow.
update-dataflow-source Change source parameters; merges into existing config.
update-dataflow-destination Change destination parameters.

Run & persist

Tool Description
run-dataflow Run a dataflow: preview samples the sources to check the setup and resolve schemas; full refreshes all data.
update-dataset Save a markdown description on a dataset so future sessions inherit it.

Deprecated: list-dataflows — replaced by list-datasets.


Skill frontmatter

The Agent Skills spec allows only six top-level frontmatter keys — name, description, license, compatibility, metadata, allowed-tools — and a SKILL.md carrying anything else can be rejected outright. Claude Code’s own frontmatter reference accepts considerably more (when_to_use, model, effort, context, agent, argument-hint, disable-model-invocation, allowed-tools, disallowed-tools, and others), but those are Claude-only extensions that other runtimes ignore. We target the portable six, so everything of ours lives under metadata:

---
name: sales-analytics
description: Use this skill when the user wants to analyze sales pipeline, review win rates, … # for the agent: what it does and when to reach for it
metadata:
  short_description: Pipeline health, win rates, sales velocity and rep performance, straight from your CRM. # for humans: one line, shown in the UI
  category: sales
  sources:
    - Salesforce
---

description is the agent’s routing signal, so it is long and stuffed with trigger phrases — unreadable in a skill catalog. short_description is the human-facing counterpart: one sentence, no “use this skill when”, safe to render in a card or list. It is optional; consumers should fall back to a truncated description when it is absent.

python .github/scripts/generate_skill_index.py --check enforces the length limits:

Field Limit Source
name 64 characters Spec. Renaming means renaming the folder too — the two must match.
description 1024 characters Spec.
metadata.short_description 200 characters Ours. It renders in the UI, where anything longer than a sentence stops being scannable.

Above 500 characters a description only earns a warning — it still passes. There is no consensus on the right length: obra/superpowers ships descriptions of 79–234 characters, while coreyhaines31/marketingskills runs 432–1014. The warning is a nudge to check the tail is still earning its context, not a rule — agents weigh the opening sentence most heavily.

Both descriptions land in skills-index.json, which is what the API and the MCP server read.

Contributing and development

The machine-readable catalog is skills-index.json. Do not edit it by hand — it is generated from SKILL.md frontmatter. Change the skill files, then run python .github/scripts/generate_skill_index.py, or let the GitHub Action regenerate it on merge to main.

License

Released under the MIT License.

View the full README on GitHub

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add coupler-io/skills
New to MCP? Start with the mcpskill.org guide →