# Marketing Agent > Use when the user wants to produce a complete marketing specification bundle — campaign brief, target audience profile, messaging framework, content calendar, channel strategy, SEO keyword plan, competitive positioning, launch plan, and measurement framework — for a product, service, or brand initiative. Triggers when the user says "create a campaign brief", "write a messaging framework", "marketing strategy", "content calendar", "channel strategy", "marketing agent", "/marketing-agent", or describes a marketing artifact task. Invokes the AgentSuite Marketing agent via MCP. - Skill: `tomevault-io/marketing-agent` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/marketing-agent` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/marketing-agent/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Marketing & Growth - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/marketing-agent --- # Marketing Agent Skill This skill invokes the Marketing agent from the AgentSuite MCP server. It produces 9 marketing specification artifacts and 8 brief templates for ad copy, blog posts, email campaigns, influencer briefs, landing pages, press releases, quarterly reports, and social post series in 30–120 seconds, then pauses for human approval before promoting to long-lived storage. ## When to use User wants any of: - Campaign brief with goals, audience, and creative direction - Target audience profile with segmentation and personas - Messaging framework with value propositions and proof points - Content calendar with themes, cadence, and ownership - Channel strategy with platform mix and budget allocation - SEO keyword plan with priority terms and content mapping - Competitive positioning with differentiation and battle cards - Launch plan with sequenced milestones and go-live checklist - Measurement framework with KPIs, baselines, and reporting cadence - Ready-to-fill brief templates for ad copy, blog posts, email campaigns, influencer briefs, landing pages, press releases, quarterly reports, or social post series ## When NOT to use - Technical architecture — use the Engineering agent - Visual/brand direction — use the Design agent - Product requirements — use the Product agent - One-off copy or text tasks — write directly or use the Founder agent ## Steps 1. **Confirm required inputs.** Ask the user for: - `brand_name` — the name of the brand or product (required) - `campaign_goal` — one sentence describing the primary marketing objective (required) - `target_market` — the intended audience segment (required) - `project_slug` — lowercase, hyphenated identifier for `_kernel/` promotion (required) 2. **Gather optional context.** Ask if the user has: - Existing brand docs (brand guidelines, past campaign results, tone-of-voice guide) - Competitor docs (competitor campaigns, positioning, market research) - Budget range and timeline constraints - Preferred channels (social, email, paid, organic, PR, etc.) These are optional — the agent can run without them. 3. **Set the environment.** Ensure `AGENTSUITE_ENABLED_AGENTS=founder,design,product,engineering,marketing` is set in the MCP env config. If "marketing" is not in `enabled` when you call `agentsuite_list_agents`, paste the snippet from `~/.claude/skills/marketing-agent/mcp-snippet.json` and ask the user to update their MCP config. 4. **Run the agent.** Execute: ``` agentsuite marketing run --brand-name "..." --campaign-goal "..." --target-market "..." ``` Optionally append `--existing-brand-docs path/to/docs`, `--competitor-docs path/to/research`, `--budget-range "..."`, `--timeline "..."`, or `--channels "..."` if the user provided those inputs. 5. **Artifacts appear in `.agentsuite/runs/{run_id}/`.** The primary output is `campaign-brief.md`. Additional artifacts: `target-audience-profile.md`, `messaging-framework.md`, `content-calendar.md`, `channel-strategy.md`, `seo-keyword-plan.md`, `competitive-positioning.md`, `launch-plan.md`, `measurement-framework.md`. 6. **Review QA scores.** Open `qa_scores.json`. If any score is < 7.0, read `revision_instructions` in that file for specific guidance on what to improve. Address revisions before approving. 7. **Approve when satisfied.** Call: ``` agentsuite marketing approve --run-id {run_id} --approver {name} --project-slug {slug} ``` This promotes artifacts to `_kernel//` for use in downstream agents and sessions. ## Cost expectations A typical run costs $0.10 – $0.50 against Claude Sonnet or GPT-4o (12 LLM calls: 9 spec artifacts + extract + consistency check + QA scoring). Cost varies with input context size. Hard cap is $5.00 per run — if `HardCapExceeded` is raised, reduce input size or raise `AGENTSUITE_COST_CAP_USD`. ## Failure modes - **`ConsistencyCheckFailed`** — One of the 9 artifacts contradicts another on a critical dimension (e.g. channel strategy targets a demographic that differs from the target audience profile). Fix: add clearer constraints to your input, or narrow the `campaign_goal` statement before re-running. - **`Low QA scores`** — `requires_revision=true` in the result. Open `qa_scores.json` and read `revision_instructions` for each artifact scoring below 7.0. Apply the specific changes listed before approving. - **`NoProviderConfigured`** — Set `ANTHROPIC_API_KEY` or `OPENAI_API_KEY` in the MCP env. - **`extract stage produced invalid JSON`** — Transient LLM formatting error. Re-run; it typically resolves on retry. ## Rubric dimensions QA scoring evaluates each artifact on 9 dimensions: `audience_clarity`, `message_resonance`, `channel_fit`, `metric_specificity`, `budget_realism`, `anti_vanity_metrics`, `content_depth`, `competitive_awareness`, `launch_sequencing`. Each dimension scores 0–10; artifacts with any dimension below 7.0 are flagged for revision. ## After approval Promoted artifacts in `_kernel//` can be fed directly into any subsequent AgentSuite agent session, shared with design teams as creative direction grounding, or loaded into an engineering session to align technical roadmap with campaign timelines. The `brief-template-library/` folder contains 8 ready-to-fill templates for ad copy, blog posts, email campaigns, influencer briefs, landing pages, press releases, quarterly reports, and social post series. --- > Source: [scottconverse/AgentSuite](https://github.com/scottconverse/AgentSuite) — distributed by [TomeVault](https://tomevault.io).