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.

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.

Install
- AI Staff
First run
Skill Dashboard
Skill catalog
Commands
More
Contributing
Disclaimer
License

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

Phase	Skills
Trace	narrative-baseline-mapper, category-narrative-mapper, audience-belief-mapper, positioning-truth-tracer
Architect	strategic-narrative-designer, message-system-architect, brand-language-codifier, story-bank-builder
Land	narrative-cascade-planner, pitch-narrative-builder, narrative-enablement-kit, proof-point-packager
Evaluate	⛩ narrative-quality-auditor, message-test-designer, narrative-resonance-monitor, narrative-drift-monitor

SEO/GEO — SITE (16) · 📖 Discipline guide

Phase	Skills
Survey	keyword-research, competitor-analysis, serp-analysis, content-gap-analysis
Implement	content-writer, geo-content-optimizer, serp-markup-builder, page-play-builder
Tune	⛩ content-quality-auditor, technical-seo-checker, on-page-seo-checker, site-structure-optimizer
Evaluate	⛩ domain-authority-auditor, rank-tracker, performance-monitor, offsite-signal-analyzer

No posting, engagement, or DM automation.

Phase	Skills
Explore	channel-portfolio-planner, voice-dossier-builder, platform-norm-profiler, participation-warmup-planner
Craft	social-calendar-builder, social-creative-builder, short-video-scripter, advocacy-program-designer
Host	⛩ social-quality-auditor, engagement-inbox-manager, social-selling-planner, crisis-response-planner
Observe	social-pulse-monitor, share-of-voice-tracker, dark-social-attributor, social-measurement-loop

Email — SEND (16) · 📖 Discipline guide

Phase	Skills
Setup	deliverability-qa, list-segment-builder, list-growth-designer, list-hygiene-monitor
Engage	email-creative-builder, subject-line-lab, email-render-builder, dynamic-content-personalizer
Nurture	email-sequence-designer, newsletter-monetization-planner, preference-frequency-manager, reactivation-specialist
Deliver	⛩ email-quality-auditor, send-experiment-designer, inbox-placement-monitor, cold-outbound-sequencer

Paid Ads — ROAS (16) · 📖 Discipline guide

Phase	Skills
Research	campaign-architect, audience-segment-builder, search-term-miner, product-feed-optimizer
Orchestrate	ad-creative-builder, ad-test-designer, bid-strategy-planner, landing-experience-checker
Activate	⛩ ad-account-auditor, conversion-signal-qa, placement-exclusion-manager, conversion-value-mapper
Scale	paid-measurement-loop, attribution-reconciler, budget-pacing-monitor, fatigue-frequency-manager

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

Phase	Skills
Research	positioning-mapper, launch-tier-planner, launch-window-planner, early-access-designer
Assemble	message-house-builder, launch-asset-packager, pricing-packaging-planner, sales-enablement-kit
Mobilize	⛩ launch-readiness-auditor, launch-day-conductor, community-launch-runner, press-media-relations
Prove	launch-monitor, launch-feedback-synthesizer, launch-retro-analyzer, momentum-planner

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`

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 — ~~category placeholders; Tier 1 is keyless. Recipes: CONNECTORS.md. Add one: connector-playbook.md.
Workflows — /aaron-marketing:auto for 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, and Stop. 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, and python3 scripts/smoke-bot-projections.py for 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.

Aaron Marketing Skills