marketing-skills

Marketing Skills

A production-ready toolkit for AI agents working on marketing tasks. Ships 51+ Agent Skills (markdown workflows) and a TypeScript CLI platform with optional Redis-backed response caching.

Built for engineers and technical marketers who want reproducible, testable tooling around conversion optimization, copywriting, SEO, analytics, and growth workflows.

---

Feature Highlights

Capability	Description
Agent Skills	Spec-compliant SKILL.md files for Claude Code, Cursor, Codex, and other Agent Skills hosts
Unified CLI	Single marketing-skills entry point for 64 marketing tool integrations
Redis cache	Optional persistence layer for CLI responses with graceful shutdown
Strict TypeScript	Typed core libraries, ESLint, Vitest, and CI validation
Cross-platform validation	Node-based skill validator (replaces bash-only audit)
Plugin marketplace	Claude Code plugin manifest in .claude-plugin/

---

Architecture

flowchart TB
  subgraph Content["Content Layer"]
    SK[skills/*/SKILL.md]
    INT[tools/integrations/*.md]
  end

  subgraph Runtime["TypeScript Runtime"]
    CLI[marketing-skills CLI]
    SYNC[ms-sync]
    VAL[ms-validate]
    REG[CLI Registry]
  end

  subgraph Core["Core Libraries"]
    CFG[config]
    LOG[logger]
    HTTP[http-client]
    ARGS[parse-args]
  end

  subgraph Persistence["Persistence"]
    REDIS[(Redis)]
    CACHE[cache layer]
  end

  SK --> VAL
  SK --> SYNC
  CLI --> REG
  REG --> Core
  CLI --> CACHE
  CACHE --> REDIS
  SYNC --> SK

Skill dependency model

flowchart LR
  PM[product-marketing] --> SEO[SEO & Content]
  PM --> CRO[CRO]
  PM --> COPY[Copy]
  PM --> PAID[Paid & Analytics]
  PM --> GROWTH[Growth & Retention]
  PM --> GTM[Sales & GTM]
  PM --> STRAT[Strategy]

Every skill reads product-marketing context first for positioning, audience, and messaging consistency.

---

Project Structure

marketingskills/
├── src/                    # TypeScript application code
│   ├── cli.ts              # Unified CLI entry
│   ├── config/             # Environment configuration (Zod)
│   ├── lib/
│   │   ├── cli/            # Argument parsing, HTTP helpers
│   │   ├── logger/         # Structured logging
│   │   └── redis/          # Connection manager + cache
│   ├── skills/             # Sync + validate modules
│   └── clis/               # Per-tool CLI handlers (64 tools)
├── skills/                 # Agent Skills content (unchanged spec)
├── tools/
│   ├── clis/               # CLI documentation
│   └── integrations/       # API integration guides
├── tests/                  # Vitest unit tests
├── docs/                   # Engineering documentation
├── dist/                   # Build output (gitignored)
└── .claude-plugin/         # Claude Code marketplace manifest

Design decisions

• Content vs runtime separation — Skills remain portable markdown; runtime code lives under src/.
• Thin CLI modules — Each tool exports a run(args) handler; shared logic lives in src/lib/.
• Optional Redis — Disabled via REDIS_ENABLED=false for local development without infrastructure.

---

Installation

Prerequisites

• Node.js 18+
• npm 9+
• Redis 6+ (optional, for caching)

Setup

git clone https://github.com/coreyhaines31/marketingskills.git
cd marketingskills
npm install
cp .env.example .env
npm run build

Install skills into your project

npx skills add coreyhaines31/marketingskills

Or install individual skills from the skills/ directory into .agents/skills/.

---

Configuration

Copy .env.example to .env and adjust:

Variable	Default	Description
LOG_LEVEL	info	Logging verbosity
REDIS_ENABLED	true	Set false to disable Redis
REDIS_URL	redis://127.0.0.1:6379	Redis connection URL
REDIS_KEY_PREFIX	ms:	Key namespace prefix
REDIS_CACHE_TTL_SECONDS	300	CLI response cache TTL
SKILLS_DIR	skills	Skills directory path

Tool-specific API keys (e.g. GA4_ACCESS_TOKEN, APOLLO_API_KEY) are read at runtime by each CLI module.

---

Development

# Watch mode
npm run dev

# Type check
npm run typecheck

# Lint
npm run lint

# Test
npm run test

# Full pipeline
npm run validate

CLI usage

npx marketing-skills list
npx marketing-skills ga4 reports run --property 123456789 --dry-run
npx marketing-skills apollo people search --titles "CEO,CTO"

Skill maintenance

npm run sync-skills      # Update README table + marketplace.json
npm run validate-skills  # Audit all SKILL.md files

---

Testing

npm test              # Run all unit tests
npm run test:watch    # Watch mode