Skills Project

This repository now contains both:

• the source multi-role-orchestrator skill
• a local mr CLI that scaffolds workspace-scoped Codex skills and compatibility wrappers

Included Skill

• multi-role-orchestrator: a virtual team skill with role ownership, persona mapping, handoff templates, structured role outputs, and a simplified command interface. The default workflow is artifact-driven: PRD -> prototype -> architecture -> implementation -> self-test -> QA -> acceptance.

npm Package

The publishable npm package name is codex-mr.

CLI

The repo exposes a local mr command through package.json:

node ./bin/mr.js init

Or after linking:

npm link
mr init

After publishing, new machines can use:

npm install codex-mr
npx mr init

or:

npm install -g codex-mr
mr init

mr init creates:

• .codex/skills/multi-role-orchestrator/
• .codex/skills/mr/
• .codex/skills/mr-status/
• .codex/skills/mr-next/
• .codex/skills/mr-handoff/
• plugins/mr-orchestrator/.codex-plugin/plugin.json
• plugins/mr-orchestrator/commands/
• plugins/mr-orchestrator/skills/multi-role-orchestrator/
• .agents/plugins/marketplace.json

That lets a project use workspace-local Codex skill entrypoints such as:

• $mr <task>
• $mr-status
• $mr-next
• $mr-handoff

The primary install path is .codex/skills, matching how this repository exposes the openspec-* skills today.

The generated plugin and marketplace files remain as compatibility output for Codex builds that also support workspace-local plugins or command wrappers.

By default, mr init installs the default full feature set with no prompts.

Key Files

• multi-role-orchestrator/SKILL.md
• multi-role-orchestrator/commands.md
• multi-role-orchestrator/quick-reference.md
• multi-role-orchestrator/delivery-workflow.md
• multi-role-orchestrator/page-workflow.md
• multi-role-orchestrator/INSTALL.md
• bin/mr.js
• src/init-workspace.js

Notes

• $mr* entries are Codex skill invocations, not shell subcommands.
• mr init is the shell entry that installs the workspace skill structure into the current workspace.
• plugins/mr-orchestrator is now a secondary compatibility layer, not the primary registration path.