At a glance
What's new in 0.4.0
- Every popular coding agent. Codex plugins (
codex plugin marketplace add AI-Marketing-OS-LTD/cmo-so-skills), Pi packages (pi install npm:@cmo-so/skills), and npx @cmo-so/skills install -a <agent> for Cursor, Gemini CLI, OpenCode, GitHub Copilot, Windsurf and 13 more, in project or user scope.
- Codex skills now go to
~/.agents/skills, the folder Codex reads.
What's new in 0.3.0
Ten new skills, and 72 existing skills improved with rules, checklists and platform details from a review of 196 open-source marketing, SEO, social media and analytics projects:
- Social channels:
cmo-open-social (Threads, Bluesky, Mastodon), cmo-reddit, cmo-pinterest, cmo-china-social (Xiaohongshu, WeChat, Douyin, Weibo).
- Social operations:
cmo-social-listening, cmo-social-crisis, cmo-employee-advocacy.
- Trust and delivery:
cmo-email-deliverability, cmo-brand-protection, cmo-agent-readiness (make your site usable by AI agents).
Quick start
Pick your agent. Every route installs the same 124 skills; the core ones run on the CMO.so MCP server.
| Agent | Install |
|---|
| Claude Code | /plugin marketplace add AI-Marketing-OS-LTD/cmo-so-skills then /plugin install cmo-so-all@cmo-so |
| Codex | codex plugin marketplace add AI-Marketing-OS-LTD/cmo-so-skills then codex plugin add cmo-so@cmo-so (and any category, e.g. cmo-so-seo@cmo-so) |
| Pi | pi install npm:@cmo-so/skills (or pi install git:github.com/AI-Marketing-OS-LTD/cmo-so-skills) |
| Cursor, Gemini CLI, OpenCode, GitHub Copilot, Windsurf, Amp, Cline, Goose, Kiro, Qwen Code, Trae, Roo, Kilo, Augment, Droid, OpenHands, Antigravity | npx @cmo-so/skills install -a cursor (any agent id; comma-separated for several) |
| Any agent, any scope | npx @cmo-so/skills install (this project) or npx @cmo-so/skills install -g (your user) |
@cmo-so/skills installs into the folder each agent reads, for one project or for your user:
npx @cmo-so/skills install # this project, for the agents set up here (.claude/skills, .agents/skills, …)
npx @cmo-so/skills install -g -a codex,pi # every project: ~/.agents/skills (Codex, Pi)
npx @cmo-so/skills install -a claude --category seo,social --mcp # some categories, plus the MCP server in .mcp.json
npx @cmo-so/skills agents # every supported agent and its folders
npx @cmo-so/skills@latest update -g # update later; your edits are kept
See packages/skills for update, remove and the other options. The skills also work with the open skills CLI: npx skills add AI-Marketing-OS-LTD/cmo-so-skills -a <agent>.
Connect the MCP server (the core skills need it; sign in with your CMO.so account, no keys):
| Agent | Connect |
|---|
| Claude Code | The plugin brings it: /mcp → cmo-so → Authenticate. Otherwise claude mcp add --transport http cmo-so https://mcp.cmo.so/mcp |
| Codex | The cmo-so plugin brings it: codex mcp login cmo-so. Otherwise codex mcp add cmo-so --url https://mcp.cmo.so/mcp |
| Gemini CLI | gemini mcp add --transport http cmo-so https://mcp.cmo.so/mcp |
| Cursor, VS Code, Windsurf | Add a remote MCP server with the URL https://mcp.cmo.so/mcp |
| Pi and agents that start a command | npx -y @cmo-so/mcp (stdio), after npx @cmo-so/cli login |
Or just ask your agent: "Connect to CMO.so".
Try asking:
- "What needs me today on my website?"
- "How did my site do this week?"
- "Which pages get impressions but no clicks?"
- "Do AI answers mention my site?"
- "Write three LinkedIn posts from my latest article and queue them."
Supported platforms
| Platform | How to install | Skills folder (project · user) | MCP server |
|---|
| Claude Code | Plugin marketplace, or npx @cmo-so/skills -a claude | .claude/skills · ~/.claude/skills | Included in the cmo-so plugin |
| Codex (CLI, IDE, ChatGPT desktop) | Plugin marketplace, or npx @cmo-so/skills -a codex | .agents/skills · ~/.agents/skills | Included in the cmo-so plugin |
| Pi | pi install npm:@cmo-so/skills, or npx @cmo-so/skills -a pi | .agents/skills · ~/.agents/skills | npx -y @cmo-so/mcp |
| Cursor | npx @cmo-so/skills -a cursor | .agents/skills · ~/.cursor/skills | Remote URL |
| Gemini CLI | npx @cmo-so/skills -a gemini | .agents/skills · ~/.gemini/skills | gemini mcp add |
| OpenCode | npx @cmo-so/skills -a opencode | .agents/skills · ~/.config/opencode/skills | Remote URL |
| GitHub Copilot | npx @cmo-so/skills -a copilot | .agents/skills · ~/.copilot/skills | Remote URL |
| Windsurf | npx @cmo-so/skills -a windsurf | .windsurf/skills · ~/.codeium/windsurf/skills | Remote URL |
| Amp | npx @cmo-so/skills -a amp | .agents/skills · ~/.config/agents/skills | Remote URL |
| Cline | npx @cmo-so/skills -a cline | .agents/skills · ~/.agents/skills | Remote URL |
Add -g to an npx @cmo-so/skills install command to install for your user (every project) instead of the current project. "Remote URL" means adding https://mcp.cmo.so/mcp as a remote (streamable HTTP) MCP server in that agent's settings; it signs in with OAuth. Tested end to end on Claude Code, Codex and Pi; the other folders follow each agent's documented skills location.
Standalone install
Each skill is one self-contained folder with a SKILL.md (the open Agent Skills format), so you can install without any of the tools above.
All skills, without Node (macOS, Linux, WSL; change the target to the folder your agent reads):
git clone --depth 1 https://github.com/AI-Marketing-OS-LTD/cmo-so-skills.git
mkdir -p ~/.agents/skills
cp -R cmo-so-skills/plugins/*/skills/* ~/.agents/skills/
One skill (no clone):
mkdir -p ~/.agents/skills
curl -sL https://github.com/AI-Marketing-OS-LTD/cmo-so-skills/archive/refs/heads/main.tar.gz \
| tar -xz --strip-components=4 -C ~/.agents/skills cmo-so-skills-main/plugins/cmo-so-seo/skills/cmo-seo-audit
The path is plugins/<plugin>/skills/<skill>; skills.json lists every skill with its plugin (skill_file).
With Node, any agent: npx @cmo-so/skills install [-g] -a <agent> copies the skills, keeps a record, and later updates them without overwriting your edits. The open skills CLI works too: npx skills add AI-Marketing-OS-LTD/cmo-so-skills -a <agent>.
Windows: download the ZIP and copy the folders from plugins\<plugin>\skills\ to your agent's skills folder (for example %USERPROFILE%\.agents\skills), or use npx @cmo-so/skills in PowerShell.
Claude.ai and Claude Desktop: zip one skill folder (for example cmo-seo-audit/) and upload it in Settings → Capabilities → Skills.
Agents without a skills folder: paste a SKILL.md into the agent's custom instructions or rules, or point the agent at the file: "Follow plugins/cmo-so-seo/skills/cmo-seo-audit/SKILL.md".
To update, repeat the copy (it replaces the files) or switch to npx @cmo-so/skills, which keeps your edits. For the core skills, also connect the MCP server.
How it works
Every skill is a SKILL.md your agent loads when the task matches. Skills come in three tiers:
| Tier | What it means |
|---|
| core | Runs on the CMO.so MCP server: Maggie's blog autopilot, LinkedIn queue, Search Console, AI visibility and business profile. Needs a CMO.so account. |
| connected | Uses CMO.so data and actions when the server is connected, for example your business profile or queueing a blog idea. Works without it too. |
| standalone | A marketing method that works with any agent, such as ad audits, pricing or PR. CMO.so is optional. |
Each category is its own plugin, and every plugin installs cmo-so (the core skills and the MCP connection) with it. Install everything with cmo-so-all, or only what you need, for example /plugin install cmo-so-seo@cmo-so.
Skills
140 skills in 13 plugins, plus the cmo-so-all bundle. Generated from the catalog: please open an issue rather than editing a SKILL.md.
CMO.so core (MCP) · cmo-so
| Skill | What it does |
|---|
cmo-connect | Connect an AI agent to CMO.so through the MCP server (OAuth, or CLI/API key without a browser) and pick the website to work on. |
cmo-daily | What needs the user today (LinkedIn drafts, failures, setup steps, quota) and clearing it one approved action at a time. |
cmo-weekly-report | Weekly report from CMO.so data: posts, Search Console, AI visibility, best and worst content, and two or three next steps. |
cmo-blog-planner | Plan the blog in CMO.so: ideas from links, sentences, AI generation or the sitemap, and the ordered writing plan Maggie follows. |
cmo-linkedin | Run the LinkedIn queue in CMO.so: review and approve drafts, turn articles into posts, plan days, campaigns, pause and resume. |
cmo-memory | Keep the user's lasting taste in Maggie Memory (prefer, always, never per channel) so every future post, draft and picture follows it, and show or forget what is remembered. |
cmo-ops-autopilot | What Maggie does on her own every day and week (fills social slots, checks posts before they go out, retries failures, ideas from Search Console and competitors, post checks, Google reviews, the Monday report), how to switch each part, and how to read and save reports. |
Strategy & research · cmo-so-strategy
| Skill | What it does |
|---|
cmo-customer-research | Build the ideal customer profile and personas from interviews, reviews and data: pains, triggers, objections and their words. |
cmo-positioning | Sharpen positioning, value proposition and messaging hierarchy, and keep brand guidelines consistent across channels. |
cmo-competitor-research | Profile competitors from their sites and search footprint: positioning, offers, content themes, keywords, links and gaps to exploit. |
cmo-marketing-plan | A practical marketing plan: goals, audience, channels, budget, 90-day roadmap and the CMO.so autopilot as the engine for content. |
cmo-marketing-audit | Score a website's marketing end to end (message, SEO, AI visibility, conversion, social, email) and rank the fixes. |
cmo-marketing-ideas | Generate and rank marketing ideas that fit the business, budget and stage, with the first step for each. |
cmo-marketing-psychology | Apply behavioural principles (social proof, anchoring, loss aversion, defaults) to pages, offers and emails, ethically. |
SEO · cmo-so-seo
| Skill | What it does |
|---|
cmo-seo-audit | Full SEO audit of a site: technical health, on-page, content, links and search data, delivered as a short prioritised fix list. |
cmo-technical-seo | Crawlability, indexing, Core Web Vitals, rendering, redirects and IndexNow: find and fix what stops pages being found. |
cmo-page-seo | Optimise one page for its query: title, meta, headings, intent match, internal links, images and alt text. |
cmo-keyword-research | Find keywords worth targeting from Search Console, competitors and SERPs, judged by intent, difficulty and fit, then add them as ideas. |
cmo-keyword-clustering | Group keywords by search intent and SERP overlap into topic clusters, mapped to existing or new pages. |
cmo-content-brief | A competitive brief for one article: intent, outline, sections, entities, questions, internal links and the CTA. |
cmo-content-refresh | Revive decaying or no-traffic posts: diagnose why, rewrite with Maggie, and track the result. |
|
AI search (GEO / AEO) · cmo-so-ai-search
| Skill | What it does |
|---|
cmo-ai-visibility-audit | A one-off report on how the brand shows up in AI answers for its market and the few changes most likely to get it cited. |
cmo-ai-prompt-research | Find the questions people ask AI assistants about the market, how they are answered, and which sites get cited. |
cmo-ai-citation-gaps | Find the pages AI assistants cite in the category and which of those sources the brand can get into or out-do. |
cmo-ai-brand-monitoring | Track what AI assistants say about the brand over time and catch wrong, outdated or damaging claims. |
cmo-aeo-content | Restructure pages so AI assistants can quote them: direct answers, facts, sources, E-E-A-T signals and schema. |
cmo-agent-readiness | Make a site usable by AI agents that browse, fill in forms and buy for people: accessibility tree, layout stability, access policy, discovery files and safe agent tools, fixed in priority order. |
cmo-entity-audit | Check that search engines and AI answers can tell exactly who the business is — Organization and Product schema, sameAs links to every official profile, Wikidata, and one consistent name, description and contact details everywhere — and fix the gaps in order. |
Content & copy · cmo-so-content
| Skill | What it does |
|---|
cmo-content-strategy | Decide what to publish and why: pillars, topics by funnel stage, formats, cadence and how CMO.so's autopilot executes it. |
cmo-blog-writing | Write or direct one blog post from brief to publish-ready, in the brand voice, then hand it to Maggie's queue. |
cmo-copywriting | Write page copy that converts: homepage, landing, pricing, feature and about pages, built on the brand profile. |
cmo-copy-editing | Edit existing copy for clarity, specificity, proof and flow with a structured review pass. |
cmo-humanize | Remove AI writing tells so text reads like a person wrote it, without losing facts. |
cmo-content-repurposing | Turn one article, podcast or video into LinkedIn posts, threads, emails, ad hooks and short videos. |
cmo-lead-magnets | Plan and build a lead magnet people actually want, and the capture and follow-up around it. |
|
Social & community · cmo-so-social
| Skill | What it does |
|---|
cmo-social-strategy | Pick platforms, pillars, cadence and formats, and run a content calendar with CMO.so's LinkedIn queue as the engine. |
cmo-linkedin-posts | Write and lint LinkedIn posts (story, how-to, opinion, carousel, poll) with strong hooks, then queue them in CMO.so. |
cmo-linkedin-profile | Audit and rewrite a LinkedIn profile or company page: headline, About, experience, Featured and banner. |
cmo-linkedin-engagement | Grow reach through comments, replies and connection notes with a daily routine that does not feel spammy. |
cmo-linkedin-strategy | Positioning, content pillars and a test plan for LinkedIn, judged by what the numbers actually say. |
cmo-x-growth | Build an audience on X: positioning, posts and threads, reply strategy and what to measure. |
cmo-social-analytics | Measure social performance honestly: engagement, reach, clicks and pipeline, with benchmarks and next tests. |
|
Email & lifecycle · cmo-so-email
| Skill | What it does |
|---|
cmo-email-sequences | Welcome, nurture, launch and re-engagement sequences with subject lines and copy in the brand voice. |
cmo-cold-email | B2B cold outbound that gets replies: targeting, first lines, follow-ups, deliverability and multichannel cadences. |
cmo-sms-whatsapp | Compliant SMS and WhatsApp flows: welcome, abandoned cart, post-purchase and win-back. |
cmo-churn-prevention | Keep customers: health signals, cancel flows, save offers, failed-payment recovery and win-back. |
cmo-newsletter | A newsletter people open: positioning, format, sections, cadence and growth, fed by the posts Maggie publishes. |
cmo-email-deliverability | Check that opted-in marketing email reaches the inbox: authentication, unsubscribe headers, bounces and suppression, sender reputation and list hygiene, with fixes in order. |
Paid ads · cmo-so-paid-ads
| Skill | What it does |
|---|
cmo-ads-strategy | Plan paid media: objectives, unit economics, channel choice, campaign architecture, audiences and the test plan. |
cmo-ads-audit | Audit any ad account against a platform checklist: tracking, structure, targeting, creative, bidding and wasted spend. |
cmo-google-ads | Run Google Ads well: Search, Performance Max and Shopping structure, search terms, negatives, Quality Score and extensions. |
cmo-meta-ads | Meta ads that scale: Pixel and Conversions API, account structure, audiences, creative testing and frequency. |
cmo-linkedin-ads | B2B LinkedIn ads: Insight Tag, audiences and ABM, lead gen forms, creative and budgets that do not burn out. |
cmo-ad-creative | Write, test and refresh ad creative: angles, hooks, headlines, visuals and fatigue detection, from the brand profile. |
cmo-ads-budget | Allocate budget across channels, pick bid strategies, pace spend and forecast CPA and ROAS from real data. |
|
Conversion (CRO) · cmo-so-cro
| Skill | What it does |
|---|
cmo-page-cro | Increase conversions on any marketing page: clarity, proof, friction, CTA and offer, with a prioritised test list. |
cmo-landing-page-audit | Score a landing page against the ads and emails that send traffic: message match, speed, mobile, trust and form friction. |
cmo-form-cro | Lead, contact and demo forms that people finish: fields, order, copy, validation and follow-up. |
cmo-signup-flow | Fewer drop-offs from signup to first value: steps, social login, copy and trial setup. |
cmo-onboarding-activation | Get new users to the moment of value fast: first-run, checklists, empty states and onboarding emails. |
cmo-popups | Popups, slide-ins and banners that convert without annoying people: trigger, offer, copy and frequency. |
cmo-paywalls | In-app paywalls, upgrade screens and feature gates that convert at the right moment. |
|
Analytics & reporting · cmo-so-analytics
| Skill | What it does |
|---|
cmo-tracking-setup | Measurement that works: GA4 and Tag Manager events, conversions, UTM conventions and server-side tracking. |
cmo-attribution | Work out which marketing drives revenue: models compared side by side, conversion paths and platform disagreements. |
cmo-campaign-analytics | Analyse campaign and funnel performance, ROI and benchmarks, and decide what to scale or stop. |
cmo-client-report | A polished report for a client or the board (Markdown, HTML or PDF) with a plain-English narrative on top. |
cmo-closed-loop-measurement | Judge every marketing change by what it did in the data: baseline, change log, follow-up read and keep or revert. |
Growth & go-to-market · cmo-so-growth
| Skill | What it does |
|---|
cmo-product-launch | Plan and run a launch or feature announcement: phases, channels, assets, Product Hunt and follow-through. |
cmo-referral-program | Design and run a referral or affiliate program: incentive, mechanics, promotion and fraud checks. |
cmo-co-marketing | Find partners with the same audience and run joint content, webinars, bundles and integrations. |
cmo-free-tools | Plan a free tool (calculator, checker, generator) that earns links, rankings and leads. |
cmo-directory-submissions | Get listed in the right startup, SaaS, AI and review directories for links and discovery, without spam. |
cmo-public-relations | Earn coverage: angles, press releases, journalist targeting, pitches and follow-ups. |
cmo-events-webinars | Plan, promote and convert webinars and events, from topic to follow-up sequence. |
|
Sales & revenue · cmo-so-sales
| Skill | What it does |
|---|
cmo-prospecting | Find and qualify prospects and build a dossier for each before reaching out. |
cmo-sales-enablement | Decks, one-pagers, objection handling, battlecards and demo scripts that match the marketing message. |
cmo-revops | Lead lifecycle, scoring, routing and pipeline health so marketing and sales hand off cleanly. |
cmo-proposals | Client proposals and SOWs for marketing work: scope, deliverables, timeline, pricing and terms. |
Images & video · cmo-so-creative
| Skill | What it does |
|---|
cmo-image-generation | Create on-brand images: blog heroes, social graphics, OG images, ad visuals and product shots. |
cmo-video-production | Plan and produce marketing videos with AI tools: script, footage, edit plan, captions and versions per platform. |
cmo-video-repurposing | Mine long videos, webinars and podcasts for clips, quotes and posts, with timestamps. |
cmo-ad-video | Make a 15-30 second ad video for a business with CMO.so (beta): a storyboard from a brief, a post or a YouTube ad to follow, shown with its cost before anything is paid for; then each scene's picture, a moving clip, the narrator's voice, music, on-screen words and an end card with the real logo, cut into one video and posted on Reels, TikTok, Shorts, LinkedIn or Facebook. |
The CMO.so MCP server
Every skill above runs on one MCP server: https://mcp.cmo.so/mcp (Streamable HTTP, OAuth 2.1).
- 125 tools cover your websites, results (Search Console, AI visibility, content performance, SEO audit), blog ideas, plan and drafts, the LinkedIn queue and campaigns, business profile and brand voice, autopilot settings and team access.
- Sign in with your CMO.so account. There are no keys to paste. The agent gets exactly your team permissions on each website, and a read-only key only sees read tools.
- Two-step changes. A tool that changes something first returns a preview and a
confirmation. It runs only when called again with confirm: true, and it runs exactly the call that was previewed.
- Cards in ChatGPT. Results, blog posts and the LinkedIn queue (with Approve) render as cards.
| Client | How to connect |
|---|
| Claude Code | This plugin (/mcp → cmo-so → Authenticate), or claude mcp add --transport http cmo-so https://mcp.cmo.so/mcp |
| Claude.ai / Claude Desktop | Settings → Connectors → Add custom connector → https://mcp.cmo.so/mcp |
| ChatGPT | Plugins → Add → Add custom MCP server → https://mcp.cmo.so/mcp, OAuth (developer mode, until the listing is live) |
| Cursor, VS Code, Windsurf | Add a remote HTTP server with the same URL, or run it locally (below) |
Local (stdio), for clients that start a command:
{
"mcpServers": {
"cmo-so": { "command": "npx", "args": ["-y", "@cmo-so/mcp"] }
}
}
Sign in once with npx @cmo-so/cli login, or set CMO_API_KEY to an API key from your account settings. Package: @cmo-so/mcp.
The cmo CLI
@cmo-so/cli runs the same actions from your terminal, in scripts and in CI.
npx @cmo-so/cli login # sign in in your browser (device code)
npm i -g @cmo-so/cli # then just `cmo`
cmo inbox # what needs you now
cmo results --period 30d # posts, ideas waiting, AI visibility
cmo ideas add https://example.com/page # queue a blog idea
cmo ideas generate -n 5 --brief "spring skincare"
cmo posts ls --status planned # what Maggie writes next
cmo social ls # LinkedIn queue
cmo social approve 30 31 # approve drafts
cmo autopilot pause # or resume
cmo run gsc_queries_get filter=low_ctr limit=10 # any of the 125 tools
cmo mcp # the local MCP server (stdio)
- Options for every command:
--json, -w/--workspace <domain>, --dry-run (preview only), and -y/--yes (no prompt, for CI).
- Changes ask first. Without a terminal and without
--yes, nothing changes.
- Exit codes:
0 done, 2 input, 3 sign-in, 4 plan, permission or limit, 5 server.
- In CI, set
CMO_API_KEY; CMO_WORKSPACE picks the website.
Other agents
The skills are plain SKILL.md folders under plugins/, in the open Agent Skills format, so any agent that reads skills can use them with the MCP server above:
plugins/*/skills/ for Claude Code plugins (.claude-plugin/), Codex and Agent Plugins hosts (plugin.json, mcp.json, marketplace in .agents/plugins/marketplace.json) and Pi packages (package.json → pi.skills).npx @cmo-so/skills agents lists the 20 agents the installer knows and the folders it writes. Agents that share .agents/skills (Codex, Pi, Cursor, Gemini CLI, OpenCode, Copilot, Amp, Cline) get one copy.- The full index, with categories, channels, funnel stage, tier and the MCP tools each skill uses, is in
skills.json. Setup guides: https://ai.cmo.so/hot/mcp
Safety
- Changes take two steps: a preview (what will happen and what it costs) and a confirmation you give. The confirmation is bound to that exact action and expires after 10 minutes.
- Your agent only gets the access your CMO.so account has on each website; a read-only team member cannot change anything.
- Text from web pages, search queries and AI answers is treated as data, never as instructions.
- Skills never ask for passwords or API keys in the chat. You can disconnect any agent in your CMO.so account settings under Connected apps.
Credits
The skills are written by AI Marketing OS Ltd. Many adapt ideas from excellent open-source projects: marketing skill collections, social media and SEO tools, analytics, email and publishing platforms, and MCP servers and CLIs for the channels the skills cover. Each skill's References section names its sources, and skills.json pins every source file to a commit with its licence.
THIRD_PARTY_NOTICES.md carries the copyright and licence notice of every MIT, Apache-2.0 or other permissive project a skill adapts.- Projects with no licence, or a copyleft or source-available licence (GPL, AGPL, BUSL and similar), were used for ideas only: no text from them is included. They are listed at the end of the notices.
skills.json → excluded records every source skill we looked at and left out, and why.
This repository is separate from the TOPY AI ai-cmo-skills package (@topy-ai/maggie), which covers building and deploying websites.
Support
[email protected] · Support · Privacy · Terms
License
MIT © AI Marketing OS Ltd
