NotFair
September 16, 2026 · View on GitHub
This file is the universal entry point. Any AI coding agent (Claude Code, Codex, Hermes, Cursor, etc.) reads this to know which NotFair skill to run for which user intent.
If you are an agent and a user mentions Google Ads, Meta Ads, SEO, GEO, or anything in the tables below, route to the named skill.
How to use this file
- Match the user's intent against the rows below.
- Read the named skill's
SKILL.mdfrom the path shown. - Follow the procedure in that SKILL.md exactly.
Skills under seo/, paid-ads/, google-ads/, meta-ads/, analytics/, wordpress/, gohighlevel/, gemini/, and notfair-upgrade-skill/ are host-agnostic — they work the same on every supported agent host.
SEO
| Intent | Skill | Path |
|---|---|---|
| Full-site SEO audit, traffic drop, GSC analysis, Core Web Vitals | seo-analysis | seo/seo-analysis/SKILL.md |
| Single-page deep audit (URL-specific) | seo-page | seo/seo-page/SKILL.md |
| Write or improve content (blog, landing, service page) | content-writer | seo/content-writer/SKILL.md |
| Plan content from GSC data, build a dated editorial calendar | content-planner | seo/content-planner/SKILL.md |
| Keyword discovery, topic clusters (seed → keyword universe) | keyword-research | seo/keyword-research/SKILL.md |
| Title tags, meta descriptions, Open Graph, CTR | meta-tags-optimizer | seo/meta-tags-optimizer/SKILL.md |
| JSON-LD / structured data (FAQ, Product, HowTo, etc.) | schema-markup-generator | seo/schema-markup-generator/SKILL.md |
| Broken-link / 404 / site-health crawl | broken-link-checker | seo/broken-link-checker/SKILL.md |
| Rank in ChatGPT / Perplexity / AI Overviews (GEO / AEO) | geo-optimizer | seo/geo-optimizer/SKILL.md |
| Local pack / Google Business Profile / Maps / NAP / "near me" | local-seo | seo/local-seo/SKILL.md |
| Hreflang, international / multilingual, multi-region targeting | hreflang-international | seo/hreflang-international/SKILL.md |
| XML sitemap audit, sitemap errors, crawl-coverage | sitemap-audit | seo/sitemap-audit/SKILL.md |
| Image SEO, alt text, Google Images, WebP, image schema | image-seo | seo/image-seo/SKILL.md |
| E-commerce SEO, product/category pages, faceted nav, product schema | ecommerce-seo | seo/ecommerce-seo/SKILL.md |
| Programmatic / templated pages at scale (pSEO) | programmatic-seo | seo/programmatic-seo/SKILL.md |
| Competitor page gap analysis, "why do they outrank me", SERP brief | competitor-pages | seo/competitor-pages/SKILL.md |
| Search Experience Optimization (SXO), CTR + on-page conversion | sxo | seo/sxo/SKILL.md |
| SEO drift / regression monitoring, baseline & compare over time | seo-drift | seo/seo-drift/SKILL.md |
| Backlink / off-page audit, anchor text, referring domains, disavow | backlink-audit | seo/backlink-audit/SKILL.md |
Local Application-Password / .env.local CMS setup for SEO scripts (WordPress, Strapi, Contentful, or Ghost) | setup-cms | seo/setup-cms/SKILL.md |
Paid Ads
| Intent | Skill | Path |
|---|---|---|
| Broad ads question, cross-channel strategy, budget, CPA/ROAS, or route to the right workflow | paid-ads | paid-ads/paid-ads/SKILL.md |
| How NotFair paid ads works, install, plan/limit, supported platforms, or product troubleshooting | paid-ads-guide | paid-ads/paid-ads-guide/SKILL.md |
| Connect an account, establish marketing context, or refresh a paid-media workspace | paid-ads-setup | paid-ads/paid-ads-setup/SKILL.md |
| Check connector access, tools, or supported platform capabilities | paid-ads-integrations | paid-ads/paid-ads-integrations/SKILL.md |
| Plan a new campaign or multi-channel experiment before it can spend | paid-ads-launch | paid-ads/paid-ads-launch/SKILL.md |
| Weekly/monthly performance report, scorecard, pacing, or tracking health | paid-ads-review | paid-ads/paid-ads-review/SKILL.md |
| Wasted spend, budget allocation, overspend, or safe optimization proposal | paid-ads-optimize | paid-ads/paid-ads-optimize/SKILL.md |
| Cross-channel copy, creative concepts, fatigue diagnosis, or test briefs | paid-ads-creative | paid-ads/paid-ads-creative/SKILL.md |
| X Ads performance, campaigns, line items, targeting, creative, or writes | paid-ads-x | paid-ads/paid-ads-x/SKILL.md |
| LinkedIn Ads performance, campaigns, targeting, leads, creative, or writes | paid-ads-linkedin | paid-ads/paid-ads-linkedin/SKILL.md |
| Reddit Ads performance, campaigns, ad groups, ads, targeting, audiences, or writes | paid-ads-reddit | paid-ads/paid-ads-reddit/SKILL.md |
| TikTok Ads performance, campaigns, creative, targeting, or writes | paid-ads-tiktok | paid-ads/paid-ads-tiktok/SKILL.md |
| Amazon Ads plan, ACoS review, ASIN targeting, or export-based review | paid-ads-amazon | paid-ads/paid-ads-amazon/SKILL.md |
| ChatGPT Ads experiment plan or verified-export review | paid-ads-chatgpt | paid-ads/paid-ads-chatgpt/SKILL.md |
WordPress
| Intent | Skill | Path |
|---|---|---|
| Live WordPress content, media, comments, design, settings, plugins, themes, HTML files, or approved site changes through NotFair MCP | wordpress | wordpress/SKILL.md |
CRM
| Intent | Skill | Path |
|---|---|---|
| GoHighLevel / HighLevel contacts, conversations, opportunities, calendars, pipelines, or approved CRM writes | gohighlevel | gohighlevel/SKILL.md |
Analytics
| Intent | Skill | Path |
|---|---|---|
| GA4 traffic, acquisition, engagement, conversions, realtime, or measurement configuration | google-analytics | analytics/google-analytics/SKILL.md |
| Live Search Console queries/pages, traffic changes, URL inspection, or sitemaps | search-console | analytics/search-console/SKILL.md |
Google Ads
| Intent | Skill | Path |
|---|---|---|
| First-time setup or account health check | google-ads-audit | google-ads/audit/SKILL.md |
| Performance, keywords, bids, budgets, negatives, experiments, bulk ops | google-ads | google-ads/manage/SKILL.md |
| Write ad copy, RSA headlines/descriptions, A/B variants | google-ads-copy | google-ads/copy/SKILL.md |
| Google Ads assets, extensions, sitelinks, callouts, image assets, PMax asset briefs | google-ads-assets | google-ads/assets/SKILL.md |
| Landing-page quality, ad-to-page match, LPX diagnosis | google-ads-landing | google-ads/landing/SKILL.md |
Meta Ads
| Intent | Skill | Path |
|---|---|---|
| First-time Meta setup or account health check | meta-ads-audit | meta-ads/audit/SKILL.md |
| Facebook/Instagram performance, ROAS, CPM, creative fatigue, audience overlap | meta-ads | meta-ads/manage/SKILL.md |
| Facebook/Instagram ad creative, copy angles, UGC concepts, asset briefs, creative refreshes | meta-ads-creative | meta-ads/creative/SKILL.md |
Cross-model review
| Intent | Skill | Path |
|---|---|---|
| Second opinion / review / challenge / consult via Google Gemini | gemini | gemini/SKILL.md |
Plugin maintenance
| Intent | Skill | Path |
|---|---|---|
| Upgrade NotFair to the latest version | upgrade | notfair-upgrade-skill/SKILL.md |
External dependencies
- Universal NotFair MCP —
https://notfair.co/api/mcp/notfair, OAuth. The plugin registers this single connection for Google Ads, Meta Ads, X Ads, LinkedIn Ads, Reddit Ads, TikTok Ads, Google Search Console, Google Analytics, WordPress, and GoHighLevel. Readdocs/mcp-connection.mdbefore live work. Use the connected server's current instructions and capability descriptions to select tools and verify workspace/platform access; do not prescribe tool names or call sequences in skills. - Platform connections — each live skill still requires its corresponding account or property to be connected inside the selected NotFair workspace. A universal MCP session does not imply that every platform is connected.
- Google Gemini API key — required for
gemini.
Amazon and ChatGPT Ads skills are planning/review workflows unless the current session exposes a verified connector. They do not imply account or mutation access. setup-cms is local Application-Password / .env.local setup for SEO scripts; it is not the NotFair WordPress MCP connector.
Skills check for missing credentials at startup and walk the user through setup. Do not invent credentials or skip skills silently — surface the gap.
Conventions for installers (managed-block fences)
Any installer that writes into a file the user also edits (e.g., a user's workspace AGENTS.md, CLAUDE.md, or host config) MUST wrap its inserted content in a fence:
<!-- notfair:managed -->
... auto-generated rows ...
<!-- /notfair:managed -->
Re-running the installer rewrites only inside the fence. Anything outside is preserved.
Bookkeeping
When a new skill is added or removed in this repo, update:
- The relevant table above in this file.
.claude-plugin/plugin.json→skillsarray.VERSION,.claude-plugin/plugin.json, and.claude-plugin/marketplace.json(version bump).CHANGELOG.md(user-facing note).
A skill that exists on disk but is missing from this file or plugin.json is invisible to agents.