<p align="center"> <img src="github-social.png" alt="MKTG-OS"> </p>

Marketing OS

Scale your marketing without sacrificing quality.

Marketing OS was built to give marketers and GTM teams more reach. It does three things:

• Automates repetitive production work through skills and workflows.
• Speeds up the work you already do.
• Extends into specialties you'd otherwise outsource or skip.

It comes with various skills, workflows, and sub-agents, plus a "brain" template that forms a knowledge base of your company's positioning, personas, and brand, so every draft comes out on-brand and accurate.

Everything is moldable. You do not need to use the specialist sub-agents. Feel free to work with your main agent to customize the workflows and skills to your own processes and styles. Trim what you don't need, modify what you want, add what you're missing!

Works with Claude Code and OpenAI Codex.

Getting Started

Prerequisites: Claude Code or OpenAI Codex. Optional: Vale for content linting, GitHub CLI (gh) for PR workflows.

1. Clone and scaffold

git clone https://github.com/t0ddharris/mktg-os.git mktg-os
cd mktg-os
./scripts/create-instance.sh

This asks for your company name and creates a standalone repo (e.g., ../your-company-marketing/) with all skills, agents, and brain templates.

2. Run setup

cd ../your-company-marketing
claude          # or: codex
/setup

/setup is a guided walkthrough. It will:

• Ask about your product, target customer, and category
• Scrape your website (optional) to pull in messaging and features automatically
• Build a starter positioning statement and buyer personas
• Extract your brand colors and fonts from your site (optional)
• Set up integrations (HubSpot, LinkedIn, Google AI Studio, etc.)

You don't need perfect answers. Anything you skip stays as a [FILL IN] placeholder that you can complete later.

3. Bring your own docs (optional)

Already have messaging frameworks, product overviews, brand guidelines, or competitive research? Drop them in the incoming/ folder before or during setup:

cp ~/Documents/our-messaging.pdf incoming/
cp ~/Documents/brand-guide.pdf incoming/

/setup will ask if you have reference files in incoming/ and use the content to pre-fill your brain files (with your approval before writing anything). Supports PDFs, Markdown, plain text, and images. This can save significant manual entry.

4. Start working

Once setup finishes, you're ready to go. Ask for what you need in plain language, or use a slash command:

/blog              Write a blog post
/social-content    Draft LinkedIn or X posts
/wf-landing-page   Build a landing page, end to end

How It Works

Marketing OS has four layers, each fixing a way AI marketing usually goes wrong:

• Brain (brain/) — One source of truth for your company. Every factual claim traces back to a brain file. If a fact isn't there, the system writes [FILL IN] instead of inventing one.
• Skills (.claude/skills/) — Step-by-step workflows for specific tasks, each with its own references, templates, and approval gates.
• Agents (.claude/agents/) — Specialist roles with defined tools and brain access. One agent (product-marketer) owns brain writes; the rest read only.
• `CLAUDE.md` — Routing and governance. Maps each request to the right skill, enforces the writing rules, and blocks AI slop.

Vale linting runs automatically after every edit in marketing/, catching banned words, weak language, and AI tells before you read the draft.

Workflows

Each workflow is one command that chains several skills, with an approval gate between stages. Skip any stage you don't need.

Skills

Agents

What's Inside

.claude/skills/    # 54 marketing skills (blog, SEO, CRO, HubSpot, ads, etc.)
.claude/agents/    # 6 specialist agents
templates/         # Everything copied into a new instance:
  CLAUDE.md        #   Routing tables, writing rules, anti-hallucination guardrails
  brain/           #   Source-of-truth templates (positioning, personas, competitive)
  brain/brand-guide/  # Visual brand system (colors, typography, components)
  styles/          #   Vale linting rules (AI-slop detection, banned words)
  .env.example     #   API key template
scripts/           # Generator scripts

Install as a Plugin

Prefer to add the skills to an existing project instead of scaffolding a new repo?

Claude Code:

claude plugin install --plugin-dir ./path-to-mktg-os

Codex: Clone into your Codex plugin path. The .codex-plugin/plugin.json manifest registers it automatically.

License

MIT