{"id":50544727,"url":"https://github.com/hyperfx-ai/marketing-skills","last_synced_at":"2026-06-03T23:00:27.096Z","repository":{"id":355150034,"uuid":"1222890567","full_name":"hyperfx-ai/marketing-skills","owner":"hyperfx-ai","description":"Marketing skills for AI agents — paid ads, social media, SEO, competitor research, creative generation, email, analytics, and more. Powered by Hyper MCP.","archived":false,"fork":false,"pushed_at":"2026-06-02T15:56:24.000Z","size":325,"stargazers_count":29,"open_issues_count":2,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-02T17:21:26.829Z","etag":null,"topics":["agent-skills","ai-agent","claude","claude-code","claude-skills","codex","cursor","google-ads","hermes","marketing","mcp","meta-ads","openclaw","seo"],"latest_commit_sha":null,"homepage":"https://www.hyperfx.ai/mcp","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hyperfx-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-27T20:08:18.000Z","updated_at":"2026-06-02T07:33:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hyperfx-ai/marketing-skills","commit_stats":null,"previous_names":["hyperfx-ai/marketing-skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hyperfx-ai/marketing-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperfx-ai%2Fmarketing-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperfx-ai%2Fmarketing-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperfx-ai%2Fmarketing-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperfx-ai%2Fmarketing-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hyperfx-ai","download_url":"https://codeload.github.com/hyperfx-ai/marketing-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperfx-ai%2Fmarketing-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33883102,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-03T02:00:06.370Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","ai-agent","claude","claude-code","claude-skills","codex","cursor","google-ads","hermes","marketing","mcp","meta-ads","openclaw","seo"],"created_at":"2026-06-03T23:00:26.131Z","updated_at":"2026-06-03T23:00:27.067Z","avatar_url":"https://github.com/hyperfx-ai.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Marketing Skills for AI Agents\n\nAgent Skills for marketing — paid ads, social media, SEO, AI search, competitor research, ad creative generation, email lifecycle, analytics, operations, and more.\n\nThese skills run on the [Hyper MCP](https://www.hyperfx.ai/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.\n\n---\n\n## What is a skill?\n\nA 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.\n\n---\n\n## The Hyper MCP\n\n![Hyper MCP — 200+ integrations and built-in tools](assets/hyper-mcp.png)\n\nCreate, customize, and connect your MCP at [app.hyperfx.ai/mcp](https://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.\n\nWhat's in it:\n\n- **100+ direct integrations** — ad platforms (Google Ads, Meta, TikTok, LinkedIn, Amazon, Pinterest), social (Instagram, Reddit, Twitter, YouTube), email (Gmail, Klaviyo, Resend, Beehiiv), analytics (GA4, Search Console, BigQuery), CRM (HubSpot, Apollo), commerce (Shopify), and more.\n- **Built-in tools** — Meta Ads Library scraper, Reddit and Twitter scrapers, image generation (OpenAI, Nano Banana, Seedream), video generation (Sora, Veo, Seedance), browser automation, transcription.\n- **Guardrails and permissions** — every action can require approval before it runs, so your agent can't delete a campaign or send a DM without your green light.\n- **The Hyper platform** — build and manage Hyper agents, tasks, and skills directly.\n\n[Walkthrough video.](https://www.youtube.com/watch?v=NZLAdOL9fP8)\n\n---\n\n## Install\n\n```bash\nnpx skills add hyperfx-ai/marketing-skills\n```\n\nAuto-detects your agent and drops the skills in the right directory. Then ask your agent something a skill knows about:\n\n\u003e *\"Plan a Google Ads search campaign for [example.com](http://example.com).\"*\n\n```bash\n# install one\nnpx skills add hyperfx-ai/marketing-skills --skill google-ads\n\n# install all 20\nnpx skills add hyperfx-ai/marketing-skills --all\n```\n\n[Other install options below.](#other-install-options)\n\n---\n\n## What it looks like\n\n\u003e **You:** Run a viral paid and organic campaign for [acmebakes.com](http://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.\n\u003e\n\u003e **Agent:** Learned your brand from [acmebakes.com](http://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.\n\u003e\n\u003e Generated 6 image creatives + 2 short videos in your brand style. **Everything's set up and paused** — view each one before setting it live:\n\u003e\n\u003e - **[Meta](https://adsmanager.facebook.com)** — $100/day, Advantage+ targeting, optimized for the Purchase event on your pixel, US 25–54.\n\u003e - **[TikTok Ads](https://ads.tiktok.com)** — $100/day, Traffic objective on the same audience, video creatives.\n\u003e - **[Google Ads Search](https://ads.google.com)** — $100/day, phrase + exact match on the two trending opportunities, negative keywords, sitelinks.\n\u003e - **TikTok + Instagram organic** — 3 posts queued (also paused), captions matched to trending sounds and hashtags.\n\u003e\n\u003e Total ad spend: **$300/day** ($100 each on Meta, Google, TikTok).\n\u003e\n\u003e Tell me when to set them live, and I'll set up a task to monitor them every hour.\n\nThat'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.\n\n---\n\n## Skills\n\n| Skill | What it does | Required integrations |\n|---|---|---|\n| **Paid ads** | | |\n| [`google-ads`](skills/google-ads) | Plan and launch Google Ads campaigns — Search, Display, and Performance Max. | Google Ads |\n| [`meta-ads`](skills/meta-ads) | Plan and launch Meta ad campaigns across Facebook and Instagram. | Meta Business, Firecrawl |\n| [`meta-ads-library`](skills/meta-ads-library) | Research competitor ads in the Meta Ads Library. | Apify |\n| [`amazon-ads`](skills/amazon-ads) | Plan and launch Amazon Sponsored Products campaigns. | Amazon Ads |\n| [`tiktok-ads`](skills/tiktok-ads) | Plan and launch TikTok ad campaigns across all objectives. | TikTok Marketing |\n| [`pinterest-ads`](skills/pinterest-ads) | Plan and launch Pinterest ad campaigns across all objectives. | Pinterest Ads |\n| **Social media** | | |\n| [`tiktok`](skills/tiktok) | Publish videos, photos, and carousels to TikTok. | TikTok (Login Kit) |\n| [`instagram`](skills/instagram) | Publish posts, Reels, Stories, and carousels. Moderate comments, send DMs, pull insights. | Instagram (Business Login) |\n| [`linkedin`](skills/linkedin) | Publish text, articles, documents, and AI-generated carousels — personal profiles and company pages. | LinkedIn |\n| **Research** | | |\n| [`seo-research`](skills/seo-research) | Keyword research, SERP and AI Overview analysis, competitor benchmarks, AI search visibility, backlinks, site audits. | HyperSEO toolkit |\n| [`competitor-intel`](skills/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 |\n| [`customer-research`](skills/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) |\n| [`youtube-transcript`](skills/youtube-transcript) | Fetch the transcript of any YouTube video and turn it into blog posts, social content, summaries, show notes, quote extractions, or timestamped chapters. | YouTube toolkit |\n| **Creative** | | |\n| [`ad-creative-generation`](skills/ad-creative-generation) | Generate ad copy and on-brand images for Google and Meta placements. | Firecrawl + image gen toolkit |\n| [`image-generation`](skills/image-generation) | Generate and edit images — picks the right model for text-heavy creatives, photoreal product shots, or high-res output. | Image gen toolkit |\n| [`video-generation`](skills/video-generation) | Generate AI video and prep it for distribution — text/image-to-video, captions, voiceover, stitching, overlays. | Video gen toolkit |\n| **Outbound \u0026 lifecycle** | | |\n| [`cold-email-outreach`](skills/cold-email-outreach) | Run end-to-end B2B cold outreach — prospect, enrich, personalize, send, follow up, route replies. | Gmail + Apollo (Firecrawl + LinkedIn scraper bundled) |\n| [`email-lifecycle`](skills/email-lifecycle) | Build welcome, nurture, re-engagement, win-back, and abandoned-cart email programs. | At least one of Klaviyo, Resend, Beehiiv, or Gmail |\n| **Analytics** | | |\n| [`analytics-insights`](skills/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 |\n| **Execution** | | |\n| [`hyper-cli`](skills/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 |\n\nInvoke explicitly with `/google-ads`, `/cold-email-outreach`, `/seo-research`, etc. — the slash name matches the folder under `skills/`.\n\n---\n\n## Usage\n\nSkill discovery is automatic. The transcript above shows multi-skill composition; smaller asks route to one skill at a time:\n\n\u003e *\"Pull all the active Facebook ads for 'meal kit delivery' into a database.\"*\n\u003e → `meta-ads-library`\n\n\u003e *\"Run a 50-prospect cold-email campaign to Heads of Growth at US Series A SaaS companies.\"*\n\u003e → `cold-email-outreach`\n\n\u003e *\"Pull last month's GA4 traffic by channel and flag any conversion event that dropped \u003e20%.\"*\n\u003e → `analytics-insights`\n\n\u003e *\"Build a weekly competitor digest for [comp-a, comp-b, comp-c] — site changes, social, search rank, mentions.\"*\n\u003e → `competitor-intel`\n\n---\n\n## Other install options\n\n```bash\n# install globally (available across every project)\nnpx skills add hyperfx-ai/marketing-skills -s seo-research -g\n\n# Claude Code plugin marketplace\n/plugin marketplace add hyperfx-ai/marketing-skills\n/plugin install hyper-marketing@hyperfx-marketing-skills\n\n# manual copy\ncp -r skills/google-ads ~/.claude/skills/         # Claude Code\ncp -r skills/google-ads ~/.agents/skills/         # Cursor / Codex / generic\n\n# git submodule\ngit submodule add https://github.com/hyperfx-ai/marketing-skills.git .agents/marketing-skills\n```\n\n---\n\n## Repo layout\n\n```\nmarketing-skills/\n├── .claude-plugin/plugin.json          # Claude Code plugin manifest\n├── .claude-plugin/marketplace.json    # Claude Code plugin marketplace catalog\n├── .mcp.json                          # Hyper MCP server config (bundled with plugin)\n├── .github/workflows/validate.yml     # CI: validate-skills.sh on PRs\n├── skills/                             # one folder per skill\n│   ├── \u003cskill\u003e/SKILL.md\n│   └── \u003cskill\u003e/references/*.md         # progressive disclosure on larger skills\n├── AGENTS.md                           # generic-agent entrypoint\n├── CLAUDE.md                           # Claude Code entrypoint\n├── CONTRIBUTING.md\n└── validate-skills.sh                  # frontmatter + MCP-call lints\n```\n\n---\n\n## Built-in tools\n\n| Tool | Description |\n|---|---|\n| E-commerce Scraper | Scrape product listings, prices, and reviews |\n| Firecrawl | Web scraping and crawling |\n| Google Search Scraper | Pull Google SERP data |\n| Google Trends Scraper | Pull Google Trends data |\n| HyperSEO | Keyword research, SERP analysis, AI search visibility |\n| Image Generation | Generate images (OpenAI, Nano Banana, Seedream) |\n| Instagram Scraper | Scrape Instagram posts, profiles, and engagement |\n| Knowledge Base | Query and manage the agent's knowledge base |\n| Location Search | Geo and location lookup |\n| Meeting Bot | Join, transcribe, and summarize meetings |\n| Meta Ads Library | Search, scrape, and download live and historical Meta ads |\n| Reddit Scraper | Scrape Reddit posts, threads, and comments |\n| TikTok Scraper | Scrape TikTok videos, profiles, and engagement |\n| Twitter Scraper | Scrape tweets, profiles, and threads |\n| Video Generation | Generate AI video (Sora, Veo, Seedance) |\n| Web Scraper | Search and scrape web pages |\n| Website Analyzer | Analyze a website's tech stack, pixels, and more |\n| YouTube | Search YouTube and fetch transcripts |\n\n## Native Hyper platform tools\n\n| Tool | Description |\n|---|---|\n| Database | Query and store data |\n| Code Execution | Run Python or JavaScript in a sandbox |\n| Toolkit Manager | Manage MCP toolkits and connections |\n| Skills | Manage and invoke skills |\n| Files | Built-in file system — read and write files |\n| Planning | Multi-step task planning |\n| Todo | Track tasks and progress |\n| Web Search | General-purpose web search |\n| Browser | Headless browser automation |\n| Agents | Create and manage agents (instructions, tasks, skills, context files, Slack channels) |\n| Hyper | Workspace, account, and platform-level actions |\n\n---\n\n## Roadmap\n\nNear-term skills and surfaces:\n\n- [x] `hyper-cli` (beta) — run these skills through the Hyper CLI from a terminal, cron job, or shell pipeline.\n- [ ] `google-ads-operator` — production Google Ads account operation and optimization.\n- [ ] `meta-account-audit` — Meta account diagnostics, spend checks, and performance recommendations.\n- [ ] `social-carousel` — carousel planning, copy, and export for social channels.\n- [ ] `cmo` — executive marketing reporting and cross-channel performance summaries.\n- [ ] `reddit-research` — focused Reddit research workflows for VOC, market maps, and positioning.\n- [ ] `slide-generation` — turn research, reports, and campaign plans into presentation decks.\n- [ ] `pdf-generation` — generate polished marketing reports and briefs.\n- [ ] `copywriting` — general-purpose marketing copy workflows.\n- [ ] `lead-generation` — prospect sourcing, enrichment, scoring, and handoff.\n- [ ] `crm-revops` — CRM hygiene, routing, attribution, and pipeline operations.\n- [ ] `google-sheets-writing` — structured spreadsheet creation and reporting.\n- [ ] `gmail-email-management` — inbox triage, labeling, reply drafting, and operational email workflows.\n- [ ] `figma` — design workflow support for ad creative, landing pages, and campaign assets.\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) to contribute a skill.\n\n---\n\n## Contributing\n\nPRs welcome. Every skill must pass `./validate-skills.sh` (frontmatter + MCP-call lint). See [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperfx-ai%2Fmarketing-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhyperfx-ai%2Fmarketing-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperfx-ai%2Fmarketing-skills/lists"}