<div align="center">

<!-- BRANDING TODO: replace this block with assets/logo.png once re-dropped -->

██     ██    ███    ██    ██ ████████    ███     ██████   ████████      ███████   ██████
██     ██   ██ ██   ███   ██    ██      ██ ██   ██    ██  ██           ██     ██ ██    ██
██     ██  ██   ██  ████  ██    ██     ██   ██  ██        ██           ██     ██ ██
██     ██ ██     ██ ██ ██ ██    ██    ██     ██ ██   ████ ██████       ██     ██  ██████
 ██   ██  █████████ ██  ████    ██    █████████ ██    ██  ██           ██     ██       ██
  ██ ██   ██     ██ ██   ███    ██    ██     ██ ██    ██  ██       ███ ██     ██ ██    ██
   ███    ██     ██ ██    ██    ██    ██     ██  ██████   ████████ ███  ███████   ██████

                     marketing brain inside your agent

Vantage.os — Marketing Intelligence OS

The marketing brain inside your agent. Run /vantage, answer a few questions, and get a beautiful, evidence-backed competitive teardown.

Vantage maps the full digital-marketing surface of your rivals — positioning, content, website, paid, social, reputation — scores it into one Digital Share-of-Voice index, plots a positioning map, builds a competitive matrix, and writes rep-ready sales battlecards — then turns what you find into your positioning, ad concepts, content plan, and email flows. Every skill delivers a single, gorgeous, self-contained HTML report.

Lives inside your agent · Web search + fetch only · No API keys · Free & open source.

Install · The experience · What you get · Commands · How it works · Sample reports

<!-- BRANDING TODO: drop a hero logo + screenshot of a generated report here -->

</div>

The experience

/vantage isn't a one-shot command — it's a console that interviews you, one question at a time:

$ /vantage

   V A N T A G E . O S  ·  Marketing Intelligence OS
   marketing brain inside your agent

   ▸ What are you looking to do today?
     · Full competitive landscape   · Find my competitors
     · Positioning & messaging      · Website / ads / content / social
     · Sales battlecard             · Monitor competitors

   you ▸ full landscape

   ▸ What's your brand or website?
   you ▸ acme.com

   ▸ Who are your main competitors — or want me to find them?
   you ▸ find them for me

   ▸ Who's this for — marketing, sales, or both?
   you ▸ both

   ▸ How deep should I go — quick, standard, or deep dive?
   you ▸ standard

   → Running… → COMPETITIVE-LANDSCAPE.html opens in your browser.

Already know what you want? Skip the interview — /vantage acme.com or /vantage battlecard <competitor> jumps straight in.

Runs inside any agent

Vantage is a marketing-intelligence OS that lives inside your agent — not a single-vendor tool. The skills are plain, portable markdown (skills/**/SKILL.md): an agent loads them as a plugin, as rules, or as context, and runs the same console and the same reports wherever you work — Claude · Codex · Cline · Pi · Hermes and beyond.

Why Vantage

Most "competitive analysis" tools either dump data (rank trackers, ad-spy dashboards) or stay generic. Vantage turns public evidence into decisions. Every section ends in a move, every number cites a dated source, and the same evidence always yields the same score — output you can hand straight to a founder, a growth lead, or a sales rep.

• 🎯 Built for marketing & sales, not SEO audits. Positioning, messaging, offers, share-of-voice, and battlecards — the things that move pipeline.
• 🧮 A real scoring model. The Digital Share-of-Voice (DSoV) index scores every competitor and you 0–100 across six channels, so every cell reads as a gap.
• 🌐 Web-only, no keys. Runs entirely on WebSearch + WebFetch. Uses public ad libraries, review sites, and the Wayback Machine.
• 📄 A deliverable you'll want to send. One self-contained HTML file — your competitor's real logo, a heatmap matrix, a plotted 2×2 map, win/lose battlecards, a sourced evidence log. Print-to-PDF ready.
• 🤝 Plays well with others. Hands off cleanly to SEO/backlink skills for keyword-level depth instead of reinventing them.

What you get

Sample reports

Every pack ships a real, self-contained HTML sample built on one fictional brand — Northpeak, a revenue-intelligence platform — so you can read a teardown and the marketing it produces as one continuous story. Open any of these in a browser:

Install

Vantage skills are portable markdown files. Claude Code loads them natively as a plugin; every other agent loads them as rules / instructions / context. Native one-command installers for more agents are on the roadmap.

Grab the skills once:

git clone https://github.com/macmenes/vantage.git

<details open> <summary><b>Claude / Claude Code</b> — native plugin</summary>

/plugin marketplace add macmenes/vantage
/plugin install vantage@vantage

…or drop them in directly: cp -R vantage/skills/* ~/.claude/skills/ Then type /vantage. </details>

<details> <summary><b>Codex</b> (OpenAI) — agent instructions</summary>

Point Codex at the skills from your AGENTS.md (project or ~/.codex/):

# Marketing intelligence — Vantage.os
When I ask for competitive analysis / "vantage", follow ./vantage/skills/vantage/SKILL.md
(and its referenced sub-skills) exactly.

Then ask: "run Vantage on acme.com." </details>

<details> <summary><b>Cline</b> — rules / workflow</summary>

Add the skills as a Cline rule or workflow:

mkdir -p .clinerules && cp -R vantage/skills/* .clinerules/vantage/

Then ask Cline to "run the Vantage competitive analysis." </details>

<details> <summary><b>Pi · Hermes · any other agent</b> — universal method</summary>

Any agent that accepts custom instructions works: load vantage/skills/**/SKILL.md as the agent's system prompt / rules / context, then ask it to "run Vantage competitive analysis on <domain>." The flow, scoring, and HTML report are identical everywhere. </details>

Commands

How it works

The vantage console fans out to 8 specialists, scores each on web-only evidence, and synthesizes the result.

                         /vantage <your-domain>
                                  │
                   ┌──────────────┴───────────────┐
                   ▼                               ▼
            vantage-discover                  (your brand,
         build & tier the set              scored on the same rubric)
                   │
   ┌───────┬───────┼────────┬────────┬─────────┐
   ▼       ▼       ▼        ▼        ▼         ▼
positioning content website  ads    social  reputation
   └───────┴───────┴────────┴────────┴─────────┘
                   │  score each 0–100 → DSoV
                   ▼
        positioning map · matrix · white space
                   ▼
           vantage-battlecard  →  beautiful HTML report
                   ▼
            vantage-monitor (optional recurring watch)

The DSoV index

DSoV = 0.20·Positioning + 0.20·Content + 0.15·Website
     + 0.15·Paid + 0.15·Social + 0.15·Reputation

Bands: Dominant 85+ · Strong 70–84 · Credible 50–69 · Thin 30–49 · Absent <30. No channel is scored without ≥3 cited signals. Full rubrics live in skills/vantage/references/scoring-framework.md.

The skills

Responsible by design

Vantage uses public sources only — ad transparency libraries, review sites, the Wayback Machine, and public pages. No impersonation, no breaching auth or paywalls, no scraping gated data, no disparagement in battlecards (it steelmans rivals, then counters with evidence). Every quantitative claim is cited with a capture date. See skills/vantage/references/ethics-and-tos.md.

Roadmap

Vantage is built as an OS / hub: /vantage is the front door to a growing pack of marketing skills.

• [x] Competitive Analysis pack — teardowns, DSoV, positioning map, battlecards
• [x] Positioning Studio — messaging house, value prop, hero copy, narrative
• [x] Paid-Media Lab — ad concepts, hooks, full copy, creative briefs, test plan
• [x] Content Engine — pillar/cluster plan, topic backlog, briefs, calendar
• [x] Lifecycle & Email — lifecycle map, sequences, full email copy, triggers
• [ ] Hero logo + screenshot + short demo GIF
• [ ] Native installers for more agents (Codex · Cline · Pi · Hermes)
• [ ] Brand & PR pack
• [ ] Optional connectors (DataForSEO / SerpAPI / SimilarWeb) as opt-in power-ups

Contributing

Issues and PRs welcome. The design system for the HTML report is documented in skills/vantage/references/html-report.md.

License

MIT © macmenes. Free to use, modify, and share.