This repo packages marketing workflows as agent skills that run through Hyper MCP. The skills cover paid ads, social publishing, SEO, creative generation, email, analytics, and research, so an agent can follow a repeatable playbook instead of improvising each time.
Builders who want their agent to run marketing tasks with reusable workflows across Claude Code, Cursor, Codex, and similar tools.
You can hand an agent a marketing job and get consistent research, creation, and execution steps without rebuilding the workflow each time.
Folders under `skills/` cover Google Ads, Meta Ads, TikTok, LinkedIn, SEO research, competitor intel, email lifecycle, analytics, and more.
The skills use Hyper MCP for ad platforms, social tools, scrapers, image generation, video generation, browser automation, and analytics access.
Multiple skills can be combined in one job, such as research plus creative generation plus ad launch.
`.claude-plugin/plugin.json` and `.claude-plugin/marketplace.json` make the bundle installable as a Claude Code plugin.
`validate-skills.sh` checks skill frontmatter and MCP calls, with CI in `.github/workflows`.
npx skills add hyperfx-ai/marketing-skills
# install one npx skills add hyperfx-ai/marketing-skills --skill google-ads # install all 24 npx skills add hyperfx-ai/marketing-skills --all
Agent Skills for marketing — paid ads, social media, SEO, AI search, competitor research, ad creative generation, email lifecycle, analytics, operations, and more.
These skills run on the Hyper MCP, which gives your agent 100+ direct integrations and built-in marketing tools through one endpoint — a backpack of tools that travels with your agent across Claude Code, Cursor, Codex, OpenCode, GitHub Copilot, Gemini CLI, and 50+ other agents that support the Agent Skills spec.
A skill is a markdown file (SKILL.md) with the workflows, decision rules, and example tool calls your agent needs to run specific marketing functions end-to-end. The tools themselves come from the Hyper MCP. The skill teaches the agent how to think like an expert and ship correct work.
Create, customize, and connect your MCP at app.hyperfx.ai/mcp. Choose which integrations and built-in tools to include, and configure approval rules action-by-action across every one of them.
What's in it:
npx skills add hyperfx-ai/marketing-skills
Auto-detects your agent and drops the skills in the right directory. Then ask your agent something a skill knows about:
"Plan a Google Ads search campaign for example.com."
# install one
npx skills add hyperfx-ai/marketing-skills --skill google-ads
# install all 24
npx skills add hyperfx-ai/marketing-skills --all
You: Run a viral paid and organic campaign for acmebakes.com. Find what's trending in our space on social, generate image and video creatives, and set up and launch ads + organic posts on Meta, Google, and TikTok. $100/day per ad platform.
Agent: Learned your brand from acmebakes.com (logo, palette, voice). Scraped 412 Instagram posts, 287 TikToks, and 54 Reddit threads to see what people in artisan baking are talking about. Three trends stand out: sourdough rescue, Dubai-chocolate copycats, school-lunch baking. Two have low keyword competition and rising search volume — targeting those.
Generated 6 image creatives + 2 short videos in your brand style. Everything's set up and paused — view each one before setting it live:
- Meta — $100/day, Advantage+ targeting, optimized for the Purchase event on your pixel, US 25–54.
- TikTok Ads — $100/day, Traffic objective on the same audience, video creatives.
- Google Ads Search — $100/day, phrase + exact match on the two trending opportunities, negative keywords, sitelinks.
- TikTok + Instagram organic — 3 posts queued (also paused), captions matched to trending sounds and hashtags.
Total ad spend: $300/day ($100 each on Meta, Google, TikTok).
Tell me when to set them live, and I'll set up a task to monitor them every hour.
That's meta-ads + google-ads + tiktok-ads + ad-creative-generation + video-generation + tiktok + instagram composing into one job. Skills can compose like this because they all run against the same MCP — the agent picks the right one per step.
| Skill | What it does | Required integrations |
|---|---|---|
| Foundation | ||
brand-context | Build one brand-context.md per brand — positioning, ICP, personas, verbatim customer language, voice, proof points — that every other skill reads before asking brand questions. | Firecrawl recommended for auto-draft; works standalone via interview |
| Paid ads | ||
google-ads | Plan and launch Google Ads campaigns — Search, Display, and Performance Max — and build GAQL-backed reports and dashboards. | Google Ads |
meta-ads | Plan and launch Meta ad campaigns across Facebook and Instagram; audit existing accounts. | Meta Business, Firecrawl |
meta-ads-library | Research competitor ads in the Meta Ads Library. | Apify |
amazon-ads | Plan and launch Amazon Sponsored Products campaigns. | Amazon Ads |
tiktok-ads | Plan and launch TikTok ad campaigns across all objectives. | TikTok Marketing |
pinterest-ads | Plan and launch Pinterest ad campaigns across all objectives. | Pinterest Ads |
reddit-ads | Plan and launch Reddit ad campaigns — promoted posts, subreddit targeting, pixels, reporting. | Reddit Ads |
snapchat-ads | Plan and launch Snapchat ad campaigns — ad squads, creatives, Snap Pixel, reporting. | Snapchat Ads |
openai-ads | Plan and launch OpenAI Ads (ChatGPT ads) — chat card and product-feed creatives, audiences, insights. | OpenAI Ads (API key) |
| Social media | ||
tiktok | Publish videos, photos, and carousels to TikTok. | TikTok (Login Kit) |
instagram | Publish posts, Reels, Stories, and carousels. Moderate comments, send DMs, pull insights. | Instagram (Business Login) |
linkedin | Publish text, articles, documents, and AI-generated carousels — personal profiles and company pages. | |
| Research | ||
seo-research | Keyword research, SERP and AI Overview analysis, competitor benchmarks, AI search visibility, backlinks, site audits. | HyperSEO toolkit |
competitor-intel | Research competitors end-to-end — site, social, search rank, AI-search citations, mentions — and produce battle cards, weekly digests, or board-prep updates. | Firecrawl + at least one of HyperSEO or Apify scrapers |
customer-research | Mine Reddit, YouTube comments, G2/Capterra, Twitter, and TikTok to surface what customers actually say — build personas, VOC quote banks, JTBD maps, and synthesis reports. | Apify scrapers toolkit (Reddit, Twitter, YouTube, TikTok, Instagram) |
reddit | Research subreddits, threads, and sentiment — mine questions, pain points, and voice-of-customer. | Reddit scraper |
youtube | Fetch YouTube transcripts, repurpose video content into posts/summaries/chapters, and create thumbnails from proven composition patterns. | YouTube toolkit |
| Creative | ||
ad-creative-generation | Generate ad copy and on-brand images for Google and Meta placements. | Firecrawl + image gen toolkit |
image-generation | Generate and edit images — picks the right model for text-heavy creatives, photoreal product shots, or high-res output. | Image gen toolkit |
video-generation | Generate AI video and prep it for distribution — text/image-to-video, captions, voiceover, stitching, overlays. | Video gen toolkit |
blog-generation | Generate one excellent, on-brand blog post per run — a stateful engine that never repeats a topic, built for SEO and AI-search citations. | Firecrawl, HyperSEO, and Google Search Console recommended |
| Outbound & lifecycle | ||
cold-email-outreach | Run end-to-end B2B cold outreach — prospect, enrich, personalize, send, follow up, route replies. | Gmail + Apollo (Firecrawl + LinkedIn scraper bundled) |
email-lifecycle | Build welcome, nurture, re-engagement, win-back, and abandoned-cart email programs. | At least one of Klaviyo, Resend, Beehiiv, or Gmail |
| Analytics | ||
analytics-insights | Drive GA4, Google Tag Manager, Search Console, and BigQuery from chat — tracking plans, reports, conversions, container audits, BigQuery export queries. | At least one of GA4, GTM, GSC, or BigQuery |
| Execution | ||
hyper-cli | Run these marketing skills through the Hyper CLI (beta), translating raw MCP tool names into CLI aliases or raw toolkit calls. | Hyper CLI + the integrations required by the sibling skill |
Invoke explicitly with /google-ads, /cold-email-outreach, /seo-research, etc. — the slash name matches the folder under skills/.
Skill discovery is automatic. The transcript above shows multi-skill composition; smaller asks route to one skill at a time:
"Pull all the active Facebook ads for 'meal kit delivery' into a database." →
meta-ads-library
"Run a 50-prospect cold-email campaign to Heads of Growth at US Series A SaaS companies." →
cold-email-outreach
"Pull last month's GA4 traffic by channel and flag any conversion event that dropped >20%." →
analytics-insights
"Build a weekly competitor digest for [comp-a, comp-b, comp-c] — site changes, social, search rank, mentions." →
competitor-intel
# install globally (available across every project)
npx skills add hyperfx-ai/marketing-skills -s seo-research -g
# Claude Code plugin marketplace
/plugin marketplace add hyperfx-ai/marketing-skills
/plugin install hyper-marketing@hyperfx-marketing-skills
# manual copy
cp -r skills/google-ads ~/.claude/skills/ # Claude Code
cp -r skills/google-ads ~/.agents/skills/ # Cursor / Codex / generic
# git submodule
git submodule add https://github.com/hyperfx-ai/marketing-skills.git .agents/marketing-skills
marketing-skills/
├── .claude-plugin/plugin.json # Claude Code plugin manifest
├── .claude-plugin/marketplace.json # Claude Code plugin marketplace catalog
├── .mcp.json # Hyper MCP server config (bundled with plugin)
├── .github/workflows/validate.yml # CI: validate-skills.sh on PRs
├── skills/ # one folder per skill
│ ├── <skill>/SKILL.md
│ └── <skill>/references/*.md # progressive disclosure on larger skills
├── AGENTS.md # generic-agent entrypoint
├── CLAUDE.md # Claude Code entrypoint
├── CONTRIBUTING.md
└── validate-skills.sh # frontmatter + MCP-call lints
| Tool | Description |
|---|---|
| E-commerce Scraper | Scrape product listings, prices, and reviews |
| Firecrawl | Web scraping and crawling |
| Google Search Scraper | Pull Google SERP data |
| Google Trends Scraper | Pull Google Trends data |
| HyperSEO | Keyword research, SERP analysis, AI search visibility |
| Image Generation | Generate images (OpenAI, Nano Banana, Seedream) |
| Instagram Scraper | Scrape Instagram posts, profiles, and engagement |
| Knowledge Base | Query and manage the agent's knowledge base |
| Location Search | Geo and location lookup |
| Meeting Bot | Join, transcribe, and summarize meetings |
| Meta Ads Library | Search, scrape, and download live and historical Meta ads |
| Reddit Scraper | Scrape Reddit posts, threads, and comments |
| TikTok Scraper | Scrape TikTok videos, profiles, and engagement |
| Twitter Scraper | Scrape tweets, profiles, and threads |
| Video Generation | Generate AI video (Sora, Veo, Seedance) |
| Web Scraper | Search and scrape web pages |
| Website Analyzer | Analyze a website's tech stack, pixels, and more |
| YouTube | Search YouTube and fetch transcripts |
| Tool | Description |
|---|---|
| Database | Query and store data |
| Code Execution | Run Python or JavaScript in a sandbox |
| Toolkit Manager | Manage MCP toolkits and connections |
| Skills | Manage and invoke skills |
| Files | Built-in file system — read and write files |
| Planning | Multi-step task planning |
| Todo | Track tasks and progress |
| Web Search | General-purpose web search |
| Browser | Headless browser automation |
| Agents | Create and manage agents (instructions, tasks, skills, context files, Slack channels) |
| Hyper | Workspace, account, and platform-level actions |
Near-term skills and surfaces:
hyper-cli (beta) — run these skills through the Hyper CLI from a terminal, cron job, or shell pipeline.google-ads-operator — production Google Ads account operation and optimization.meta-account-audit — Meta account diagnostics, spend checks, and performance recommendations.social-carousel — carousel planning, copy, and export for social channels.cmo — executive marketing reporting and cross-channel performance summaries.reddit-research — focused Reddit research workflows for VOC, market maps, and positioning.slide-generation — turn research, reports, and campaign plans into presentation decks.pdf-generation — generate polished marketing reports and briefs.copywriting — general-purpose marketing copy workflows.lead-generation — prospect sourcing, enrichment, scoring, and handoff.crm-revops — CRM hygiene, routing, attribution, and pipeline operations.google-sheets-writing — structured spreadsheet creation and reporting.gmail-email-management — inbox triage, labeling, reply drafting, and operational email workflows.figma — design workflow support for ad creative, landing pages, and campaign assets.See CONTRIBUTING.md to contribute a skill.
| Skill | What it does | Needs |
|---|---|---|
gmail | Read, draft, send, and organize Gmail — labels, threads, drafts, attachments. | Gmail |
google-sheets | Write structured data to Google Sheets and keep spreadsheets up to date. | Google Sheets |
slack | Send Slack messages, share files and images, and work with channels and threads. | Slack |
twilio | Send SMS and WhatsApp messages and manage Twilio messaging workflows. | Twilio |
PRs welcome. Every skill must pass ./validate-skills.sh (frontmatter + MCP-call lint). See CONTRIBUTING.md.
MIT — see LICENSE.
Sign in to join the discussion.
No comments yet. Be the first to say what this is good for.
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)
A skill to stop your coding agent from burying the answer. ADHD-friendly output.
AI agent skill that researches any topic across Reddit, X, YouTube, HN, Polymarket, and the web - then synthesizes a grounded summary
De-AI writing skill for any Agent Skills-compatible agent (77+ via the Skills CLI), with native plugins for Claude Code, Codex, Grok Build, and Antigravity. Narrative-architecture repair for fiction, venue-matched rules for professional prose. Based on StoryScope (arXiv:2604.03136).
Academic Research Skills for Claude Code: research → write → review → revise → finalize