@cmo-so/skills 0.0.0-stage → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI Marketing OS Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,60 @@
-# Temporary Holding Version
+# @cmo-so/skills
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The [CMO.so](https://cmo.so) marketing skills for **Claude Code** and **Codex**: 124 skills for SEO, AI search, content, social, email, paid ads, CRO, analytics and growth, powered by Maggie and the CMO.so MCP server.
+
+Install them into one project, or for your user so every project gets them.
+
+```sh
+npx @cmo-so/skills install                    # all skills, this project (.claude/skills)
+npx @cmo-so/skills install --scope user       # all skills, every project (~/.claude/skills)
+```
+
+## Scopes
+
+| Scope | Claude Code | Codex | Install record |
+|---|---|---|---|
+| `project` (default) | `<project>/.claude/skills` | `<project>/.agents/skills` | `<project>/.cmo-so/skills-install.json` |
+| `user` (`--global`) | `~/.claude/skills` (`CLAUDE_CONFIG_DIR`) | `~/.codex/skills` (`CODEX_HOME`) | `~/.config/cmo-so/skills-install.json` (`CMO_SO_HOME`) |
+
+`--agent auto` (the default) installs for the agents already set up in that scope, or for Claude Code if neither is. Use `--agent claude`, `codex` or `all` to choose. Commit the project's `.claude/skills` (and `.cmo-so/`) to share the skills with your team.
+
+## Pick what you need
+
+```sh
+npx @cmo-so/skills list                                   # every skill, by category
+npx @cmo-so/skills install --category seo,ai-search       # categories (or plugin names like cmo-so-seo)
+npx @cmo-so/skills install cmo-seo-audit cmo-x-growth     # single skills
+```
+
+The 12 core skills (connect, daily check-in, weekly report…) always come along: the other skills hand off to them.
+
+## Connect the MCP server
+
+The core skills run on the CMO.so MCP server, `https://mcp.cmo.so/mcp` (OAuth: sign in to CMO.so, no keys to paste).
+
+```sh
+npx @cmo-so/skills install --mcp      # also adds it to the project's .mcp.json
+npx @cmo-so/skills mcp --scope user   # prints the commands for Claude Code and Codex
+```
+
+Then in Claude Code: `/mcp` → **cmo-so** → **Authenticate**.
+
+## Update and remove
+
+```sh
+npx @cmo-so/skills@latest update                 # this project
+npx @cmo-so/skills@latest update --scope user    # your user
+npx @cmo-so/skills remove cmo-x-growth           # or --all
+npx @cmo-so/skills doctor                        # check an install
+```
+
+`update` brings installed skills to the new version and adds new skills in the categories you chose. Files you edited are kept (you'll see `kept …`); pass `--force` to replace them. `remove` also keeps folders you edited unless you pass `--force`. Every command accepts `--dry-run`.
+
+## Other ways to install
+
+- Claude Code plugins: `/plugin marketplace add AI-Marketing-OS-LTD/cmo-so-skills`, then `/plugin install cmo-so-all@cmo-so`.
+- Any agent that reads `SKILL.md` folders: copy them from [the repository](https://github.com/AI-Marketing-OS-LTD/cmo-so-skills/tree/main/plugins).
+
+## License
+
+MIT © AI Marketing OS Ltd. Third-party notices: `THIRD_PARTY_NOTICES.md`.