coreyhaines31/marketingskills Documentation: Complete Guide to the AI Marketing Knowledge Base

The coreyhaines31/marketingskills repository provides comprehensive markdown documentation organized into root-level project guides, per-skill instruction sets in skills/<skill-name>/SKILL.md files, and a tool registry with integration guides for 50+ marketing platforms.

The coreyhaines31/marketingskills repository serves as a self-contained knowledge base designed for AI agents executing marketing tasks. Its documentation architecture follows the Agent Skills specification, ensuring consistent front-matter validation and seamless consumption by automated systems. All files adhere to strict formatting rules outlined in AGENTS.md to maintain compatibility with agent parsing logic.

Core Project Documentation Files

The repository root contains four essential markdown files that govern project usage and contribution workflows.

README.md Project Overview

README.md provides the high-level project description, complete skill catalog, installation methods, and usage examples. It serves as the primary entry point for users discovering the repository and contains quick-start instructions for both manual and automated installation methods.

AGENTS.md Agent Guidelines

AGENTS.md defines the rules for how AI agents should consume the repository. This document specifies front-matter validation requirements, naming conventions, and Claude-Code extensions integration. Agents use this file to understand the .claude-plugin/marketplace.json manifest structure and proper YAML front-matter parsing rules.

CONTRIBUTING.md Workflow

CONTRIBUTING.md contains step-by-step instructions for adding new skills, updating existing documentation, and submitting pull requests. It includes the required directory structure and validation checklist that contributors must follow when extending the knowledge base.

VERSIONS.md Machine-Readable Catalog

VERSIONS.md serves as a machine-readable table tracking skill versions and last-updated dates. AI agents compare local file hashes against this catalog to surface update notifications and ensure they are working with current instruction sets.

Skill-Specific Knowledge Base

The skills/ directory contains modular documentation organized by marketing capability, following a strict hierarchical structure.

SKILL.md Structure

Each skill resides in its own folder (skills/<skill-name>/) containing a mandatory SKILL.md file. For example, skills/copywriting/SKILL.md houses the core instruction set for copywriting tasks. These files must include YAML front-matter with trigger phrases and description fields that agents parse to determine when to invoke specific capabilities.

Reference Assets and Subdirectories

Skills may include supplemental materials in nested subdirectories:

• references/ – Extended documentation, templates, or data files (e.g., skills/competitor-profiling/references/tool-reference.md)
• scripts/ – Automation scripts specific to the skill
• assets/ – Images, PDFs, or other media files referenced by the skill documentation

CLI Tools and Integration Guides

The tools/ directory provides executable utilities and platform-specific integration documentation.

Tool Registry

tools/REGISTRY.md indexes all zero-dependency Node.js CLI tools available in the repository. Each entry includes capability summaries and usage patterns. These tools can be validated and executed directly:

node --check tools/clis/<name>.js
node tools/clis/ga4.js --dry-run

Third-Party Integration Guides

The tools/integrations/ folder contains detailed API documentation for 50+ marketing platforms:

• tools/integrations/ga4.md – Google Analytics 4 API usage, authentication flows, and common patterns
• tools/integrations/composio.md – Documentation for the Composio bridge providing MCP access to OAuth-heavy tools

The Composio MCP layer abstracts complex OAuth implementations, allowing agents to invoke tool-specific integrations without hard-coding credentials in skill files.

Installing and Using coreyhaines31/marketingskills Documentation

The repository supports multiple installation methods depending on your environment.

npx Skill Installer

Install the complete knowledge base or selective skills using the npx installer:

# Install entire skill set

npx skills add coreyhaines31/marketingskills

# Install specific skills only

npx skills add coreyhaines31/marketingskills --skill copywriting page-cro

# List available skills for scripting

npx skills add coreyhaines31/marketingskills --list

Claude-Code Plugin Installation

For Claude-Code environments, use the built-in plugin system:

/plugin marketplace add coreyhaines31/marketingskills
/plugin install marketing-skills

Manual Skill Creation

To contribute new documentation manually:

mkdir -p skills/new-skill
cat > skills/new-skill/SKILL.md <<'EOF'
---
name: new-skill
description: When the user wants to … (include trigger phrases)
---

# New Skill

Instructions for the agent go here…
EOF

Summary

• The root documentation (README.md, AGENTS.md, CONTRIBUTING.md, VERSIONS.md) provides project governance and agent consumption rules according to the coreyhaines31/marketingskills documentation standards.
• Skill files follow the skills/<skill-name>/SKILL.md pattern with mandatory YAML front-matter containing trigger phrases and descriptions.
• CLI tools are zero-dependency Node.js scripts validated with node --check and indexed in tools/REGISTRY.md.
• Integration guides for 50+ platforms reside in tools/integrations/, with the Composio bridge handling OAuth abstraction.
• Version tracking via VERSIONS.md enables automatic update detection by comparing local file hashes against the central catalog.

Frequently Asked Questions

What is the purpose of the AGENTS.md file?

AGENTS.md establishes the Agent Skills specification that governs how AI systems consume the repository. It defines YAML front-matter validation rules, description length limits, naming conventions, and integration points for Claude-Code extensions. Agents reference this file to properly parse skill trigger phrases and handle the .claude-plugin/marketplace.json manifest structure.

How do I add a new marketing skill to the repository?

Create a new directory under skills/<skill-name>/ and add a SKILL.md file with valid YAML front-matter including the name and description fields. Optionally populate references/, scripts/, and assets/ subdirectories with supporting materials. Follow the detailed checklist in CONTRIBUTING.md and ensure your file passes front-matter validation as specified in AGENTS.md.

What format do skill documentation files follow?

All skill files must be valid markdown with YAML front-matter containing at minimum the name and description fields. The description should include trigger phrases that help agents identify when to invoke the skill. The content body contains the instructional text that guides agent behavior during task execution.

How does the version tracking system work?

VERSIONS.md maintains a machine-readable table of skill versions and last-updated timestamps. AI agents calculate local file hashes for each SKILL.md and compare them against the central registry to detect when updates are available. This allows automated systems to prompt users when the coreyhaines31/marketingskills documentation has changed significantly.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}