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.
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 |
| 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 (tagstandalone-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 <frontmatter-slug> |
| 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/<bot>/ is a profile distribution. Publish that directory as a git repo, then hermes profile install <url> --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 your own skill-run artifacts into a local page: Next, Usage, Delta, Outcomes, Decisions, Trust, Coverage, Staff, and optional Timeline.
python3 scripts/skill-dashboard.py --root .Point --root at the project that holds memory/, not at a plugin checkout
unless that is the working project. The command writes skill-dashboard.html
beside that root. This is a local generated page — not a hosted workbench
and not a Gateway. Operator guide: docs/skill-dashboard.md.
Skill catalog
Skill links open each SKILL.md. One-line purpose and plays live in each Discipline guide. Catalog order follows the four-layer strata — Narrative first, then the five channels, Launch, then Protocol.
Narrative — TALE (16) · 📖 Discipline guide
SEO/GEO — SITE (16) · 📖 Discipline guide
Social — ECHO (16) · 📖 Discipline guide
No posting, engagement, or DM automation.
Email — SEND (16) · 📖 Discipline guide
Paid Ads — ROAS (16) · 📖 Discipline guide
Influencer — STAR (16) · 📖 Discipline guide
| Phase | Skills |
|---|---|
| Scout | audience-mapper, trend-spotter, influencer-discovery, fit-scorer |
| Target | competitor-tracker, campaign-planner, brief-generator, budget-optimizer |
| Activate | outreach-manager, ⛩ creator-content-auditor, contract-helper, content-amplifier |
| Report | landing-optimizer, performance-analyzer, roi-calculator, report-generator |
Launch — RAMP (16) · 📖 Discipline guide
Protocol layer (8)
| Group | Skills |
|---|---|
| Protocol | entity-registry, creator-registry, offer-claims-registry, consent-registry, launch-registry, channel-registry, narrative-registry, memory-management |
Commands
Eight commands. Source: commands/.
| Command | Use it for | Narrowing |
|---|---|---|
/aaron-marketing:auto |
Any goal — smallest useful workflow | --deep |
/aaron-marketing:narrative |
Brand narrative (TALE) | --phase trace|architect|land|evaluate |
/aaron-marketing:seo-geo |
SEO/GEO (SITE) | --phase survey|implement|tune|evaluate |
/aaron-marketing:social |
Organic social (ECHO) | --phase explore|craft|host|observe |
/aaron-marketing:email |
Email (SEND) | --phase setup|engage|nurture|deliver |
/aaron-marketing:ad |
Paid ads (ROAS) | --phase research|orchestrate|activate|scale |
/aaron-marketing:influencer |
Influencer (STAR) | --phase scout|target|activate|report |
/aaron-marketing:launch |
Product launch (RAMP) | --phase research|assemble|mobilize|prove |
More
Short pointers only. Long-form essays belong on the docs hub (placeholder). Maintainer contracts stay in-repo.
- Architecture — L1 Narrative → L2 channels → L3 Launch → L4 Protocol. Shared contract: skill-contract.md. Four-layer map: system-architecture.md.
- Quality — eight frameworks, eight auditor gates (
SHIP/FIX/BLOCK/UNDECIDED). Runbook: auditor-runbook.md. - Capability profiles — fresh projects run Lite. Pro / Governed add connectors or stateful writes; they never drop consent, claims, or audit integrity. Details: capability-profiles.md. v19 validation status: this is an engineering-validated release. CI, package checks, and real-provider runs over simulated fixtures are not real-project outcome evidence; real-project outcomes remain unvalidated. Lite remains the fresh-project default. Governed availability does not validate Governed outcomes or Governed-by-default. That promotion needs the post-release cohort of 14 pilots + 70 paired Lite/Governed projects + 28 shadow projects.
- Connectors —
~~categoryplaceholders; Tier 1 is keyless. Recipes: CONNECTORS.md. Add one: connector-playbook.md. - Workflows —
/aaron-marketing:autofor cross-channel goals; each discipline guide lists its 4-phase loop. - Design — skills are content; keyless first; surgical/MECE; no invented numbers; compliance is guidance, not law.
- Hooks (Claude Code plugin):
SessionStart,UserPromptSubmit,PreToolUse,PostToolUse,PostToolUseFailure,PostToolBatch, andStop. The Artifact Gate is framework-agnostic. - Layout — discipline/phase trees,
commands/,references/,hooks/,scripts/,memory/,docs/.references/wiki/is maintainer knowledge, not a Skill and not a runtime default. - Skill Dashboard — local generator + schema in the plugin install surface. See Skill Dashboard.
- CI —
validate-skill.sh, golden math, evals, routing,check-wiki.py(wiki stays out of assembly), PII, stdlib-only, versions, andpython3 scripts/smoke-bot-projections.pyfor the AI Staff roster. Full guard list: CONTRIBUTING.md.
Distributions are allowlisted by references/distribution-files.json. Maintenance scripts named here (check-wiki.py and friends) stay in MAINTENANCE_EXACT and do not enter the plugin payload. scripts/skill-dashboard.py and references/skill-dashboard.schema.json are allowlisted install-surface files.
Contributing & project docs
- CONTRIBUTING.md — authoring rules, the 10 tracking surfaces, and team conventions.
- VERSIONS.md — per-skill versions + changelog (current bundle:
20.1.0).
- SECURITY.md · PRIVACY.md · CODE_OF_CONDUCT.md
- CLAUDE.md / AGENTS.md — agent-facing context.
- docs/README.md — which docs are in-repo SSOT vs site-hub destined.
Maintainer knowledge lives in references/wiki/ (schema: SCHEMA.md). It is not a 121st Skill and is not injected into runtime context assembly. Skill path/slug/name changes stay forbidden.
Disclaimer
These skills assist brand-narrative, SEO/GEO, influencer-marketing, paid-ads, email-marketing, product-launch, and organic-social workflows but do not guarantee rankings, AI citations, traffic, engagement, conversions, ROAS, deliverability, or business outcomes. Influencer-, ad-, email-, and social-compliance checks (FTC disclosure, claim integrity, platform policy, consent/opt-in, material-connection disclosure) are guidance, not legal advice. Verify recommendations with qualified professionals before relying on them for major strategy, financial, or legal decisions.
License
Apache License 2.0 — see LICENSE.