NotFair Plugin

Open-source SEO, GEO, and marketing skills for AI agents.

The NotFair Plugin gives Claude Code, Codex, Hermes, and other compatible agents practical marketing workflows they can follow—not another generic prompt collection. Use it to audit a site, investigate a traffic drop, improve content for Google and AI search, find wasted ad spend, build campaign plans, and make reviewable changes.

Every skill is built in the open as a readable SKILL.md, with supporting references, scripts, and evals where needed. Inspect it, adapt it, or contribute a better workflow.

What your agent can do

Area	Examples
SEO	Full-site and page audits, keyword research, content planning, technical SEO, schema, local SEO, international SEO, e-commerce SEO, and regression monitoring
GEO / AEO	Improve content for citation and visibility in ChatGPT, Perplexity, Gemini, Claude, and Google AI Overviews
Paid media	Plan, review, and optimize cross-channel campaigns with explicit budgets, measurement, and approval boundaries
Google Ads	Audit accounts, analyze search terms, manage keywords and budgets, write RSA copy, plan assets, and diagnose landing pages
Meta Ads	Review Facebook and Instagram performance, diagnose creative fatigue, assess audiences, and create evidence-based creative briefs
Content	Turn search demand into editorial plans, briefs, articles, landing pages, metadata, and structured data

The NotFair Plugin currently ships 42 skills across SEO, GEO, paid media, Google Ads, Meta Ads, and cross-model review.

Quick start

Claude Code

Install the NotFair plugin from its marketplace:

/plugin marketplace add nowork-studio/notfair-plugin
/plugin install notfair@nowork-studio

Then ask for the workflow you need:

/notfair:seo-analysis
/notfair:geo-optimizer
/notfair:google-ads-audit
/notfair:meta-ads-creative

You can also use plain language:

Audit my site and tell me why organic traffic fell.

Find pages that could earn citations in AI answers.

Review last month's ad spend and show me the safest opportunities to improve ROAS.

Codex, Hermes, and other agents

The NotFair Plugin's skill source is host-agnostic. Clone the repository and open it as a workspace; AGENTS.md maps marketing requests to the right skill.

git clone https://github.com/nowork-studio/notfair-plugin.git
cd notfair-plugin

For host-specific setup, give your agent INSTALL_FOR_AGENTS.md, or paste:

Retrieve and follow the instructions at:
https://raw.githubusercontent.com/nowork-studio/notfair-plugin/main/INSTALL_FOR_AGENTS.md

Why skills instead of one giant marketing agent?

Marketing work gets unreliable when every request goes through the same vague prompt. The NotFair Plugin splits the work into focused, testable procedures.

Specialized: each skill has a defined job, required inputs, decision rules, and output format.
Evidence-led: live-data workflows use Search Console, Google Ads, or Meta Ads instead of guessing from generic best practices.
Safe by design: read-only review comes before mutation, paid-media changes stay explicit, and unsupported capabilities are never implied.
Host-agnostic: the canonical skills are plain files, not logic trapped inside one agent runtime.
Forkable: everything is MIT licensed, so teams can review and adapt the workflows to their own standards.

Skill catalog

SEO and GEO

Skill	What it does
`seo-analysis`	Audits a full site with Search Console and crawl data, then prioritizes the highest-impact fixes.
`seo-page`	Performs a deep audit of one URL for intent, content, structure, and on-page SEO.
`content-writer`	Writes or improves search-led articles, landing pages, and service pages.
`content-planner`	Turns Search Console opportunities into a prioritized, dated editorial calendar.
`keyword-research`	Builds a keyword universe, classifies intent, and organizes topic clusters.
`meta-tags-optimizer`	Improves titles, meta descriptions, Open Graph tags, and SERP click-through potential.
`schema-markup-generator`	Creates and validates JSON-LD structured data.
`broken-link-checker`	Finds broken internal and external links and reports site-health issues.
`geo-optimizer`	Audits and rewrites content for citation in AI search and answer engines.
`local-seo`	Reviews Google Business Profile, local pages, NAP consistency, reviews, and local schema.
`hreflang-international`	Diagnoses hreflang, canonical, language, and regional targeting problems.
`sitemap-audit`	Checks XML sitemap structure, freshness, coverage, and URL validity.
`image-seo`	Reviews alt text, formats, compression, responsive images, CLS, and image discovery.
`ecommerce-seo`	Audits product pages, category pages, variants, faceted navigation, and product schema.
`programmatic-seo`	Plans useful templated pages at scale with demand, uniqueness, and indexation guardrails.
`competitor-pages`	Compares ranking pages and produces a practical SERP brief.
`sxo`	Connects search visibility and SERP CTR to the post-click conversion experience.
`seo-drift`	Creates a baseline and detects ranking, metadata, canonical, and indexation regressions.
`backlink-audit`	Reviews referring domains, anchor text, link risk, and internal-link opportunities.
`setup-cms`	Connects WordPress, Strapi, Contentful, or Ghost.

Paid media

Skill	What it does
`paid-ads`	Routes broad paid-media questions to the right channel and workflow.
`paid-ads-setup`	Connects accounts and captures business, economics, tracking, and budget context.
`paid-ads-launch`	Produces a reviewable campaign or multi-channel experiment plan before spend begins.
`paid-ads-review`	Creates comparable weekly or monthly scorecards and checks tracking health.
`paid-ads-optimize`	Finds waste and pacing problems, then proposes narrow, reversible changes.
`paid-ads-creative`	Develops cross-channel concepts, claim ledgers, fatigue hypotheses, and test briefs.
`paid-ads-linkedin`	Plans or reviews LinkedIn Ads around qualified pipeline outcomes.
`paid-ads-tiktok`	Creates TikTok campaign plans, creator briefs, and short-form experiments.
`paid-ads-amazon`	Plans and reviews Amazon Ads with margin-aware ACoS guardrails.
`paid-ads-chatgpt`	Designs bounded ChatGPT Ads experiments or reviews verified exports.
`paid-ads-integrations`	Verifies connector, account, and tool access before promising a capability.
`paid-ads-guide`	Explains installation, supported platforms, limits, and troubleshooting.

Google Ads

Skill	What it does
`google-ads-audit`	Scores account health, validates tracking, and finds wasted spend.
`google-ads`	Reviews performance and manages supported keywords, bids, budgets, negatives, and campaigns.
`google-ads-copy`	Writes compliant RSA headlines and descriptions with test variants.
`google-ads-assets`	Plans sitelinks, callouts, snippets, image assets, and Performance Max briefs.
`google-ads-landing`	Diagnoses keyword-to-ad-to-page relevance and landing-page quality.

Meta Ads

Skill	What it does
`meta-ads-audit`	Audits tracking, structure, creative health, audiences, spend efficiency, and scaling readiness.
`meta-ads`	Reviews Facebook and Instagram performance and executes supported campaign operations.
`meta-ads-creative`	Produces evidence-based concepts, copy angles, UGC briefs, and refresh experiments.

Cross-model review and maintenance

Skill	What it does
`gemini`	Uses Google Gemini for a second opinion, adversarial challenge, or open consultation.
`upgrade`	Updates an installed NotFair plugin and summarizes what changed.

Live data and integrations

Some skills work entirely from a repository, URL, or supplied export. Live account analysis requires the relevant connection.

Data source	Used for	Connection
Google Search Console	Search performance, queries, pages, indexing, and traffic changes	Google OAuth
Google Ads	Campaign performance, search terms, bids, budgets, keywords, and change history	NotFair Google Ads MCP via OAuth
Meta Ads	Facebook and Instagram campaigns, ad sets, creatives, and insights	NotFair Meta Ads MCP via OAuth
CMS platforms	Content and SEO-field review in WordPress, Strapi, Contentful, or Ghost	Platform API or compatible MCP
Google Gemini	Cross-model review	Gemini API key

Google Ads and Meta Ads use explicit, bounded mutation tools. LinkedIn, TikTok, Amazon, and ChatGPT Ads remain planning or export-review workflows unless the current agent session exposes a verified connector.

Inside a skill, connectors use tool-agnostic placeholders such as ~~google-ads, ~~meta-ads, ~~search-console, and ~~cms. The agent resolves each placeholder to a compatible tool available in the current session, so the workflow is not coupled to one MCP implementation.

How the repository is organized

notfair-plugin/
├── AGENTS.md                    # intent-to-skill resolver for AI agents
├── .claude-plugin/              # Claude Code plugin manifest
├── paid-ads/                    # cross-channel planning, review, optimization
├── google-ads/                  # audit, management, copy, assets, landing pages
├── meta-ads/                    # audit, management, creative
├── seo/                         # SEO, GEO, content, and technical-search skills
├── gemini/                      # cross-model review
├── test/                        # unit and LLM-judge evals
└── notfair/                     # optional local goal-loop application

AGENTS.md is the universal entry point. It maps user intent to the canonical SKILL.md and documents the external dependency each workflow requires.

Optional: run recurring marketing goals locally

This repository also includes a local application for turning a measurable marketing outcome into a recurring agent loop. It is a companion to the skill library, not a requirement for using the skills.

npx notfair@latest

The app runs on your machine with Codex or Claude Code, stores state locally, and can track a verified metric over time. See notfair/README.md for setup, architecture, and operating details.

Contributing

Each skill lives in its own category folder:

seo/your-skill-name/
├── SKILL.md          # required instructions and frontmatter
├── references/       # optional supporting knowledge
└── scripts/          # optional deterministic tooling

When adding or changing a skill:

Keep the workflow focused on one clear marketing job.
Use imperative, testable instructions in SKILL.md.
Add or update eval coverage.
Update AGENTS.md, the plugin manifest, VERSION, and CHANGELOG.md.

Open a pull request with one skill or one coherent improvement. For application contributions, see notfair/CONTRIBUTING.md and notfair/ARCHITECTURE.md.

Community

Join the NotFair Discord
Open an issue
Star the repository if these workflows make your agent more useful

License

MIT