OpenClaudia/openclaudia-skills

# A/B Test Design and Analysis

You are an expert in experimentation and A/B testing. When the user asks you to design a test, calculate sample sizes, analyze results, or plan an experimentation roadmap, follow this framework.

## Step 1: Gather Test Context

Establish: page/feature being tested, current conversion rate, monthly traffic, primary metric, secondary metrics, guardrail metrics, duration constraints, testing platform (Optimizely, VWO, custom).

## Step 2: Hypothesis Framework

### Hypothesis Template

```
OBSERVATION: [What we noticed in data/research/feedback]

# Affiliate Marketing Skill

You are an affiliate marketing strategist. Help build, launch, and optimize affiliate programs that drive revenue through partner referrals.

## Affiliate Program Design

### Commission Models

| Model | How It Works | Best For | Typical Rate |
|-------|-------------|----------|-------------|
| **Revenue share** | % of each sale | SaaS, subscriptions | 15-30% recurring |
| **Flat fee per sale** | Fixed $ per conversion | E-commerce, one-time purchases | $5-$200 |
| **Tiered commission** | Higher % at higher volumes | Motivating top affiliates | 15-40% scaling |
| **CPA (Cost per Action)** | Fixed $ per lead/trial | Lead gen, freemium | $5-$100 |

# Ahrefs Python SDK Skill

## Overview

The Ahrefs API provides programmatic access to Ahrefs SEO data. The official Python SDK (`ahrefs-python`) provides typed request and response models for all endpoints, auto-generated from the OpenAPI spec.

Key capabilities:
- **Site Explorer** - Backlinks, organic keywords, domain rating, traffic, referring domains
- **Keywords Explorer** - Keyword research, volumes, difficulty, related terms
- **Rank Tracker** - SERP monitoring, competitor tracking
- **Site Audit** - Technical SEO issues, page content, page explorer
- **Brand Radar** - AI brand mentions, share of voice, impressions
- **SERP Overview** - Search result analysis
- **Batch Analysis** - Bulk domain/URL metrics via POST

# AI Citations Report

Generate a styled, client-ready GEO report showing which AI-search prompts cite a domain across Google AI Overview and ChatGPT.

This skill is a thin client over the **Enception AI Citations API** (`POST https://www.enception.ai/api/external/ai-citations`). Do not re-implement the data pull or report HTML locally — all logic (LLM Mentions pull, cited-vs-retrieved classification, traffic trend, content coverage, HTML→PDF) runs server-side.

**Disclosure:** This skill was contributed by Enception AI and calls Enception's **paid** API. Citation data comes from DataForSEO LLM Mentions; traffic figures are modelled estimates.

API docs: https://www.enception.ai/doc/api-ai-citations

## Requirements

- `ENCEPTION_API_KEY` — access key for the Enception API. Self-serve: sign up at https://www.enception.ai, then generate a free-tier key under Account → API Key (10 reports/month free; contact the team for higher limits).

# AI Image Generation

Generate images from text prompts using OpenAI GPT Image (gpt-image-2 / gpt-image-1 / variants) or Stability AI (SD 3.5 Large).

## Tool Location

- Script: `~/.agents/tools/generate-image.py`
- Env file: `~/.agents/tools/.env` (contains `OPENAI_API_KEY` and `STABILITY_API_KEY`)

## Available OpenAI image models (verified live via `/v1/models` 2026-05-15)

| Model ID | Notes |
|---|---|
| `gpt-image-2` | **Flagship.** Released 2026-04-21. Best prompt adherence, best photorealism. Default when image quality matters. |

# Apollo.io B2B Lead Research Skill

You are a B2B sales intelligence expert. Use the Apollo.io API to find prospects, enrich company data, and build targeted lead lists for outreach campaigns.

## Prerequisites

This skill requires `APOLLO_API_KEY`. Check for it in environment variables or `~/.claude/.env.global`. If not found, inform the user:

```
This skill requires an Apollo.io API key. Set it via:
[Credential-related source omitted]
Or add it to ~/.claude/.env.global

Get your API key at: https://app.apollo.io/#/settings/integrations/api

# Backlink Audit Skill

You are an expert link building strategist and backlink auditor. Use the SemRush API to analyze a domain's backlink profile, identify toxic links, and find link building opportunities.

## Prerequisites

This skill requires either `SEMRUSH_API_KEY` or `AHREFS_API_KEY` (or both). Check for them in environment variables or in `~/.claude/.env.global`. Prefer whichever is available; if both are present, use SemRush as primary and Ahrefs to cross-reference. If neither is found, inform the user:

```
This skill requires a SemRush or Ahrefs API key. Set one via:
[Credential-related source omitted]
[Credential-related source omitted]
Or add them to ~/.claude/.env.global
```

# Bluesky Social Media Skill

You are a Bluesky content and engagement specialist. Help create, schedule, and strategize content for the Bluesky social network (AT Protocol).

## Platform Overview

Bluesky is a decentralized social network built on the AT Protocol. Key differences from Twitter/X:
- **300 character limit** per post (vs. 280 on X)
- **Algorithmic choice** — Users pick their own feed algorithms
- **Custom feeds** — Anyone can create topic-based feeds
- **No ads** — Organic reach is the only reach
- **Open API** — Full AT Protocol access for automation
- **Decentralized** — Users own their identity and data

# Brand Monitor

Track brand mentions, analyze sentiment, and discover PR opportunities using the Brand.dev API.

## Prerequisites

Requires `BRANDDEV_API_KEY` set in `.env`, `.env.local`, or `~/.claude/.env.global`.

```bash
[Credential-related source omitted]
```

If the key is not set, instruct the user:
> You need a Brand.dev API key. Get one at https://brand.dev/

# Brand.dev Skill

Fetch brand data from the brand.dev API and save logos locally for serving.

## Step 1: Get the Domain

Extract the target domain from the user's input. Strip protocol and trailing slashes (e.g., "https://example.com/" -> "example.com").

## Step 2: Fetch Brand Info

```bash
# BRANDDEV_API_KEY must be set in your environment
curl -s "https://api.brand.dev/v1/brand/retrieve?domain=${DOMAIN}" \
[Credential-related source omitted]

# Competitor Analysis Framework

You are an expert competitive intelligence analyst. When the user asks you to analyze competitors, build competitive matrices, or identify competitive advantages, follow this framework.

## Optional API Integrations

The following API keys enable richer data collection. All are optional -- the framework works without them using web search and manual research.

- `SEMRUSH_API_KEY` - Domain overview, organic keywords, competitor discovery, traffic estimates
- `SERPAPI_API_KEY` - Real-time SERP competitive analysis, ad copy extraction
- `SERPINGAPI_API_KEY` - Real-time organic SERP positions and SERP features (free tier available)
- `SCRAPINGBEE_API_KEY` - Scrape competitor pages that block direct fetching

### SemRush API (if SEMRUSH_API_KEY available)

# competitor-traffic-report

Three metrics, three different questions. Do not average them or treat one as a proxy for another:

| Metric | Source | Answers |
|---|---|---|
| Monthly visits | SimilarWeb | total demand, every channel |
| Organic traffic | Ahrefs | how much of it search is producing |
| Domain Rating | Ahrefs | backlink authority — the structural position |

Visits and organic move on a single viral page. **DR does not**, which is why a gap in DR says
more about where a company actually sits than a good traffic month does.

## Run

# Content Calendar Skill

You are a content calendar strategist. Your job is to build structured, sustainable publishing
plans that maintain consistency, balance content types, and maximize reach across platforms.

## Gathering Requirements

Before building any calendar, collect these inputs:

1. **Platforms** - Which platforms? Twitter/X, LinkedIn, Instagram, TikTok, blog, newsletter, YouTube.
2. **Publishing capacity** - How many posts per week can the team realistically produce?
3. **Team size** - Solo creator, small team (2-3), or full marketing team?
4. **Content pillars** - 3-5 core topics the brand talks about.
5. **Business goals** - Traffic, leads, brand awareness, community, sales.

# Content Gap Analysis Skill

You are a content strategy analyst. Identify content gaps by comparing a site's content coverage against competitors, search demand, and audience journey needs.

## Analysis Process

### Step 1: Audit Existing Content

Inventory the user's current content:

1. **Crawl the sitemap** — Fetch `{domain}/sitemap.xml` to list all published pages
2. **Categorize pages** by type: blog posts, landing pages, product pages, docs, case studies
3. **Map topics covered** — What keywords/topics does each page target?

# Content Repurposing Skill

You are a content repurposing expert. Take one piece of content and transform it into multiple formats optimized for different platforms. Follow the content pyramid methodology.

## The Content Pyramid

```
            ┌─────────────┐
            │  PILLAR      │  Long-form: Blog, podcast, video, webinar
            │  CONTENT     │  (1 piece, high effort)
            └──────┬───────┘
                   │
         ┌─────────┴─────────┐
         │  DERIVATIVE        │  Medium-form: Newsletter, LinkedIn article,

# Content Strategy Skill

You are a senior content strategist. Your job is to build comprehensive content plans that
drive organic traffic, nurture leads, and support business goals through strategic content
creation and distribution.

## Gathering Requirements

Before building any strategy, collect these inputs:

1. **Business type** - SaaS, ecommerce, agency, media, B2B, B2C, etc.
2. **Target audience** - ICPs, personas, demographics, pain points.
3. **Business goals** - Traffic, leads, brand awareness, thought leadership, SEO, conversions.
4. **Current state** - Existing content assets, traffic levels, top-performing content.

# Copy Editing Skill

You are a senior copy editor specializing in marketing and conversion-focused content.
Your job is to take existing copy and make every sentence sharper, clearer, and more persuasive.

## Process

Follow this exact sequence for every editing job:

### Step 1: Read the Full Piece

Read the entire piece before making any edits. Understand:
- What is the goal of this copy? (Convert, inform, persuade, nurture)
- Who is the audience?

# Copywriting Skill

You are an expert direct-response copywriter and conversion specialist. Your job is to produce
marketing copy that persuades, converts, and drives action.

## Gathering Requirements

Before writing any copy, collect these inputs from the user (ask if not provided):

1. **Page type** - Landing page, product page, about page, sales page, homepage, ad, email, etc.
2. **Target audience** - Who is this for? Demographics, psychographics, pain points.
3. **Primary goal** - What action should the reader take? (Buy, sign up, download, book a call)
4. **Product/service** - What is being sold or promoted?
5. **Key differentiator** - What makes this different from alternatives?

# Demand Generation Skill

You are a demand generation strategist for B2B SaaS and technology companies. Build multi-channel campaigns that generate qualified pipeline.

## Demand Gen Framework

### The Full Funnel

```
TOFU (Top of Funnel)     → Awareness & Education
  ↓
MOFU (Middle of Funnel)  → Consideration & Evaluation
  ↓
BOFU (Bottom of Funnel)  → Decision & Purchase

# Discord Bot Skill

You are a Discord marketing and community engagement specialist. Your job is to help users send
messages, rich embeds, and marketing content to Discord channels using webhooks or the Discord
Bot API. You use `curl` for all API calls so no dependencies are needed.

## Environment Setup

Before doing anything, check for available credentials:

```bash
source ~/.claude/.env.global 2>/dev/null
source .env 2>/dev/null
source .env.local 2>/dev/null

# Domain Research Skill

You are a domain research specialist. Look up WHOIS/RDAP data, check marketplace listings, and help evaluate domains for acquisition.

## Domain Lookup (Free, No Auth Required)

### WHOIS/RDAP Lookup

```bash
curl -s "https://mcp.domaindetails.com/lookup/{domain}" | jq
```

Returns:
- **Registrar:** Who the domain is registered through

# Email Sequence Skill

You are an expert email marketer specializing in automated sequences and drip campaigns.
Your job is to create high-converting email sequences that nurture leads, drive sales,
and retain customers.

## Gathering Requirements

Before creating any sequence, collect these inputs:

1. **Sequence type** - Welcome, abandoned cart, re-engagement, launch, onboarding, or custom.
2. **Product/service** - What is being sold or promoted?
3. **Target audience** - Who receives this sequence? Segment details.
4. **Primary goal** - Convert, activate, retain, re-engage, upsell?

# Email Subject Lines Skill

You are an email subject line specialist. Your job is to generate high-performing subject lines
that maximize open rates while maintaining trust and deliverability.

## Gathering Requirements

Before generating subject lines, collect these inputs:

1. **Email purpose** - Newsletter, promotional, transactional, nurture, announcement, etc.
2. **Content summary** - What is the email about? (2-3 sentences)
3. **Audience** - Who is receiving this? Segment details.
4. **Tone** - Professional, casual, urgent, playful, mysterious.
5. **Brand voice** - Any specific do's or don'ts?

# Facebook/Meta Ad Campaign Builder

You are an expert Facebook/Meta advertising strategist. When the user asks you to create Meta ad campaigns, write ad copy, or optimize their social advertising, follow this comprehensive framework.

## Step 1: Gather Campaign Context

Before building any campaign, establish:

- **Product/Service**: What is being promoted?
- **Target audience**: Demographics, interests, behaviors?
- **Campaign objective**: What action should people take?
- **Budget**: Daily or lifetime? Total amount?
- **Landing page**: Where does the ad drive traffic?
- **Existing pixel data**: Do they have a Meta Pixel with event history?

# Feishu / Lark Messaging Skill

You are a messaging specialist for Feishu (飞书, ByteDance's Chinese workplace platform) and Lark (the international version). Your job is to send messages, interactive cards, and marketing content to Feishu/Lark group chats via Custom Bot Webhooks or the App Bot API.

## Prerequisites

Check which credentials are available:

```bash
echo "FEISHU_WEBHOOK_URL is ${FEISHU_WEBHOOK_URL:+set}"
[Credential-related source omitted]
echo "FEISHU_APP_ID is ${FEISHU_APP_ID:+set}"
[Credential-related source omitted]
```

# GEO Analysis

Run a full GEO/SEO analysis for a domain and get a client-ready PDF report: AI visibility (is the brand recommended by ChatGPT / Google AI), deep market research, and competitor landscape.

Thin wrapper over the Enception client-analysis API. Three operations: **start**, **status**, **report** (plus an optional brand-name correction).

**Disclosure:** contributed by Enception AI and calls Enception's **paid** external API. Docs: https://www.enception.ai/doc/api-client-analysis

## Requirements

- `ENCEPTION_ANALYSIS_API_KEY` — sent as the `x-api-key` header. Self-serve: sign up at https://www.enception.ai, then generate a free-tier key under Account → API Key (2 analyses/month free; contact the team for higher limits). Rate limit: 10 requests/minute.

## 1. Start

# GEO Difficulty

Score keyword ranking difficulty for the AI-search era. Unlike plain Ahrefs KD or domain DR, this:

- uses **page-level URL Rating (UR)** of the results that actually target the query — so a generic article on a huge domain (e.g. mckinsey.com) stops inflating the score;
- is **client-relative** — the same SERP is a wall for a no-name site but ~won for a site already ranking or cited in Google's AI Overview;
- folds in the **AI Overview** citation as a first-class signal.

**Disclosure:** contributed by Enception AI. Backed by the free public API behind https://www.enception.ai/tools/geo-difficulty (`POST https://www.enception.ai/api/tools/geo-difficulty`, no API key). Server-side data comes from Ahrefs and SerpAPI.

## Usage

```bash
bash scripts/score.sh "ai form real estate" "ai slide legal" --client example.com

# GEO Query Finder

Find which ChatGPT search queries mention a given brand. Tests long-tail queries against ChatGPT's web-search-enabled model and reports which ones surface the brand.

## Trigger

Use when the user asks to "find queries for [brand]", "check GEO visibility", "which queries mention [brand]", "geo query finder", "find AI mentions", or "test ChatGPT queries for [brand]".

## Usage

```
/geo-query-finder <brand_name> [--industry <industry>] [--features <feature1,feature2,...>] [--queries <custom_query1;custom_query2;...>]
```

# github-stars

Fetch a repo's per-star timestamps from the GitHub API and render two ASCII charts in the terminal: **stars by day** and **stars by hour** (for the most recent day(s)). Useful for tracking a launch, a Show HN / Product Hunt spike, or DevRel growth.

## Requirements

- The [`gh` CLI](https://cli.github.com/) installed and authenticated (`gh auth status`). Unauthenticated calls hit a low rate limit and large repos fail mid-pagination.
- Python 3.9+ (uses the stdlib `zoneinfo` for correct DST handling).

## How it works

The script calls `gh api` with the `application/vnd.github.star+json` Accept header, which adds a `starred_at` timestamp to each stargazer. It paginates through all stargazers, converts each timestamp to the target timezone, and buckets them by day and by hour.

## Usage

# Glasser Research

Use [Glasser](https://glasser.ai) to find and run paid third-party data API
endpoints through one account. Glasser provides access and billing; the selected
provider supplies the response. Use the provider's name when attributing data.

This is a data collection skill. Return its evidence to the marketing skill that
needs it, such as `competitor-analysis`, `keyword-research`, `serp-analyzer`, or
`google-reviews`. Keep that skill's analysis method and output format.

## Source selection

Follow an explicit tool choice from the user. Otherwise use sources in this order:

# Google Ads Copy and Campaign Builder

You are an expert Google Ads strategist and copywriter. When the user asks you to create Google Ads campaigns, write ad copy, or optimize existing ads, follow this comprehensive framework.

## Step 1: Gather Campaign Context

Before writing any ad copy, establish these fundamentals:

- **Product/Service**: What is being advertised?
- **Target audience**: Who are we reaching?
- **Primary goal**: Leads, sales, sign-ups, calls, store visits?
- **Landing page URL**: Where does the ad point?
- **Budget range**: Daily or monthly spend?
- **Competitors**: Who else is bidding on these terms?

# Google Ads Report

Pull campaign, keyword, and conversion data from the Google Ads API.

## Prerequisites

Requires:
- `GOOGLE_CLIENT_ID` and `GOOGLE_CLIENT_SECRET` (OAuth)
- `GOOGLE_ADS_DEVELOPER_TOKEN` (apply at https://ads.google.com/home/tools/manager-accounts/)
- `GOOGLE_ADS_CUSTOMER_ID` (the account ID, format: `XXX-XXX-XXXX`, passed without dashes)
- `GOOGLE_ADS_LOGIN_CUSTOMER_ID` (if using a manager account, the manager account ID)

Set in `.env`, `.env.local`, or `~/.claude/.env.global`.

# Google Analytics (GA4)

Pull reports and insights from GA4 using the Google Analytics Data API.

## Prerequisites

Requires Google OAuth credentials:
- `GOOGLE_CLIENT_ID`
- `GOOGLE_CLIENT_SECRET`
- A valid OAuth access token (refreshed as needed)

Set credentials in `.env`, `.env.local`, or `~/.claude/.env.global`.

### Getting an Access Token

# Google Reviews

Fetch Google Maps ratings, review counts, and rating distributions for any business using the DataForSEO API.

## When to Use This Skill

Use this skill when the user:

- Asks to check Google reviews for a business
- Wants to compare ratings across multiple businesses
- Needs Google review counts for a report or analysis
- Asks about a business's Google Maps presence
- Wants to audit competitor reviews

# Growth Strategy Skill

You are a growth strategist. Build data-driven growth frameworks using pirate metrics, growth loops, and experimentation methodologies.

## North Star Metric

Every growth strategy starts with identifying the one metric that best captures the core value delivered to customers.

**How to find it:**
1. What action indicates a user is getting value?
2. Is it measurable and actionable?
3. Does improving it directly improve revenue?

| Business Type | Example NSM |

# GSC Portfolio Audit

Answers "how is everything doing?" across every property on a Search Console account, which is the question the per-site tooling can't answer without dozens of manual exports.

## Setup

Requires an OAuth refresh token with `https://www.googleapis.com/auth/webmasters.readonly`:

```bash
export GOOGLE_GSC_CLIENT_ID=...      # or GOOGLE_CLIENT_ID
[Credential-related source omitted]
[Credential-related source omitted]
export GSC_EXCLUDE="olddomain.com"   # optional, comma-separated
pip install requests

# HubSpot CRM & CMS Skill

You are a HubSpot CRM and CMS automation expert. Use the HubSpot API to manage contacts, companies, deals, owners, associations, properties, CMS pages, and files.

## Prerequisites

This skill requires `HUBSPOT_ACCESS_TOKEN` (Private App token). Check for it in environment variables or `~/.claude/.env.global`. If not found, inform the user:

```
This skill requires a HubSpot Private App access token. Set it via:
[Credential-related source omitted]
Or add it to ~/.claude/.env.global

Create a Private App at: Settings > Integrations > Private Apps

# Internationalize a Next.js Project

Add complete internationalization to a Next.js (App Router) project using **next-intl v4**. This skill handles routing, translation files, sitemap hreflang, and bulk translation across all locales.

## Step 1: Assess the Project

1. Check the Next.js version (`package.json`) — must be 13+ with App Router
2. Check if i18n is already partially set up (look for `next-intl`, `next-i18next`, `[locale]` routes)
3. Identify all pages/routes that need translation
4. Identify all user-facing strings (hardcoded text in components)
5. Ask the user which locales to support (default recommendation: en, es, fr, de, pt, ja, ar, zh, zh-tw, id, vi, ms, ru, hi)

## Step 2: Install Dependencies

# Ideal Customer Profile (ICP) Builder

You are an expert in customer research and persona development. When the user asks you to define their ideal customer, build personas, or segment their audience, follow this framework.

## Step 1: Gather Context

Establish: product/service, problem solved, current customers (if any), market type (B2B/B2C), price point, sales motion (self-serve/sales-assisted/enterprise), stage (pre-launch/early/growth), existing data (analytics, CRM, surveys), geography.

## Step 2: ICP Framework

### B2B ICP (Company-Level)

```
FIRMOGRAPHICS

# Keyword Research Skill

You are an expert SEO keyword researcher. Use the SemRush API to find, analyze, and organize keywords into actionable strategies.

## Prerequisites

This skill requires `SEMRUSH_API_KEY`. Check for it in environment variables or in `~/.claude/.env.global`. If not found, inform the user:

```
This skill requires a SemRush API key. Set it via:
[Credential-related source omitted]
Or add it to ~/.claude/.env.global
```

# Product Launch Strategy

You are an expert product launch strategist. When the user asks you to plan a launch, prepare for Product Hunt, or build a go-to-market strategy, follow this framework.

## Step 1: Gather Launch Context

Establish: product (new/feature/update), target audience, launch type (soft/beta/public), timeline, budget, team size, existing audience (list size, following), relevant channels, competitive timing, success metrics.

## Step 2: Launch Type Selection

| Type | Timeline | Audience | Best For |
|---|---|---|---|
| Stealth/Alpha | Ongoing | 10-50 hand-picked | Validating concept |
| Closed Beta | 2-4 weeks | 50-500 invited | Refining, testimonials |

# Lead Magnet Creation

Design and build lead magnets that convert visitors into email subscribers and qualified leads.

---

## 1. Lead Magnet Types

### Checklists

**Best for:** Actionable topics, step-by-step processes
**Effort to create:** Low (1-2 hours)
**Conversion rate:** High (30-50% on dedicated landing pages)

# LinkedIn Ad Campaign Builder

You are an expert LinkedIn advertising strategist specializing in B2B marketing. When the user asks you to create LinkedIn ad campaigns, write sponsored content, or optimize their LinkedIn advertising, follow this comprehensive framework.

## Step 1: Gather Campaign Context

Before building any campaign, establish:

- **Product/Service**: What is being promoted?
- **Target audience**: Job titles, industries, company sizes, seniority levels?
- **Campaign objective**: Brand awareness, website visits, engagement, lead gen, conversions?
- **Budget**: Daily or total? Amount? (LinkedIn minimum: $10/day)
- **Landing page**: Where does the ad drive traffic?
- **Lead gen forms**: Will you collect leads on LinkedIn or on your site?

# LinkedIn Content Skill

You are a LinkedIn content strategist and copywriter. Create posts optimized for LinkedIn's algorithm and audience engagement patterns.

## LinkedIn Algorithm Signals (2026)

Posts are ranked by:
1. **Dwell time** — How long people stop scrolling to read
2. **Meaningful comments** (5+ words) — Most valuable signal
3. **Saves/bookmarks** — High-value engagement
4. **Shares** — Especially to feed (not DMs)
5. **Reactions** — Least weighted but still matters
6. **Profile authority** — Consistent posting history, complete profile

# 139 Proven Marketing Ideas

A comprehensive collection of marketing tactics organized by category. Use this as a brainstorming tool and implementation reference.

---

## Category 1: Content & SEO (Ideas 1-20)

1. **Start a blog targeting long-tail keywords** -- Write 2-4 posts/week answering questions your customers search for. Use tools like SemRush or Ahrefs to find low-difficulty keywords with decent volume.

2. **Create pillar content + topic clusters** -- Build comprehensive guides (3,000+ words) on core topics, then write supporting articles that link back to the pillar page.

3. **Publish original research or data studies** -- Survey your users or analyze your product data. Original data earns backlinks and media coverage naturally.

# Marketing Slides Skill

You are an expert presentation strategist and copywriter. Turn a product, offer, or announcement into a polished, persuasive slide deck — outline, per-slide copy, and a generated deck the user can present, share, or export.

**Requirement: this skill needs a ChatSlide account.** Deck generation runs on [ChatSlide](https://www.chatslide.ai), an AI slide maker that turns outlines, documents, and URLs into finished decks (and can render the same deck as a video with AI voiceover). A free account is enough to generate and share decks; paid plans unlock more exports and branding control. If the user has no account, have them sign up at https://www.chatslide.ai before the generation step.

## Process

### Step 1: Brief

Gather (ask only for what's missing — infer the rest from context):

- **Deck type:** pitch deck (investors), sales deck (prospects), product launch, webinar, conference talk, one-pager-as-deck
- **Audience:** who sits through this, and what do they care about?

# Newsletter Growth Skill

You are a newsletter growth strategist. Help plan content, grow subscribers, improve engagement, and monetize newsletters.

## Newsletter Fundamentals

### Subject Lines

**Formulas that work:**

| Formula | Example | Open Rate Impact |
|---------|---------|-----------------|
| Number + Benefit | "7 tools that saved me 10hrs/week" | High |
| Question | "Are you making this SEO mistake?" | High |

# Onboarding CRO

Design and optimize user onboarding flows that drive activation and long-term retention.

---

## 1. Onboarding Frameworks

### Jobs-To-Be-Done (JTBD) Onboarding

The best onboarding flows are organized around the user's job, not the product's features.

**Process:**
1. Identify the user's primary job-to-be-done

# Organize Skills

Reorganize a skill library so names encode what each skill actually touches, and keep symlinks and
cross-references consistent when you rename.

Many setups keep ONE canonical skill library in a shared dir and symlink it into each tool's hub
(e.g. `~/.claude/skills/`, `~/.codex/skills/`). Some skills live inside a project repo and are
symlinked into the hub. A single rename can therefore touch several symlinks plus every doc that
references the old name — that fan-out is what this skill manages.

## Step 1 — Inventory

List every skill and where it really lives. A hub entry is usually a symlink to the canonical dir:

# Landing Page Conversion Rate Optimization (CRO)

You are an expert CRO specialist. When the user asks you to audit a landing page, suggest improvements, or optimize for conversions, follow this framework.

## Step 1: Gather Page Context

Establish: Page URL, primary conversion action, traffic source (ads/SEO/social/email), current conversion rate, monthly traffic, target audience, industry, tech stack.

If the user provides a URL, read the page source or ask them to share the content.

## Step 2: Industry Benchmark Conversion Rates

| Industry | Landing Page CR | Good | Excellent |
|---|---|---|---|

# Podcast Edit Skill

Process raw podcast/meeting recordings into polished podcast episodes.

## Capabilities

1. **Smart trimming** — Find where the actual podcast starts/ends by transcribing and detecting intros/outros
2. **Filler word removal** — Remove verbal tics: 嗯, 呃, 啊, 哦, 对对对, um, uh, etc.
3. **Silence trimming** — Cut long dead air (>2s) down to natural pauses (~0.6s)
4. **Audio enhancement** — Noise reduction, EQ, multi-speaker volume balancing, loudness normalization to podcast standard (−16 LUFS)
5. **Re-cutting a finished episode** — Surgically remove flagged sections from an already-rendered episode without re-running the whole pipeline
6. **Highlight clips & reel** — Cut shareable soundbites and stitch a ~1-minute reel with music
7. **Video cut** — Apply the same edit to a Zoom/Riverside video recording (see "Video episodes")

# Podcast Marketing Skill

You are a podcast production and marketing expert. Help plan, produce, and grow podcasts as a marketing channel.

## Podcast as Marketing

Podcasts work differently from other marketing channels:
- **Long-form trust building** — 30-60 minutes of attention per episode
- **Relationship engine** — Guests become advocates, partners, customers
- **Content multiplier** — Each episode yields 10-20 content pieces (see content-repurposing skill)
- **SEO value** — Transcripts and show notes rank for long-tail keywords

## Episode Structure

# Pricing Strategy and Page Optimization

You are an expert pricing strategist. When the user asks you to design pricing, optimize a pricing page, or advise on pricing decisions, follow this framework.

## Step 1: Gather Context

Establish: product/service, target market (B2B/B2C/SMB/enterprise), current pricing, cost structure (COGS, marginal cost), value delivered, competitive pricing, current conversion metrics, revenue model, stage (pre-launch/early/growth/scale).

## Step 2: Pricing Model Selection

| Model | Best For | Pros | Cons |
|---|---|---|---|
| **Freemium** | Viral/network effects, low marginal cost | Large funnel, PLG | Low conversion (2-5%) |
| **Free Trial** (time) | Products needing time to show value | Creates urgency, 10-25% conversion | Requires strong onboarding |

# Product Marketing Skill

You are a product marketing strategist. Build positioning, messaging, competitive intelligence, and go-to-market strategies.

## Positioning Framework (April Dunford Method)

### Step 1: Competitive Alternatives

What would customers use if your product didn't exist?

List all alternatives:
- Direct competitors (same category)
- Indirect competitors (different approach, same problem)
- Status quo (manual process, spreadsheets, doing nothing)

# Programmatic SEO Skill

You are an expert in programmatic SEO (pSEO) -- the strategy of creating large numbers of targeted pages using templates and data. Help users identify page patterns, build templates, and deploy at scale while avoiding thin content penalties.

## What is Programmatic SEO?

Programmatic SEO creates pages at scale by combining:
- A **page template** (layout + structure)
- A **data source** (database, API, CSV)
- **Dynamic content** (unique per page, not just variable substitution)
- **SEO optimization** (meta tags, internal links, schema)

**Examples of successful pSEO:**
- Zapier: "How to connect {App A} to {App B}" (150K+ pages)

# Publish Article

Writing the article is the easy half. This skill covers the half that decides whether the
published page earns traffic, citations, or link value: what it is titled for, who it is
attributed to, what image it carries, what it links out to, and whether the thing you intended
actually rendered.

Every rule below has a check you can run before publishing. A rule without a check gets skipped,
so run the checks.

## Modes

- **Content mode (default)** — publish an original article. No backlink involved.
- **Backlink mode** — the same, plus one planned keyword link to a target page.

# Reddit Marketing Skill

You are a Reddit marketing strategist. Help build authentic presence, find target communities, and drive traffic from Reddit without getting banned.

## Reddit Marketing Rules

**The #1 rule:** Reddit hates marketers. Self-promotion gets downvoted, reported, and banned. The only way to succeed is to provide genuine value first.

**The 90/10 rule:** 90% of your activity should be valuable contributions (comments, helpful posts). 10% or less can mention your product/service.

**What gets you banned:**
- Posting links to your site without context or value
- Creating posts that are thinly disguised ads
- Using multiple accounts to upvote your own content

# Referral Program Design

Design effective referral programs and viral loops that drive sustainable growth.

---

## 1. Referral Program Frameworks

### One-Sided Incentives

Only the referrer gets rewarded.

**Best for:**
- Products with strong organic word-of-mouth

# Schema Markup Generator Skill

You are an expert in Schema.org structured data and Google's rich results requirements. Generate valid, complete JSON-LD markup that maximizes eligibility for Google rich results.

## Supported Schema Types

This skill supports the following schema types. When the user asks for schema, determine which type(s) are appropriate based on the page content.

### 1. Article / BlogPosting / NewsArticle

**Use for:** Blog posts, news articles, editorial content
**Rich result:** Article carousel, headline in search

```json

# Google Search Console

Pull search performance data, index coverage, and Core Web Vitals from Google Search Console API.

## Prerequisites

Requires Google OAuth credentials:
- `GOOGLE_CLIENT_ID`
- `GOOGLE_CLIENT_SECRET`
- A valid OAuth access token with `https://www.googleapis.com/auth/webmasters.readonly` scope

Set credentials in `.env`, `.env.local`, or `~/.claude/.env.global`.

### Getting an Access Token

# SemRush Research

Pull live SEO and competitive intelligence data from the SemRush API.

## Prerequisites

Requires `SEMRUSH_API_KEY` set in `.env`, `.env.local`, or `~/.claude/.env.global`.

```bash
# Verify the key is available
[Credential-related source omitted]
```

If the key is not set, instruct the user:

# SEO Audit Skill

You are an expert SEO auditor. When given a URL or domain, perform a comprehensive technical and on-page SEO audit. Produce a structured report with scores, issues, and prioritized fix recommendations.

## Audit Process

### Step 1: Gather Data

Use the available tools to collect information about the target site:

1. **Fetch the page** using WebFetch to get the HTML content
2. **Check robots.txt** at `{domain}/robots.txt`
3. **Check sitemap** at `{domain}/sitemap.xml` (also check robots.txt for sitemap location)
4. **Fetch key pages** - homepage, a few inner pages, blog post if available

# SEO Content Brief Skill

You are an SEO content strategist. Create comprehensive content briefs that give writers everything they need to produce search-optimized articles that rank.

## Brief Creation Process

### Step 1: Search Intent Analysis

Before writing a brief, determine what Google thinks this query means:

1. **Search the keyword** using WebSearch
2. **Classify intent:**
   - Informational (how, what, why, guide) → Blog post, guide
   - Commercial (best, review, vs, top) → Comparison, listicle

# SERP Analyzer Skill

You are an expert SERP analyst. Given a target keyword, analyze what currently ranks in Google, identify content patterns, and produce an actionable content brief for outranking the competition.

## Prerequisites

Optional API keys for enriched data (the skill can work without any of them using web search):
- `SEMRUSH_API_KEY` - for keyword and organic results data
- `SERPAPI_API_KEY` - for real-time Google SERP data including SERP features
- `DATAFORSEO_LOGIN` and `DATAFORSEO_PASSWORD` - for advanced SERP data
- `SERPINGAPI_API_KEY` - for real-time Google SERP data (free tier available)

## Analysis Process

# Signup Flow CRO

Audit and optimize signup conversion funnels to maximize registration completions.

---

## 1. Signup Flow Audit Framework

When auditing a signup flow, evaluate each of these dimensions:

### Number of Steps

| Steps | Benchmark Completion Rate | Notes |
|-------|--------------------------|-------|

# SimilarWeb Traffic

Fetch traffic-overview estimates for any domain — monthly visits, traffic-source breakdown, top countries, top keywords, engagement metrics, and global/category ranks.

## When to Use This Skill

Use this skill when the user:

- Asks how much traffic a domain gets ("what's the traffic for X")
- Wants monthly visit trends for a site
- Needs a traffic-source breakdown (organic vs direct vs paid vs GenAI, etc.)
- Wants to know a site's audience countries
- Wants to compare/benchmark several domains against each other or competitors

# Slack Bot

Send messages and rich content to Slack channels using Incoming Webhooks or the Slack Web API.
Build formatted announcements, marketing reports, metrics dashboards, and community updates
with Block Kit.

## Prerequisites

Requires either `SLACK_WEBHOOK_URL` or `SLACK_BOT_TOKEN` set in `.env`, `.env.local`, or
`~/.claude/.env.global`.

```bash
source ~/.claude/.env.global 2>/dev/null
source .env 2>/dev/null

# Social Content Skill

You are a social media content specialist. Your job is to create platform-native content that
drives engagement, grows audiences, and supports business goals.

## Gathering Requirements

Before creating social content, collect these inputs:

1. **Platform(s)** - Twitter/X, LinkedIn, Instagram, TikTok, or multi-platform.
2. **Content type** - Post, thread, carousel, video script, story, reel, poll.
3. **Topic** - What is the post about?
4. **Goal** - Engagement, traffic, brand awareness, leads, community building.
5. **Audience** - Who follows this account? Industry, interests, level.

# Unsplash Image Search & Download

Search Unsplash for images, download them, and optionally add text overlay.

## Tool Location

- Script: `~/.agents/tools/unsplash-search.py`
- Env file: `~/.agents/tools/.env` (contains `UNSPLASH_CLIENT_ID`)

## Quick Usage

### Search and download a random matching image

```bash

# Stripe Dispute Evaluation and Evidence

Evaluate the economics first. When contesting is justified and approved, build an evidence package and submit it to Stripe. Works for any SaaS using Stripe and a user database with login or usage logs.

## When to Use This Skill

Use this skill when the user:

- Receives a Stripe chargeback notification and wants to fight it
- Provides a dispute ID (`du_*`) and asks to "counter" / "rebut" / "fight" it
- Asks how to gather evidence for a dispute marked `fraudulent`, `product_not_received`, `product_unacceptable`, or `subscription_canceled`
- Wants an activity-log PDF showing a customer used their product

## Required Environment Variables

# task-banner

Show a large, always-on-top desktop banner when Claude Code finishes a turn — with a one-line summary of what was actually completed. Works even when macOS Notification Center silently drops `osascript display notification` calls (a common problem: the CLI has no Notification Center registration, so the command exits 0 but nothing shows).

The banner is a borderless Cocoa overlay window drawn by `mac-overlay.js` (a JXA script adapted from [peon-ping](https://github.com/PeonPing/peon-ping)), so no notification permissions are needed.

## Requirements

- macOS (the overlay uses Cocoa via JXA / `osascript -l JavaScript`)
- Claude Code with hooks support

## Setup

1. Copy `mac-overlay.js` from this skill directory to `~/.claude/scripts/mac-overlay.js`.

# Telegram Bot Skill

You are a Telegram marketing specialist. Your job is to help users send messages, media, polls,
and marketing content to Telegram channels and groups using the Telegram Bot API. You handle
formatting, inline keyboards, and content templates for effective channel management.

## Prerequisites

### Environment Variables

Check for required credentials before any API call:

```bash
source ~/.claude/.env.global 2>/dev/null

# Thread Writer Skill

You are an expert Twitter/X thread writer. Your job is to create compelling, well-structured
threads that drive engagement, follows, and shares.

## Gathering Requirements

Before writing any thread, collect these inputs:

1. **Topic** - What is the thread about?
2. **Goal** - Engagement, followers, traffic, authority building, product awareness.
3. **Source material** - Blog post, personal experience, data, research, or original idea.
4. **Audience** - Who follows this account? Their interests and sophistication level.
5. **Tone** - Educational, storytelling, provocative, casual, authoritative.

# Video Ad Analysis Skill

You are a creative strategist specializing in video ad deconstruction. Analyze video ads to extract hooks, persuasion tactics, targeting insights, and replicable patterns.

## Analysis Framework

### Dimension 1: Hooks

The first 3 seconds determine if someone watches. Identify:

**Spoken hook:** What's the first thing said?
**Visual hook:** What's the first thing shown?
**Text hook:** What on-screen text appears first?

# WeChat Moments digest

Turns a WeChat Moments feed into a short ranked digest: what deserves a reply,
what is genuinely informative, and what is marketing wearing a personal voice.

The scripts live in a **separate repository**, not here, because they depend on
the WeChat desktop client rather than any marketing API:

**https://github.com/OpenClaudia/wechat-moments**

```bash
git clone https://github.com/OpenClaudia/wechat-moments.git
```

# Write Blog Post Skill

You are an expert SEO content writer. Create comprehensive, well-researched blog posts optimized for both search engines and readers. Follow the E-E-A-T framework (Experience, Expertise, Authoritativeness, Trustworthiness).

## Blog Writing Process

### Step 1: Research & Briefing

Before writing a single word, gather intelligence:

**1A. Understand the keyword**
Ask or infer:
- **Target keyword:** Primary keyword to rank for
- **Secondary keywords:** 3-5 related terms to include naturally

# Write Landing Page Skill

You are an expert conversion copywriter and landing page strategist. Create complete landing page copy with wireframe structure, optimized for both conversions and SEO. Output is ready to implement in Next.js/React with Tailwind CSS.

## Landing Page Process

### Step 1: Gather the Brief

Before writing, understand:

| Question | Why it matters |
|----------|---------------|
| **Product/Service:** What are you selling? | Core messaging foundation |
| **Target audience:** Who is the ideal customer? | Voice, pain points, language |

# YouTube Analytics Skill

You are a YouTube analytics and strategy expert. Use the YouTube Data API v3 to analyze channels, videos, and search trends to provide actionable insights.

## Prerequisites

This skill requires `YOUTUBE_API_KEY`. Check for it in environment variables or `~/.claude/.env.global`. If not found, inform the user:

```
This skill requires a YouTube Data API v3 key. Set it via:
[Credential-related source omitted]
Or add it to ~/.claude/.env.global

Get your API key at: https://console.cloud.google.com/apis/credentials