![\"OpenClaudia\"](\"https://openclaudia.com/avatar.png\"){kind=avatar}
\n\n \n
\n The open-source marketing toolkit for AI coding agents.
\n 75 modular skills that turn Claude Code into a full marketing department.\n
\n ![\"npm](\"https://img.shields.io/npm/v/openclaudia?color=blue&label=npm\")
![\"GitHub](\"https://img.shields.io/github/stars/OpenClaudia/openclaudia-skills?style=social\")
![\"License:](\"https://img.shields.io/github/license/OpenClaudia/openclaudia-skills\")
![\"Website\"](\"https://img.shields.io/badge/website-openclaudia.com-purple\"){kind=icon}
\n Website · Quick Start · Usage Guide · Skills · Issues · Contributing\n
\n\n---\n\n## Why OpenClaudia?\n\nMost AI marketing tools charge **$50–300/month** for a chat box that gives you suggestions. OpenClaudia is different:\n\n| | SaaS Marketing Tools | OpenClaudia |\n|---|---|---|\n| **Price** | $50–300/month | Free & open source |\n| **Execution** | Suggests copy, you do the rest | Actually writes, publishes, sends |\n| **Data privacy** | Your data on their servers | Runs locally on your machine |\n| **Customization** | Limited to their UI | Fork, modify, extend any skill |\n| **Integration** | Walled garden | Works with 20+ APIs you already use |\n| **Setup** | Sign up, onboard, learn their UI | One command: `npx openclaudia install --all` |\n\n## Quick Start\n\n**Prerequisites:** [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed and authenticated.\n\n```bash\n# Install all 75 marketing skills\nnpx openclaudia install --all\n\n# Or install specific skills\nnpx openclaudia install seo-audit write-blog email-sequence\n```\n\nThen open Claude Code and start marketing:\n\n```\n$ claude\n\n> /audit-seo https://mysite.com\n✓ Analyzing 47 pages... SEO score: 72/100 — 12 issues found\n\n> /write-blog \"10 Tips for SaaS Growth\"\n✓ 2,400-word article generated with meta tags\n\n> /email-sequence --type product-launch\n✓ 6-email drip sequence created and sent via Resend\n\n> /competitor-analysis competitor.com\n✓ Full SEO, content, and positioning breakdown\n\n> /discord-bot \"New feature just dropped!\"\n✓ Rich embed posted to #announcements\n```\n\n### Alternative installation\n\n```bash\n# Via the skills CLI\nnpx skills add OpenClaudia/openclaudia-skills\n\n# Install a single skill\nnpx skills add OpenClaudia/openclaudia-skills --skill seo-audit\n\n# Manual: copy any skill directory into your skills folder\ncp -r skills/seo-audit ~/.claude/skills/ # personal\ncp -r skills/seo-audit .claude/skills/ # project-level\n```\n\n## Skills\n\n### SEO & Site Audit\n| Skill | Description |\n|-------|-------------|\n| `seo-audit` | Full technical + on-page SEO audit with actionable fixes |\n| `keyword-research` | Keyword research using SemRush API |\n| `serp-analyzer` | Analyze SERP results and ranking factors |\n| `backlink-audit` | Audit backlink profile and find opportunities |\n| `schema-markup` | Generate and validate Schema.org structured data |\n| `programmatic-seo` | Create SEO-optimized pages at scale |\n| `ahrefs-research` | Ahrefs Python SDK for backlinks, keywords, domain ratings, and traffic |\n| `geo-query-finder` | Find which ChatGPT search queries mention a brand (GEO visibility) |\n| `geo-difficulty` | Score keyword ranking difficulty for the AI-search era (page-level UR + AI Overview signal) |\n\n### Content Writing\n| Skill | Description |\n|-------|-------------|\n| `write-blog` | Generate SEO-optimized blog posts |\n| `write-landing` | Create high-converting landing page copy |\n| `copywriting` | Marketing copy for any page type |\n| `copy-editing` | Line-by-line copy polish and improvement |\n| `content-strategy` | Build content calendars and topic clusters |\n| `seo-content-brief` | Create structured SEO content briefs for writers |\n| `content-gap-analysis` | Identify content gaps vs. competitors |\n| `content-repurposing` | Atomize content across platforms and formats |\n\n> Publishing AI-assisted copy? Run it through [DetectAIWatermark](https://detectaiwatermark.com/?ref=openclaudia) first — it strips the invisible Unicode watermarks AI writing tools embed, so your text doesn't carry a machine-generated fingerprint.\n\n### Email Marketing\n| Skill | Description |\n|-------|-------------|\n| `email-sequence` | Create and send drip campaigns via Resend API |\n| `email-subject-lines` | Generate, A/B test, and send email subject lines |\n\n### Social Media\n| Skill | Description |\n|-------|-------------|\n| `social-content` | Create and publish posts to Reddit, X, LinkedIn, Instagram, Facebook |\n| `thread-writer` | Write and post viral threads on X and Reddit |\n| `content-calendar` | Plan and schedule social media content |\n| `linkedin-content` | LinkedIn-optimized posts, carousels, and strategy |\n| `bluesky` | Bluesky content creation and AT Protocol integration |\n| `reddit-marketing` | Authentic Reddit marketing and community engagement |\n\n### Ads & Conversion\n| Skill | Description |\n|-------|-------------|\n| `google-ads` | Write Google Ads copy and campaigns |\n| `facebook-ads` | Create Facebook/Meta ad campaigns |\n| `linkedin-ads` | Create LinkedIn ad campaigns and B2B advertising |\n| `page-cro` | Landing page conversion rate optimization |\n| `ab-test-setup` | Design and implement A/B tests |\n| `video-ad-analysis` | Deconstruct and analyze video ad creatives |\n\n### Analytics & Research (API-Powered)\n| Skill | Description | API Required |\n|-------|-------------|--------------|\n| `semrush-research` | SEO & competitive intelligence via SemRush | `SEMRUSH_API_KEY` |\n| `brand-monitor` | Brand monitoring via Brand.dev | `BRANDDEV_API_KEY` |\n| `brand-research` | Fetch brand info, logos, and industry data via Brand.dev | `BRANDDEV_API_KEY` |\n| `google-analytics` | Pull GA4 reports and insights | Google OAuth |\n| `search-console` | Google Search Console data & analysis | Google OAuth |\n| `gsc-portfolio-audit` | Rank ALL GSC properties by clicks with period-over-period deltas + keyword diffs | Google OAuth |\n| `google-ads-report` | Google Ads performance reporting | Google OAuth |\n| `google-reviews` | Google Maps ratings, review counts, and competitor analysis | `DATAFORSEO_LOGIN` |\n| `youtube-analytics` | YouTube channel and video performance analysis | `YOUTUBE_API_KEY` |\n| `github-stars` | Chart a repo's star growth by day and hour, any timezone | `gh` CLI |\n| `similarweb-traffic` | Fetch website traffic estimates, sources, countries, keywords, and ranks | None |\n| `ai-citations-report` | GEO report: which AI-search prompts cite a domain (Google AI Overview + ChatGPT), via [Enception](https://www.enception.ai)'s paid API | `ENCEPTION_API_KEY` |\n| `geo-analysis` | Full GEO/SEO client analysis with PDF report (AI visibility, market research, competitors), via [Enception](https://www.enception.ai)'s paid API | `ENCEPTION_ANALYSIS_API_KEY` |\n\n### Strategy & Planning\n| Skill | Description |\n|-------|-------------|\n| `marketing-ideas` | 139 proven marketing ideas by category |\n| `competitor-analysis` | Full competitor strategy breakdown |\n| `pricing-strategy` | Pricing page and strategy optimization |\n| `launch-strategy` | Product launch planning and execution |\n| `icp-builder` | Define ideal customer profiles |\n| `growth-strategy` | AARRR framework, growth loops, and experimentation |\n| `product-marketing` | Positioning, messaging, battlecards, and GTM |\n| `demand-gen` | Multi-channel demand generation and lead scoring |\n\n### Messaging & Notifications\n| Skill | Description | API Required |\n|-------|-------------|--------------|\n| `discord-bot` | Send messages, embeds, and marketing content to Discord | `DISCORD_WEBHOOK_URL` or `DISCORD_BOT_TOKEN` |\n| `slack-bot` | Post rich Block Kit messages and updates to Slack | `SLACK_WEBHOOK_URL` or `SLACK_BOT_TOKEN` |\n| `telegram-bot` | Send formatted posts, polls, and media to Telegram | `TELEGRAM_BOT_TOKEN` + `TELEGRAM_CHAT_ID` |\n| `feishu-lark` | Post interactive cards and updates to Feishu/Lark | `FEISHU_WEBHOOK_URL` or `FEISHU_APP_ID` |\n| `task-banner` | macOS desktop banner when Claude Code finishes a task, with mute toggle | None |\n\n### Content Assets\n| Skill | Description | API Required |\n|-------|-------------|--------------|\n| `stock-images` | Search Unsplash for stock photos with optional text overlay | `UNSPLASH_CLIENT_ID` |\n| `ai-image-gen` | Generate images from text prompts via OpenAI or Stability AI | `OPENAI_API_KEY` |\n| `marketing-slides` | Create marketing slides, pitch decks, and sales decks — outline, per-slide copy, and generation via ChatSlide | [ChatSlide](https://www.chatslide.ai) account |\n| `i18n` | Add full i18n to Next.js — 14+ locales, hreflang sitemaps, bulk translation | None |\n\n### Growth & Automation\n| Skill | Description |\n|-------|-------------|\n| `referral-program` | Design referral and viral loops |\n| `lead-magnet` | Create lead magnets and gated content |\n| `signup-flow-cro` | Optimize signup conversion funnels |\n| `onboarding-cro` | Improve user onboarding flows |\n| `affiliate-marketing` | Build and manage affiliate partner programs |\n| `newsletter` | Newsletter growth, engagement, and monetization |\n| `podcast-marketing` | Podcast production, growth, and promotion |\n| `podcast-edit` | Edit podcast audio — trim, remove fillers, normalize loudness |\n| `stripe-dispute` | Fight Stripe disputes and chargebacks with evidence + counter-dispute |\n| `organize-skills` | Rename a skill library to a naming convention and fix the symlinks + cross-references it breaks |\n| `wechat-moments` | Rank your own WeChat Moments feed — real news above marketing, weighted by who you actually talk to ([separate repo](https://github.com/OpenClaudia/wechat-moments)) |\n\n### CRM & Outreach (API-Powered)\n| Skill | Description | API Required |\n|-------|-------------|--------------|\n| `hubspot` | HubSpot CRM contacts, deals, companies, and CMS | `HUBSPOT_ACCESS_TOKEN` |\n| `apollo-outreach` | B2B lead research and enrichment via Apollo.io | `APOLLO_API_KEY` |\n| `domain-research` | Domain WHOIS lookup and marketplace listings | None (free API) |\n\n## API Configuration\n\nSome skills integrate with external APIs for live data. Set these in your `.env` or `~/.claude/.env.global`:\n\n```bash\n# Email (email-sequence, email-subject-lines)\nRESEND_API_KEY=your_key_here\n\n# SemRush (keyword-research, semrush-research, backlink-audit, competitor-analysis)\nSEMRUSH_API_KEY=your_key_here\n\n# Ahrefs (backlink-audit — alternative to SemRush)\nAHREFS_API_KEY=your_key_here\n\n# SerpAPI (serp-analyzer, keyword-research, competitor-analysis)\nSERPAPI_API_KEY=your_key_here\n\n# DataForSEO (serp-analyzer, keyword-research)\nDATAFORSEO_LOGIN=your_login\nDATAFORSEO_PASSWORD=your_password\n\n# Brand.dev (brand-monitor)\nBRANDDEV_API_KEY=your_key_here\n\n# Google OAuth (google-analytics, search-console, gsc-portfolio-audit, google-ads-report)\nGOOGLE_CLIENT_ID=your_client_id\nGOOGLE_CLIENT_SECRET=your_client_secret\n\n# OpenAI (ai-image-gen)\nOPENAI_API_KEY=your_key_here\n\n# Stability AI (ai-image-gen — alternative to OpenAI)\nSTABILITY_API_KEY=your_key_here\n\n# Unsplash (stock-images, write-blog, social-content — featured images)\nUNSPLASH_CLIENT_ID=your_access_key\n\n# Reddit (social-content — trending topics)\nREDDIT_CLIENT_ID=your_client_id\nREDDIT_CLIENT_SECRET=your_client_secret\n\n# ScrapingBee (competitor-analysis — scraping protected pages)\nSCRAPINGBEE_API_KEY=your_key_here\n\n# YouTube Data API (youtube-analytics)\nYOUTUBE_API_KEY=your_key_here\n\n# HubSpot (hubspot)\nHUBSPOT_ACCESS_TOKEN=your_private_app_token\n\n# Apollo.io (apollo-outreach)\nAPOLLO_API_KEY=your_key_here\n\n# Bluesky (bluesky)\nBLUESKY_HANDLE=your.handle\nBLUESKY_APP_PASSWORD=your_app_password\n\n# Discord (discord-bot)\nDISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/...\nDISCORD_BOT_TOKEN=your_bot_token\n\n# Slack (slack-bot)\nSLACK_WEBHOOK_URL=https://hooks.slack.com/services/...\nSLACK_BOT_TOKEN=xoxb-your-bot-token\n\n# Telegram (telegram-bot)\nTELEGRAM_BOT_TOKEN=your_bot_token\nTELEGRAM_CHAT_ID=your_chat_id\n\n# Feishu / Lark (feishu-lark)\nFEISHU_WEBHOOK_URL=https://open.feishu.cn/open-apis/bot/v2/hook/...\nFEISHU_WEBHOOK_SECRET=your_secret\nFEISHU_APP_ID=your_app_id\nFEISHU_APP_SECRET=your_app_secret\n```\n\nAll API keys are optional — skills work without them but provide richer data when configured. Each skill tells you which key is needed when invoked.\n\n## Works With Any AI Coding Agent\n\nOpenClaudia skills are designed for **Claude Code** but also work with:\n\n- **OpenAI Codex** — drop skills into your agent's tools directory\n- **Cursor / Windsurf** — use as custom instructions or rules\n- **Any agent** that supports markdown instruction files\n\n## Contributing\n\nWe welcome contributions! Whether it's a new marketing skill, a bug fix, or documentation improvement.\n\n1. Fork this repository\n2. Create a new skill directory under `skills/`\n3. Add a `SKILL.md` with YAML frontmatter and instructions\n4. Submit a pull request\n\nSee **[CONTRIBUTING.md](CONTRIBUTING.md)** for the full guide, including skill authoring conventions and code review standards.\n\n### Good first issues\n\nLook for issues tagged [`help wanted`](https://github.com/OpenClaudia/openclaudia-skills/labels/help%20wanted) — these are curated for new contributors.\n\n## Ecosystem\n\nOpenClaudia is part of a growing ecosystem of AI agent tools:\n\n- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) — the AI coding agent by Anthropic\n- [GEO Guide](https://howtowingeo.com) — how to win at Generative Engine Optimization\n- [PageGun](https://pagegun.com) — AI-powered CMS for content publishing\n- [DetectAIWatermark](https://detectaiwatermark.com/?ref=openclaudia) — detect and remove invisible AI watermarks from your text\n- [wechat-moments](https://github.com/OpenClaudia/wechat-moments) — the scripts behind the `wechat-moments` skill, kept separate because they depend on the WeChat desktop client rather than a marketing API\n\n## Sponsors\n\nOpenClaudia is proudly sponsored by:\n\n- [Free AI Slides Maker](https://chatslide.ai) — AI-powered presentation maker\n- [Enception.ai](https://enception.ai) — AI marketing agency\n- [Quanl.ai](https://quanl.ai) — AI & GEO insights from founder Quanlai Li\n- [Makeform.ai](https://makeform.ai) — AI form builder, AI survey builder, and AI survey maker\n\n## License\n\nMIT — see [LICENSE](LICENSE)\n\n## Star History\n\n\n\nUpdated 2026-08-25. GitHub [restricted the stargazers API](https://github.blog/changelog/2026-06-30-upcoming-access-restrictions-to-public-api-endpoints-and-ui-views/) in June 2026, so the live star-history.com badge no longer renders; this chart is generated from the repo's own star data.\n\n---\n\n\n Created by Quanlai Li and the OpenClaudia community.
\n Contact: mail@quanl.ai
\n Not affiliated with Anthropic.\n