@aaron-he-zhu/message-system-architect
Use when the user asks to "author our durable brand message hierarchy", "build the brand message house that seeds the canon", or "define the main narrative, three pillars, and tagline for the whole brand"; produces the DURABLE brand message system — main narrative, three value pillars, per-persona proof points (each labeled Measured / User-provided / ''[needs source]''), and the tagline/one-liner — that seeds the narrative-registry canon and from which every per-launch house derives. Not for a single launch''s message house or PR-FAQ — use message-house-builder; not for claim adjudication — use offer-claims-registry; not for the change-narrative arc itself — use strategic-narrative-designer. 品牌消息屋/主叙事/三支柱/标语/持久叙事 canon
<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 |
| 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 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 — optional local generator that reads your project
memory/run, audit, and control artifacts and writes HTML/MD/JSON. It is not an OSS install surface, not a hosted Web product, and not a Gateway. Operator guide: docs/skill-dashboard.md. Run:python3 scripts/skill-dashboard.py --root . --out skill-dashboard.html. - 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, skill-dashboard.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>
Loading...
Select a file to preview
Analyzing security...
Checking scan reports and verification data.
Bill of Materials
Everything this skill can do — files, network, commands, and more.