AGENTS.md git:20260818.d6f6643A

Immutable. This exact content is served forever at /api/v1/blob/e1c8ae8b4d95c209.

# AI Marketing Skills for AI Agents

This repository contains portable AI marketing skills in `skills/`. Each package follows the Agent Skills format with a `SKILL.md` file containing YAML frontmatter and procedural instructions for a focused marketing job.

## Available Skills

### Ads
- `skills/ads/ad-angles/SKILL.md` — Brainstorm ad concepts using 5 messaging angles, formats, and visual styles
- `skills/ads/ad-campaign-analyzer/SKILL.md` — Red/Yellow/Green campaign grading with creative fatigue detection and scaling recommendations
- `skills/ads/ad-creative/SKILL.md` — Render ad concepts as HTML with 5 template styles, optionally screenshot via Playwright MCP

### Content
- `skills/content/content-strategy/SKILL.md` — Plan content pillars, topic clusters, editorial calendar, and keyword mapping by buyer stage
- `skills/content/social-post-writer/SKILL.md` — Generate social posts from a topic using 9 proven templates with platform adaptation
- `skills/content/content-repurposer/SKILL.md` — Turn long-form content into a week of short-form social posts via Hub & Spoke method

### Conversion
- `skills/conversion/conversion-audit/SKILL.md` — 53-point conversion audit covering customer focus, narrative arc, copy, design, CTAs, and proof

### Reddit
- `skills/reddit/reply-writer/SKILL.md` — Draft native Reddit replies in 3 rotating formats with subreddit tone calibration

### Research
- `skills/research/channel-discovery/SKILL.md` — Map marketing channels for a target audience, score on 5 criteria, recommend top 3
- `skills/research/community-discovery/SKILL.md` — Discover 100+ online communities across Reddit, Slack, Discord, Facebook, LinkedIn, and forums
- `skills/research/competitor-content-analysis/SKILL.md` — Analyze a competitor's content engine — inventory, SEO plays, comparison pages, gaps
- `skills/research/competitor-discovery/SKILL.md` — Search the web for competitors, produce a ranked list of direct/adjacent/tangential competitors
- `skills/research/competitor-keyword-analysis/SKILL.md` — Map a competitor's organic search presence via Keywords Everywhere MCP
- `skills/research/competitor-landscape/SKILL.md` — Cross-competitor comparison — feature matrix, positioning map, SWOT, strategic recommendations
- `skills/research/competitor-site-analysis/SKILL.md` — Extract structured data from a competitor's website across 5 dimensions
- `skills/research/influencer-discovery/SKILL.md` — Discover 100+ influencers across YouTube, X/Twitter, blogs, newsletters, and podcasts
- `skills/research/keyword-research/SKILL.md` — Expand a seed keyword into clustered keyword universe via Keywords Everywhere MCP

### Search
- `skills/search/search-page-audit/SKILL.md` — 38-point SEO + AI optimization audit for any URL

## How to Use

**Claude Code plugin users:** Skills are auto-discovered — just ask Claude to run any skill by name.

**Other tools:** When a user asks to run an audit (or any skill), read the corresponding `SKILL.md` file and follow its instructions exactly. Pass the user's input (e.g. a URL) as the argument.

## Conventions

- Skills live in `skills/<category>/<skill-name>/SKILL.md`.
- The frontmatter `name` must match the kebab-case directory name.
- Descriptions should identify both the capability and when to use it.
- Each skill defines its own process, output format, evidence handling, and quality rules.
- Never include client data, confidential material, credentials, or proprietary orchestration.
- Do not make untested compatibility, performance, or outcome claims.
- Keep `.claude-plugin/marketplace.json`, `README.md`, and `CHANGELOG.md` synchronized with user-visible changes.
- Install `requirements-dev.txt` and run `scripts/validate.sh` before submitting changes; it uses the official `skills-ref` validator plus repository-specific checks.

## Integrations

Some skills use MCP servers. See `integrations/` for setup guides.
- **Keywords Everywhere** — keyword data, traffic metrics, backlinks
- **Playwright** — browser automation, screenshots