TOPY.AI · AI COO

---

The AI COO is goal-first. It keeps four standing goals — on time (the scheduler ticks every 5 minutes), no silent failure (every failed run known within 24 hours), approvals flowing (nothing waits on the founder over a day) and less founder time per outcome — and every skill below exists to move one of them.

• Core (topy-ai-coo): connect, the daily operations check, the COO's goals.
• Routines: schedule a new Routine (daily or weekly, off the hour, clear of the others), check every schedule, run a Routine now.
• Incidents: failed runs and safe retries only (a failure on a read with nothing sent or written outside, once a day; permission and token errors go to a person), and what to do when the scheduler itself stops.
• Approvals: what waits on the founder, and fresh one-click links for the ones that waited too long.
• Reporting: the weekly operations report to the founder and the CEO, efficiency, an automation sweep, tool and vendor evaluation.

The operating rules come from running the AI CEO's and AI CFO's Routines in production, and from Maggie Ops' autopilot: every run is recorded, a job runs once per period, retries never repeat something that may already have taken effect, and every Routine ends in a report. Skills never approve a step for the founder (approvals are the founder's own one-click links), never confirm a change for you, and never handle keys or passwords.

Install

npx @topy-ai/coo-skills install                  # this project, for the agents set up here
npx @topy-ai/coo-skills install -g --mcp         # your user, plus the MCP server
npx @topy-ai/coo-skills install --category incidents,approvals
npx @topy-ai/coo-skills list

Claude Code plugins: /plugin marketplace add TOPY-AI-LTD/TOPY-AI-COO-Skills, then /plugin install topy-ai-coo-all@topy-ai-coo. Codex: codex plugin marketplace add TOPY-AI-LTD/TOPY-AI-COO-Skills. Pi: pi install npm:@topy-ai/coo-skills. See the installer README.

Connect TOPY.AI

https://topy.ai/mcp/coo — OAuth with your TOPY.AI account (the same one as the AI CEO and AI CFO). Only the accounts that own the OneMan operation see its Routines and runs.

Client	How
Claude, ChatGPT (web, desktop)	custom connector https://topy.ai/mcp/coo
Claude Code	claude mcp add --transport http topy-coo https://topy.ai/mcp/coo
Codex	codex mcp add topy-coo --url https://topy.ai/mcp/coo
Clients that only start a command	npx -y @topy-ai/coo-mcp after npx @topy-ai/coo-mcp login
Terminal and scripts	npm i -g @topy-ai/coo-cli && coo-cli login; coo-cli health, coo-cli waiting, coo-cli runs

How the skills fit together

topy-coo-connect ─▶ topy-coo-goals
        │
   daily: topy-coo-daily-check ─▶ topy-coo-failed-runs (safe retries) · topy-coo-waiting-approvals
          topy-coo-approval-reminders (17:13)   ·   watchdog alert ─▶ topy-coo-scheduler-down
        │
   weekly: topy-coo-weekly-report ─▶ topy-coo-efficiency · topy-coo-schedule-check
        │
   change: topy-coo-automation-sweep ─▶ topy-coo-schedule-routine ─▶ topy-coo-run-routine
           topy-coo-vendor-evaluation

Try: "Did anything fail last night?", "What's waiting on me?", "Schedule this every Monday morning", "Send the weekly operations report", "The routines stopped"

Packages

Package	What it is
@topy-ai/coo-skills	This installer (Claude Code, Codex, Pi, Cursor, Gemini CLI, …)
@topy-ai/coo-mcp	The COO MCP server as a local stdio server (forwards to https://topy.ai/mcp/coo)
@topy-ai/coo-cli	The AI COO on the command line

Repository structure

plugins/
  topy-ai-coo/               core skills + .mcp.json (Claude Code) and mcp.json (Codex)
  topy-ai-coo-routines/      topy-ai-coo-incidents/   topy-ai-coo-approvals/
  topy-ai-coo-reporting/
  topy-ai-coo-all/           bundle that depends on all five
.claude-plugin/marketplace.json     Claude Code marketplace
.agents/plugins/marketplace.json    Codex marketplace
skills.json                         machine-readable catalogue
packages/skills/                    the @topy-ai/coo-skills installer

The skills are generated from a source catalogue kept next to TOPY.AI's MCP server; the build checks every tool a skill names against the COO server's tool list. Please open an issue rather than editing a SKILL.md.

License

MIT © TOPY AI LTD. Privacy: topy.ai/privacy.

Skills

14 skills in 5 plugins, plus the topy-ai-coo-all bundle. Generated from the source catalogue: please open an issue rather than editing a SKILL.md.

AI COO core (MCP) · topy-ai-coo

Skill	Tier	What it does
topy-coo-connect	core	Connects the founder's AI COO — the TOPY COO MCP server on the same TOPY account as the AI CEO and CFO — and checks that OneMan's Routine scheduler, approval links and Founder email are set up.
topy-coo-daily-check	core	The founder's morning operations check: is the scheduler alive, what failed overnight (safe ones retried once), what waits on the founder — quiet when all is well.
topy-coo-goals	core	The AI COO's four standing goals — Routines run on time, no silent failure, approvals flowing, less founder time per outcome — measured from the scheduler's records, with the status the COO reports to the CEO.

Routines & schedules · topy-ai-coo-routines

Skill	Tier	What it does
topy-coo-run-routine	connected	Runs one Routine now through the scheduler (the same policy gate and approvals as a scheduled run) and reads back where it stopped — for a first try, or to catch up after a fix.
topy-coo-schedule-check	connected	Checks every cofounder's scheduled Routines against the scheduling rules — runs a day, on-the-hour starts, clashes, the daily cap, missing inputs and Routines that never report — and proposes fixes.
topy-coo-schedule-routine	connected	Picks a good schedule for a new Routine — daily or weekly, off the hour, clear of the other Routines, within the daily cap — and checks it before it goes on the scheduler.

Incidents & retries · topy-ai-coo-incidents

Skill	Tier	What it does
topy-coo-failed-runs	connected	Looks at failed Routine runs, reruns once the ones that are safe (failed on a read, nothing sent or written outside, not a permission or token error) and hands the rest to a person with the reason.
topy-coo-scheduler-down	connected	When the Routine scheduler stops ticking (the routine-watchdog email, or the COO's health check says down): confirm it, say what is not running, and walk whoever has server access through the checks — without guessing a fix.

Approvals · topy-ai-coo-approvals

Skill	Tier	What it does
topy-coo-approval-reminders	connected	Sends the founder a fresh one-click approval email for runs waiting longer than a threshold (default 24 hours) — once a day per run, never more.
topy-coo-waiting-approvals	connected	Shows every Routine paused on the founder — what it waits for, what it found so far, since when, when the link expires — so the founder can decide in one sitting.

Reporting & improvement · topy-ai-coo-reporting

Skill	Tier	What it does
topy-coo-automation-sweep	connected	Finds repeated manual work (done three times or more) worth turning into a Routine or a service, drafts the Routine's steps and schedule, and leaves the go-ahead to the founder.
topy-coo-efficiency	connected	Measures how well the Routines run — success rate, retries, cost and failures by cofounder and step — and finds the few changes that would raise reliability or cut founder time.
topy-coo-vendor-evaluation	connected	Compares tools, vendors or contractors on weighted criteria and value for money, and recommends one with the reasons — a method that works with or without TOPY.
topy-coo-weekly-report	connected	The week's operations for the founder (branded email) and the CEO: runs by cofounder, success rate, what fails most, schedule problems and what waits on the founder.