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.

@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):

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

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:

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

156 skills in 14 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

Strategy & research · cmo-so-strategy

SEO · cmo-so-seo

AI search (GEO / AEO) · cmo-so-ai-search

Content & copy · cmo-so-content

Social & community · cmo-so-social

Email & lifecycle · cmo-so-email

Paid ads · cmo-so-paid-ads

Conversion (CRO) · cmo-so-cro

Analytics & reporting · cmo-so-analytics

Growth & go-to-market · cmo-so-growth

Sales & revenue · cmo-so-sales

Images & video · cmo-so-creative

Website (WordPress) · cmo-so-website

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.

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