<div align="center">

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.

<p align="center">
  <a href="https://github.com/aaron-he-zhu/aaron-marketing-skills"><img src="https://img.shields.io/github/stars/aaron-he-zhu/aaron-marketing-skills?style=flat" alt="GitHub Stars"></a>
<!-- GENERATED:BEGIN release-surface:version-badge -->
  <a href="https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/VERSIONS.md"><img src="https://img.shields.io/badge/version-20.1.0-orange" alt="Version"></a>
<!-- GENERATED:END release-surface:version-badge -->
  <a href="https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-green" alt="License"></a>
  <a href="https://github.com/aaron-he-zhu/aaron-marketing-skills/commits/main"><img src="https://img.shields.io/github/last-commit/aaron-he-zhu/aaron-marketing-skills" alt="Last Commit"></a>
</p>
<p align="center">
  <a href="https://www.skills.sh/aaron-he-zhu"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/aaron-he-zhu/aaron-marketing-skills/main/badges/skillssh.json" alt="skills.sh"></a>
  <a href="https://clawhub.ai/aaron-he-zhu"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/aaron-he-zhu/aaron-marketing-skills/main/badges/clawhub.json" alt="ClawHub"></a>
  <a href="https://skillhub.cn/user/user_2c0f1e77"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/aaron-he-zhu/aaron-marketing-skills/main/badges/skillhub.json" alt="SkillHub"></a>
  <a href="https://claudeskills.info/skills/aaron-he-zhu/aaron-marketing-skills/"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/aaron-he-zhu/aaron-marketing-skills/main/badges/claudeskills.json" alt="ClaudeSkills"></a>
</p>

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

</div>

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
  • AI Staff
• First run
• 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 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

Social — ECHO (16) · 📖 Discipline guide

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

---

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 — ~~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.
• 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.

---

Contributing & project docs

• CONTRIBUTING.md — authoring rules, the 10 tracking surfaces, and team conventions.

<!-- GENERATED:BEGIN release-surface:current-bundle -->

• VERSIONS.md — per-skill versions + changelog (current bundle: 20.1.0).

<!-- GENERATED:END release-surface:current-bundle -->

• 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.

Star History

<a href="https://www.star-history.com/?repos=aaron-he-zhu%2Faaron-marketing-skills&type=date&legend=top-left">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=aaron-he-zhu/aaron-marketing-skills&type=date&theme=dark&legend=top-left&sealed_token=ejNFyk10Yua2s8a5BomKSd5kCPTp6s9p5WfLLK7z_xHjBbBXuZ2-m7dowGHvGzCJi4zhs-PUv4m4v77ZIsuYunVBnwWGIZRF5zGe6bl3Dob3Pwlm9VUelpwpKOAtf4V9s8crOVP2h4hAEfMV4TgrzuLW-K2Tx5Lv870ovKJuWC-urh-yG2E-9_c25uVl" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=aaron-he-zhu/aaron-marketing-skills&type=date&legend=top-left&sealed_token=ejNFyk10Yua2s8a5BomKSd5kCPTp6s9p5WfLLK7z_xHjBbBXuZ2-m7dowGHvGzCJi4zhs-PUv4m4v77ZIsuYunVBnwWGIZRF5zGe6bl3Dob3Pwlm9VUelpwpKOAtf4V9s8crOVP2h4hAEfMV4TgrzuLW-K2Tx5Lv870ovKJuWC-urh-yG2E-9_c25uVl" />
   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=aaron-he-zhu/aaron-marketing-skills&type=date&theme=dark&legend=top-left&sealed_token=ejNFyk10Yua2s8a5BomKSd5kCPTp6s9p5WfLLK7z_xHjBbBXuZ2-m7dowGHvGzCJi4zhs-PUv4m4v77ZIsuYunVBnwWGIZRF5zGe6bl3Dob3Pwlm9VUelpwpKOAtf4V9s8crOVP2h4hAEfMV4TgrzuLW-K2Tx5Lv870ovKJuWC-urh-yG2E-9_c25uVl" />
 </picture>
</a>