[opensourcedex]

aaron-marketing-skills is a free, open source marketing & customer engagement project written in Python and released under Apache-2.0. It has 2,796 GitHub stars, 361 forks and 0 open issues, and was last pushed 7 hours ago. On this registry it ranks #28 of 50 tracked projects in Marketing & Customer Engagement, with 5 head-to-head comparisons available. It gained 8 stars over the last 3 tracked days.

What is aaron-marketing-skills?

What it is

Aaron Marketing Skills is an open-source, Apache-2.0 plugin and skill collection for AI marketing staff. It packages 120 marketing skills across seven disciplines: narrative, SEO/GEO, social, email, paid ads, influencer, and launch. It lives in the agent-skills ecosystem and runs as a plugin, portable skills on many hosts, or an eight-bot AI Staff on Grok Bot and Hermes Bot Mode.

The project solves scattered marketing prompts and uneven AI output. It gives each discipline a fixed lifecycle, entrypoint, and auditor gate, so teams can run brand narrative, content quality, domain authority, email quality, ad account quality, creator fit, and launch readiness through one contract. Skills and commands are plain Markdown, while small Bash and Python standard-library runtimes provide hooks, validation, scoring, registry events, connectors, and CI without pip.

Key capabilities

  • It routes natural-language marketing goals through /aaron-marketing:auto and exposes typed topology in references/system-catalog.json.
  • It organizes the discipline skills into 16-skill layers, each with phase directories such as trace, architect, land, and evaluate for narrative.
  • It applies eight auditor gates: TALE, CORE-EEAT, CITE, ECHO, SEND, ROAS, STAR, and RAMP.
  • It includes auditors such as content-quality-auditor, domain-authority-auditor, email-quality-auditor, ad-account-auditor, creator-content-auditor, and fit-scorer.
  • It provides a protocol layer with seven truth registries for entity, creator, offer/claims, consent, launch, channel, and narrative data, plus HOT/WARM/COLD memory.

Who uses it and how

  • Marketing teams use it as a plugin in Claude Code or portable skills in Codex, Cursor, OpenCode, Antigravity, Gemini CLI, Copilot CLI, OpenClaw, Hermes, and other supported hosts.
  • Brand, content, and lifecycle teams run the narrative, SEO/GEO, social, email, paid ads, influencer, and launch layers to shape messaging, audit quality, activate campaigns, and report outcomes.
  • Teams that need governance use the truth registries and auditor gates to keep claims, consent, creators, offers, channels, and narrative data in one system.

Getting started

Typical installation uses /plugin marketplace add aaron-he-zhu/aaron-marketing-skills followed by /plugin install aaron-marketing@aaron in Claude Code, or npx skills add aaron-he-zhu/aaron-marketing-skills on supported hosts. For portable clients, users can download aaron-marketing-skills-20.1.0-agent-plugin-v1-lite.tar.gz from the v20.1.0 release, unpack it, and install the extracted plugin directory.

When to use it — and when not to

Use Aaron Marketing Skills when a team wants a structured, installable AI marketing staff with fixed disciplines, auditor gates, and plain-Markdown skills that run with user-provided data. It is not described as a hosted campaign platform, because the README presents it as a plugin, skill package, or bot team that the user installs and operates. A weakness is that the long-form documentation hub is described as a placeholder root, so deeper guidance may still depend on repository files and external signpost repos.

project readme (upstream, from github) — read inline

Aaron Marketing Skills

120 marketing skills, 7 disciplines, one contract — your AI marketing staff, installable as a plugin, portable skills, or an 8-bot team.

GitHub Stars

Version

License Last Commit

skills.sh ClawHub SkillHub ClaudeSkills

English | Deutsch | Español | Français | Italiano | 日本語 | 한국어 | Português | 简体中文 | 繁體中文

An AI marketing staff you install, not prompt — 120 agent skills as one plugin, as portable skills on 70+ hosts, or as an 8-bot AI Staff on Grok Bot and Hermes Bot Mode. Skills and commands are plain Markdown; small Bash/Python-stdlib runtimes provide hooks, validation, scoring, registry events, connectors, and CI (no pip). Every skill runs at Tier 1 with data you provide.

Layer Skills Lifecycle (phase directories) Framework → gate Entrypoint
Narrative 16 trace → architect → land → evaluate TALE truth / system / effectiveness profiles /aaron-marketing:narrative
SEO/GEO 16 survey → implement → tune → evaluate CORE-EEAT → content-quality-auditor · CITE → domain-authority-auditor /aaron-marketing:seo-geo
Social 16 explore → craft → host → observe ECHO asset / program-maturity profiles /aaron-marketing:social
Email 16 setup → engage → nurture → deliver SEND → email-quality-auditor (EQS) /aaron-marketing:email
Paid ads 16 research → orchestrate → activate → scale ROAS → ad-account-auditor (RQS) /aaron-marketing:ad
Influencer 16 scout → target → activate → report STAR → creator-content-auditor (SQS); fit-scorer produces the Suitability (S) read /aaron-marketing:influencer
Launch 16 research → assemble → mobilize → prove RAMP preflight / execution / outcome profiles /aaron-marketing:launch
Protocol layer 8 — (shared machinery, outside the phase flows) 7 truth registries (entity · creator · offer/claims · consent · launch · channel · narrative) + HOT/WARM/COLD memory —

/aaron-marketing:auto routes any natural-language goal. Typed topology: references/system-catalog.json. Readable map: system architecture. Long-form narrative/SEO: aaronmarketing.ai docs hub (placeholder hub root). In-repo vs hub: docs/README.md.

Signpost repos point here — seo-geo-claude-skills (tag v9.9.12) and influencer-marketing-agent-skills (tag standalone-final). Sibling policy: docs/repo-family.md.

Contents

Install

Host Install
Claude Code /plugin marketplace add aaron-he-zhu/aaron-marketing-skills then /plugin install aaron-marketing@aaron
Codex · Cursor · OpenCode · Antigravity · Gemini CLI · Copilot CLI · OpenClaw · Hermes · 70+ hosts npx skills add aaron-he-zhu/aaron-marketing-skills
Agent Plugins v1 clients · Portable Lite Download aaron-marketing-skills-20.1.0-agent-plugin-v1-lite.tar.gz from the v20.1.0 release, unpack it, and install the extracted plugin directory
Grok Bot · Hermes Bot Mode (AI Staff) Generate, then install: Hermes = profile install; Grok = semi-manual cards. See AI Staff
SkillHub.cn (中文社区) skillhub install
Any host git clone https://github.com/aaron-he-zhu/aaron-marketing-skills

Claude Code: marketplace add only registers the catalog — run /plugin install aaron-marketing@aaron to enable skills and commands. Single skill: npx skills add aaron-he-zhu/aaron-marketing-skills -s keyword-research. Per-agent quirks: docs/agent-compatibility.md (verified 120/120 installable, 2026-07).

The plugin adds nothing to /mcp — docs/mcp-catalog.json is a copy-paste reference only. The repo root is the authoring SSOT, not an Agent Plugins v1 install root. Use the Portable Lite release asset (boundary).

AI Staff — 8 named bots

On Grok Bot and Hermes Bot Mode this bundle installs as staff: seven specialists (aaron-narrative, aaron-seo-geo, aaron-social, aaron-email, aaron-ad, aaron-influencer, aaron-launch) plus aaron-chief (protocol + routing). Same 120 skills, covered exactly once. No Web UI, Usage Gateway, or cloud hosting in this OSS surface.

python3 scripts/generate-bot-projections.py --output /private/path/aaron-bot-roster
Path What you do
Hermes Each hermes// is a profile distribution. Publish that directory as a git repo, then hermes profile install --alias.
Grok Semi-manual: create bots from grok/bot-cards.md, enable grok/enable-lists.md, follow grok/setup-checklist.md. No bulk import.

Bundles are Tier-1 static. Auditors return NOT_SCORED. Registries are propose-only. On Grok, every bot on an account shares one cloud computer — names are not security boundaries. Full steps, output layout, and smoke: docs/ai-staff-install.md. Host matrix + owner-run backlog: agent-compatibility.md. Long-form: docs hub / AI Staff (placeholder path).

Offline check: python3 scripts/smoke-bot-projections.py.

First run

If the host routes skills automatically, describe the goal:

Research keywords for my SaaS product targeting small teams

Find TikTok creators for a skincare launch and score their fit

Audit this Google Ads account before I scale — exports attached

Or use a slash command — /auto to route, or a discipline entrypoint:

/aaron-marketing:auto turn our pricing page into an AI-citable comparison hub

/aaron-marketing:seo-geo https://example.com/blog/my-article --phase tune

Every skill works with pasted data. Optional tools: CONNECTORS.md.

Skill Dashboard

After install, project *

readme truncated — read the full docs on github

Frequently asked questions

Is aaron-marketing-skills free to use?

aaron-marketing-skills is open source under the Apache-2.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does aaron-marketing-skills do?

120 marketing skills as an AI marketing staff — plugin, portable skills, or an 8-bot team across 7 disciplines (narrative, SEO/GEO, social, email, paid, influen

What is aaron-marketing-skills written in?

aaron-marketing-skills is primarily written in Python. Its source is publicly available at https://github.com/aaron-he-zhu/aaron-marketing-skills, and it has 2,796 GitHub stars.