Skip to content
Maestria

Maestria Skills for Codex CLI

Install one provisional plugin to make Maestria specialists, orchestration, handoffs, and review contracts available as Codex skills.
Get StartedView Core Methodology

@maestria/codex is a provisional projection of the canonical Maestria directives. It packages the 7 specialists, orchestrator, global rules, handoff and iteration-limit contracts, and the fein/sonar/blitz workflow modes as namespaced Codex skills.

Install

Section titled “Install”

The Maestria CLI is the supported convenience path for the published npm package:

Terminal window
npx maestria install codex

The CLI stages @maestria/codex in a local marketplace under ~/.cache/maestria/, then uses Codex’s native codex plugin add command. Check, update, and remove it with:

Terminal window
npx maestria status
npx maestria update codex
npx maestria uninstall codex

Installation and verification →

What It Provides

Section titled “What It Provides”
  • $maestria:adventurer, $maestria:architect, $maestria:builder, $maestria:diagnose, $maestria:planner, $maestria:reviewer, and $maestria:writer
  • $maestria:orchestrator for capability-aware routing
  • $maestria:global-rules for the universal evidence, safety, authorization, and review contract
  • $maestria:handoff and $maestria:iteration-limits for bounded multi-stage work
  • $maestria:fein, $maestria:sonar, and $maestria:blitz as workflow-mode skills

The read-only specialist boundaries are documented guidance. Codex’s own sandbox, approvals, and hook trust model remain the runtime boundary.

Explore the Docs

Section titled “Explore the Docs”
Getting StartedInstall the npm package through Maestria, validate the projection, and verify skill discovery.
Quick StartUse the orchestrator and specialist skills on a real Codex CLI task.
ContributingUnderstand the generated skill projection and sync pipeline.
ChangelogRelease history and support-boundary changes.