| name | claude-code-marketing-skills |
| description | Give AI coding agents SEO audits, ad analysis, competitor research, and 20+ marketing skills — free skills use public data, premium skills connect live Search Console, Bing, LinkedIn, HubSpot, email platforms via Cogny MCP |
| triggers | ["install marketing skills for Claude","audit SEO with AI agent","analyze competitors with Claude Code","connect Search Console to AI agent","run LinkedIn ads audit","generate non-commodity content","review landing page conversion","qualify leads with AI"] |
Claude Code Marketing Skills
Skill by ara.so — Marketing Skills collection.
Turn Claude Code, Cursor, Windsurf, or any MCP-compatible AI agent into a marketing analyst. This project provides 20+ marketing skills that let your AI audit SEO, analyze ads, research competitors, qualify leads, and more — all from your terminal.
Free skills work immediately using web search and public data (no account needed).
Premium skills connect to your Google Ads, Meta Ads, Search Console, Bing, LinkedIn, HubSpot, Klaviyo, Mailchimp, Rule, Get a Newsletter, and Discord via Cogny MCP ($9/mo for all managed MCPs).
Installation
Quick Install (recommended)
curl -sSL https://raw.githubusercontent.com/cognyai/claude-code-marketing-skills/main/install.sh | bash
This installs all skills to .claude/skills/ in your project directory.
Manual Installation
git clone https://github.com/cognyai/claude-code-marketing-skills.git
cp -r claude-code-marketing-skills/skills/* .claude/skills/
cp -r claude-code-marketing-skills/skills/* "${CODEX_HOME:-$HOME/.codex}/skills/"
Verify Installation
After installation, your AI agent can list available skills:
What marketing skills do I have?
You should see 20+ skills including /seo-audit, /competitor-analysis, /linkedin-ads-audit, etc.
Free Skills (No Account Required)
These skills work immediately using WebFetch and WebSearch tools built into Claude Code:
SEO Audit
/seo-audit https://example.com
Performs comprehensive SEO analysis:
- Technical SEO (meta tags, headings, schema, crawlability)
- Content quality and keyword usage
- Core Web Vitals estimates
- Internal linking structure
- Mobile optimization
When connected to Search Console + Bing via Cogny, adds live data:
- Actual rankings and queries
- Click-through rates
- Indexing status
- Real Core Web Vitals from CrUX
Non-Commodity Content
/non-commodity-content
Interviews you to extract real client stories, refusals, and numbers, then drafts an SEO content brief Google actually ranks. Output format:
- Title + meta description
- H2 outline with specific examples
- Client quotes and case numbers
- What you refuse to do (differentiation)
Landing Page Review
/landing-page-review https://example.com/landing
CRO analysis with specific recommendations:
- Value proposition clarity
- Call-to-action effectiveness
- Social proof and trust signals
- Form friction points
- Mobile conversion blockers
Competitor Analysis
/competitor-analysis example.com competitor1.com competitor2.com
Research competitors:
- Positioning and messaging differences
- Ad copy patterns (searches for ads.txt and samples)
- Feature comparison
- Market gaps and opportunities
Ad Copy Writer
/ad-copy-writer "product description" --platform=google
Generates 10+ ad variations for Google Ads, Meta, or LinkedIn:
- Multiple headline variations
- Benefit-focused descriptions
- CTA variations
- Character count compliance
Lead Qualification
/lead-qualification "company name" --icp="B2B SaaS, 50-200 employees"
Research and qualify leads:
- Company profile (size, industry, tech stack)
- Key decision makers
- Recent news and hiring patterns
- ICP match score and reasoning
Technical Reference Skills
These skills provide instant reference docs (no external calls):
/ga4-bigquery-schema — Complete GA4 BigQuery export schema with query patterns/ga4-events — GA4 event model, recommended events, custom dimensions/gtm-setup — GTM dataLayer, triggers, variables, tag configuration/gaql-reference — Google Ads Query Language syntax and common queries/conversion-debug — Cross-platform conversion tracking troubleshooting/meta-capi — Meta Conversions API setup and event deduplication/utm-builder — UTM naming conventions and validation queries/structured-data — Schema.org JSON-LD templates for rich results/cwv-audit — Core Web Vitals diagnosis with CrUX BigQuery queries/google-ads-scripts — Google Ads Scripts patterns and automation
Email Marketing Skills
/welcome-series — Generate 5-email welcome series from brand URL/deliverability-check — Audit SPF/DKIM/DMARC/BIMI on sending domain
Website Migration Audit
/website-migration-audit https://production.com https://staging.com
Compare production vs staging for SEO parity:
- URL structure changes
- Meta tag consistency
- Schema markup preservation
- Internal linking integrity
- Redirect validation
Enhanced with Search Console data when connected.
Premium Skills (Requires Cogny MCP)
Premium skills connect to your actual marketing accounts via Cogny's MCP servers.
Setup
-
Sign up at cogny.com ($9/mo for all MCPs)
-
Connect your accounts:
- Google Ads
- Meta Ads
- Search Console
- Bing Webmaster Tools
- LinkedIn Ads
- HubSpot
- Klaviyo / Mailchimp / Rule / Get a Newsletter
- Discord
-
Add Cogny to your MCP config:
Create or edit .mcp.json in your project root:
{
"mcpServers": {
"cogny": {
"type": "http",
"url": "https://app.cogny.com/mcp"
}
}
}
For Codex, edit ~/.codex/config.json:
{
"mcpServers": {
"cogny": {
"type": "http",
"url": "https://app.cogny.com/mcp"
}
}
}
- Authenticate on first use:
Run any premium skill — Claude will open a browser for OAuth login.
LinkedIn Ads Audit
/linkedin-ads-audit
Analyzes your LinkedIn Ads account:
- Campaign structure and naming
- Targeting precision and overlap
- Creative performance by format
- Spend efficiency and waste
- Specific optimization recommendations with expected impact
Requires: LinkedIn Ads account connected via Cogny.
SEO Monitor
/seo-monitor example.com
Track rankings and indexing from Search Console + Bing:
- Query performance (clicks, impressions, CTR)
- Ranking changes (week-over-week)
- Indexing status and coverage issues
- Core Web Vitals from real user data
- AI citations (Bing Copilot appearance count)
Requires: Search Console + Bing Webmaster Tools connected via Cogny.
CRM ICP Analysis
/crm-icp-analysis
Build data-driven ICP from your HubSpot closed-won deals:
- Company size, industry, revenue patterns
- Decision maker titles and seniority
- Sales cycle length by segment
- Common tech stack and signals
- Negative fit patterns (lost deals)
Requires: HubSpot account connected via Cogny.
Sales Momentum Drivers
/crm-sales-momentum
Pipeline velocity analysis from HubSpot:
- Stage conversion rates
- Time-in-stage benchmarks
- Stuck deals (>30 days in stage)
- Win/loss patterns by source
- Deal momentum score
Requires: HubSpot account connected via Cogny.
LinkedIn Micro Campaigns
/linkedin-micro-campaigns
Create precision-targeted LinkedIn campaigns from ICP data:
- Pulls ICP segments from HubSpot closed-won deals
- Generates account lists and targeting criteria
- Drafts ad creative variations per segment
- Suggests bid strategies and budgets
- Outputs campaign structure ready to upload
Requires: HubSpot + LinkedIn Ads connected via Cogny.
Email Marketing Skills (Premium)
All require email platform connected via Cogny (Klaviyo, Mailchimp, Rule, or Get a Newsletter):
Subject Line Lab
/subject-line-lab
Mines your last 100+ email sends:
- Identifies subject line patterns that lift opens on your list
- Finds emoji/formatting/length correlations with engagement
- Generates 20 tuned subject line candidates
- A/B test recommendations
Winback Engine
/winback-engine
Finds dormant subscribers and drafts tiered winback series:
- Segments by historical purchase/engagement value
- Generates personalized winback emails per tier
- Flags suppression candidates (never engaged)
- Suggests send schedule and exit criteria
Pre-Send QA
/pre-send-qa
Pre-flight QA for draft campaigns:
- Merge tag fallback validation
- Broken link detection
- Spam trigger words
- CAN-SPAM compliance check
- Mobile rendering issues
Email Report
/email-report --period=last-7-days
Auto-generates performance report in 3 formats:
- Slack channel message (markdown)
- CEO email summary (plain text)
- Board deck section (bullet points)
Includes: sends, opens, clicks, revenue, top campaigns, trends.
Revenue Audit
/revenue-audit
"Email growth consultant in a box":
- Missing automated flows (welcome, abandon, winback)
- Dormant high-value subscribers
- Under-segmented broadcast campaigns
- Each issue ranked by estimated $ impact
Drop-off Rescue
/drop-off-rescue
Finds contacts stalled at funnel stages:
- Abandoned cart (cart exists >24h)
- Signed up but no trial started
- Trial started but no conversion
- Drafts re-engagement emails per stage
- Schedules sends without double-sending on reruns
Community Pulse
/community-pulse
Weekly Discord community digest:
- New joins and intro activity
- Hot channels and dead channels
- Top contributors and lurker→active conversions
- Unanswered questions
- 3-6 actionable improvements you can ship in 15 min
Requires: Discord server connected via Cogny.
Cogny Agent (Full Autonomy)
/cogny "increase LinkedIn conversion rate"
Full autonomous marketing agent:
- Runs scheduled analysis across all connected platforms
- Generates strategy recommendations
- Executes approved changes (with confirmation)
- Reports results and iterates
Requires: Cogny account with at least one platform connected.
Architecture
Your AI Agent (local)
├── Free Skills → WebFetch + WebSearch (public data)
└── Premium Skills → Cogny MCP Server (hosted)
├── OAuth/Token auth
└── Your connected accounts:
├── Google Ads API
├── Meta Ads API
├── Search Console API
├── Bing Webmaster API
├── LinkedIn Ads API
├── HubSpot API
├── Klaviyo API
├── Mailchimp API
├── Rule API
├── Get a Newsletter API
└── Discord API
Your AI runs locally (Claude Code, Cursor, Codex). Cogny provides the data pipeline via MCP.
Common Patterns
Daily SEO Monitoring
Add to .claude/prompts/daily-seo.md:
Every morning at 9am:
1. Run /seo-monitor for our main domain
2. Compare yesterday's top queries vs last week
3. Flag any ranking drops >3 positions
4. Summarize in #marketing Slack
Set up a cron or use Cogny Agent to run automatically.
Weekly Competitor Check
Every Monday:
1. Run /competitor-analysis with our top 3 competitors
2. Check for new ad copy patterns
3. Flag any major positioning changes
4. Update competitive brief in Notion
Pre-Launch Checklist
Before any landing page launch:
1. Run /landing-page-review on staging URL
2. Run /conversion-debug to verify tracking
3. Run /structured-data to validate schema
4. Run /cwv-audit for performance baseline
5. Run /pre-send-qa if email campaign involved
Troubleshooting
Skill Not Found
Problem: Skill /seo-audit not found
Solution:
- Verify installation:
ls .claude/skills/ (or ~/.codex/skills/ for Codex)
- Re-run install script:
curl -sSL https://raw.githubusercontent.com/cognyai/claude-code-marketing-skills/main/install.sh | bash
- Restart your AI agent
Premium Skill Authentication Failed
Problem: Authentication required for Cogny MCP
Solution:
- Verify
.mcp.json exists and contains Cogny server config
- Check you're signed in at cogny.com
- Verify the account you want to access is connected in Cogny dashboard
- Clear MCP auth cache:
rm -rf ~/.cache/claude/mcp/cogny (path may vary by agent)
- Re-run the skill — browser should open for OAuth
Search Console Data Not Appearing
Problem: /seo-audit or /seo-monitor shows only public data, not Search Console metrics
Solution:
- Verify Search Console is connected in Cogny dashboard
- Verify the domain in Search Console matches the domain you're auditing (including www/non-www)
- Wait 24h after connecting — Search Console API can have initial delays
- Check Cogny logs for API errors: cogny.com/logs
LinkedIn Ads Audit Returns Empty
Problem: /linkedin-ads-audit finds no campaigns
Solution:
- Verify LinkedIn Ads account is connected in Cogny dashboard
- Ensure you have active or paused campaigns (archived campaigns may not appear)
- Check you're connected to the correct ad account if you manage multiple
- Verify API permissions: Cogny needs "Read ads" permission
Email Skills Show No Data
Problem: /subject-line-lab or other email skills return no data
Solution:
- Verify your ESP (Klaviyo, Mailchimp, Rule, or Get a Newsletter) is connected in Cogny
- Ensure you have sent campaigns in the time period (default: last 90 days)
- Check API rate limits — some ESPs throttle heavily; retry in 1 hour
- For Klaviyo specifically: verify API key has "Read-only" or "Full" access (not "No Access")
Skill Runs But Output Is Generic
Problem: Free skill gives vague recommendations instead of specific data
Solution:
- Free skills use web search, which can be limited. For better results:
- Upgrade to premium skills for live data ($9/mo via Cogny)
- Provide more context in your prompt:
/seo-audit https://example.com --focus=technical
- Be specific about what you want analyzed: "Check mobile Core Web Vitals specifically"
Creating Custom Skills
You can add your own marketing skills. Example structure:
---
name: your-skill-name
description: One-line description of what the skill does
triggers:
- natural phrase 1
- natural phrase 2
---
# Your Skill Name
## What This Skill Does
Brief explanation.
## Usage
/your-skill-name [arguments]
## Steps
1. First step with specific action
2. Second step with specific action
3. Third step with output format
## Example Output
\```
Expected output format here
\```
Save to .claude/skills/your-skill-name.md (or ~/.codex/skills/ for Codex).
Environment Variables
Premium skills authenticate via OAuth (no env vars needed).
If you're developing custom skills that use APIs directly:
export GOOGLE_ADS_DEVELOPER_TOKEN=your-dev-token
export GOOGLE_ADS_CLIENT_ID=your-oauth-client-id
export GOOGLE_ADS_CLIENT_SECRET=your-oauth-secret
export GOOGLE_ADS_REFRESH_TOKEN=your-refresh-token
export META_ACCESS_TOKEN=your-long-lived-token
Never commit tokens to git. Use .env files and add to .gitignore.
Real Results
GrowthHackers.se connected Search Console + Bing via Cogny MCP, ran /seo-audit + /seo-monitor after a site migration:
- +271% organic clicks in 3 weeks
- +60% search impressions
- +154% AI citations (Bing Copilot)
- CTR: 0.29% → 0.66%
- PageSpeed: 78 → 97
Full case study →
Contributing
PRs welcome! See existing skill files for format. Skills should include:
- YAML frontmatter with
name, description, triggers
- Clear step-by-step instructions
- Specific queries/actions (not vague recommendations)
- Example output format
License
MIT
Links
