Mega-Mind Skills System v1.0

The most powerful skill system for AI coding assistants — 53 Gold Standard skills, 11 agents, 9 workflows.

This is a comprehensive skill-based workflow system that combines the disciplined development workflows of Superpowers with the domain expertise of Virtual Company and Everything-Claude-Code. Upgraded to Gold Standard v1.0 — every skill now meets a rigorous 12-section specification with blocking violations, verification gates, performance/cost models, anti-patterns, and structured examples. It provides structured, reliable behavior for AI coding assistants across the entire software development lifecycle.

Compatible with: Any AI coding agent (Antigravity · GitHub Copilot (VS Code) · Claude Code · Cursor · OpenCode · Codex · pi · and all tools supporting the Agent Skills open standard)

Overview

Mega-Mind v1.0 brings together 53 Gold Standard skills, 11 agent personas, and 9 workflows organized across the full software development lifecycle — from planning through production operations. All skills meet the Gold Standard SKILL.md v1.0 specification with a minimum quality score of 8.5/10.

New in v1.0: Every skill now includes a Blocking Violations table, structured Verification with quality gates, Performance & Cost model selection guide, domain-specific Examples with edge cases, Anti-Patterns tables, and full References/Changelog. See CHANGELOG.md for the complete upgrade details.

The Mega-Mind Orchestrator (1 skill)

The master controller that routes requests and coordinates skill chains:

mega-mind - Primary entry point via /mega-mind command

Core Workflow Skills (9 skills)

Structured development discipline that ensures quality at every step:

brainstorming - Explore approaches before committing
writing-plans - Create detailed implementation plans
executing-plans - Disciplined execution with tracking, including single-flow task mode
test-driven-development - Write tests first, implement second
requesting-code-review - Structured review requests
receiving-code-review - Handle feedback systematically
finishing-a-development-branch - Clean branch management
using-git-worktrees - Parallel development workflows
skill-generator - Create new custom skills

Domain Expert Skills (30 skills)

Specialized expertise for specific technical domains:

Architecture: tech-lead, frontend-architect, backend-architect, infra-architect
Development: code-polisher, migration-upgrader, mobile-architect, legacy-archaeologist, python-patterns
Testing: test-genius, e2e-test-specialist, debugging, eval-harness
DevOps: ci-config-helper, docker-expert, k8s-orchestrator, observability-specialist
Data: data-engineer, data-analyst, ml-engineer, search-vector-architect, database-migrations, regex-vs-llm-structured-text
Security: security-reviewer
Performance: performance-profiler
Documentation: doc-writer
UX: ux-designer
Product: product-manager, workflow-orchestrator

Meta & Learning Skills (12 skills)

Advanced patterns for efficiency and continuous improvement:

continuous-learning-v2 - Instinct extraction and evolution (The Learning Loop)
search-first - Mandatory research and library check before coding
autonomous-loops - Multi-step AI pipeline patterns without intervention
skill-stocktake - Quality audit and library maintenance
cost-aware-llm-pipeline - Model routing and token budget tracking
verification-loop - Scope-aware verification (Tier 1 Surface / Tier 2 Standard / Tier 3 Deep)
iterative-retrieval - Progressive context refinement for subagents
content-hash-cache-pattern - SHA-256 caching for file processing
multi-plan - Collaborative multiple-model planning
multi-execute - Orchestrated multi-model execution and audit
plankton-code-quality - Write-time formatting and linting enforcement
autoresearch-loop - Karpathy-style self-improvement eval loop

Token Optimization & Context (2 skills)

Reduce LLM Token consumption and manage context limits:

rtk - CLI proxy for 60-90% token savings on common dev commands
context-optimizer - Context offloading and session continuity

Agent Personas (11)

Deep-dive specialized personas for complex tasks. Invoked via routing matrix or /mega-mind route:

Development: tech-lead, planner, architect Quality & Testing: code-reviewer, qa-engineer, accessibility-auditor, adversarial-tester Security & Compliance: security-reviewer, data-privacy-officer Operations & Releases: incident-commander, release-manager

Executable Workflows (9)

Pre-defined chains covering the full lifecycle:

Workflow	Purpose
`brainstorm`	Structured exploration
`write-plan`	Create implementation plans
`execute-plan`	Execute with disciplined tracking
`high-complexity-dev`	Multi-agent orchestration
`review`	Structured code review
`debug`	Root cause analysis
`ship`	Merge, deploy, branch cleanup
`incident-response`	Production incident lifecycle
`release`	Versioning, rollout, monitoring

Quick Start

1. Install the CLI

# pip
pip install mmo

# pipx (recommended — isolated, globally available)
pipx install mmo

# uv
uv tool install mmo

# Or run directly without installation
uvx mmo

2. Install the hook prerequisite: `context-mode`

mmo init writes hooks.json files for supported environments. Those hooks call the context-mode CLI, so hook integration will not work unless context-mode is installed first.

Prerequisites: Node.js 18+

npm install -g context-mode
context-mode doctor

If context-mode doctor fails, fix that before relying on the generated hooks.

3. Initialize skills in your project

# From your project root
cd /path/to/your/project

# Standard install (.agent/ only)
uvx mmo init

# Install only for Claude Code (no .agent/)
uvx mmo init --claude

# Install only for GitHub Copilot (no .agent/)
uvx mmo init --copilot

# Install only for OpenCode (no .agent/)
uvx mmo init --opencode

# Install only for Codex (no .agent/)
uvx mmo init --codex

# Install only for pi-coding-agent (no .agent/)
uvx mmo init --pi

# Overwrite an existing installation
uvx mmo init --force
uvx mmo init --copilot --claude --opencode --codex --pi --force

Behavior summary:

mmo init → creates .agent/
mmo init --claude → creates CLAUDE.md and .claude/, not .agent/
mmo init --copilot --claude → creates .github/, CLAUDE.md, and .claude/, not .agent/
Only GitHub Copilot agent personas use the .agent.md suffix

The --claude flag adds:

CLAUDE.md — project rules (mirrors AGENTS.md)
.claude/skills/ — all 53 skills in the Agent Skills standard directory
.claude/commands/ — Mega-Mind workflow files exposed as Claude slash commands
.claude/hooks/hooks.json — context-mode hook integration

The --copilot flag adds a .github/ directory with:

copilot-instructions.md — global instructions loaded automatically
skills/<name>/SKILL.md — all 53 skills available as / slash commands
agents/<name>.agent.md — custom agent personas for VS Code
hooks/hooks.json — context-mode hook integration

The --opencode flag adds:

AGENTS.md and CLAUDE.md at project root
.opencode/skills/ — all skills
.opencode/commands/ — Mega-Mind workflow files exposed as OpenCode slash commands
.opencode/hooks/hooks.json — context-mode hook integration

The --codex flag adds:

AGENTS.md at project root
.codex/skills/ — all skills
.codex/hooks/hooks.json — context-mode hook integration

The --pi flag adds:

AGENTS.md and CLAUDE.md at project root
.pi/skills/ — all 53 skills in pi's project skill directory
.pi/prompts/ — Mega-Mind workflow files exposed as pi prompt templates
.pi/agents/ — agent personas as prompt templates
.pi/shared/ — shared reference docs
.pi/hooks/hooks.json — context-mode hook integration
.agents/skills/ — cross-tool Agent Skills standard path (pi scans this)

The generated hooks.json files call commands such as:

{
  "command": "context-mode hook claude-code pretooluse"
}

If context-mode is not installed and available on your PATH, those hooks will fail.

📖 For full details see USAGE.md

4. Verify the installation

Once initialized:

Run context-mode doctor to verify the hook dependency is installed correctly
Use the /verify command (triggered by the verification-loop skill) to ensure the Mega-Mind files are correctly installed

📖 For full installation details see USAGE.md

Using Mega-Mind

The `/mega-mind` Command

The /mega-mind command is your primary entry point to the skill system. It acts as an intelligent orchestrator that:

Analyzes your request to understand intent
Routes to the appropriate skill(s)
Coordinates skill chains for complex tasks
Tracks progress throughout

Available Commands

/mega-mind status             - Show current session state
/mega-mind skills             - List all available skills
/mega-mind workflows          - List available workflows
/mega-mind route <request>    - Analyze and route a request
/mega-mind execute <workflow> - Execute a named workflow
/mega-mind help               - Show help message

Direct Skill Commands

Command	Skill	Purpose
`/brainstorm`	brainstorming	Explore approaches before deciding
`/plan`	writing-plans	Create implementation plan
`/execute`	executing-plans	Execute plan with tracking
`/debug`	debugging	Debug systematically
`/review`	requesting-code-review	Request code review
`/ship`	finishing-a-development-branch	Deploy to production
`/tdd`	test-driven-development	Test-first development
`/verify`	verification-loop	Verify before marking done

Example Usage

User: /mega-mind I need to add user authentication with OAuth

🧠 Mega-Mind Orchestration
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 Request Analyzed: New feature - User Authentication with OAuth

🔄 Routed to skill chain:
   1. tech-lead                        → Define architecture
   2. brainstorming                    → Explore OAuth providers
   3. backend-architect                → Design auth API
   4. writing-plans                    → Create implementation plan
   5. test-driven-development          → Write auth tests
   6. backend-architect                → Implement auth service
   7. frontend-architect               → Implement login UI
   8. security-reviewer                → Security audit
   9. verification-loop                → Verify

📍 Starting with: tech-lead

File Structure

mega-mind-skills/
├── README.md                    # Main documentation (this file)
├── USAGE.md                     # Installation guide
├── CHANGELOG.md                 # Release history
├── pyproject.toml               # Python package config
│
├── scripts/
│   ├── validate-skill-system.py # Skill system validator
│   ├── sync-assets.py           # Syncs .agent/ → src/mega_mind/assets/
│   ├── backup-task-state.sh     # Timestamped task.md backups
│   └── fix-*.py                 # Portability & normalization fixers
│
├── src/mega_mind/
│   ├── cli.py                   # CLI entry point (mmo init)
│   ├── installer.py             # Multi-platform installer
│   └── assets/                  # Distribution copies of .agent/
│
└── .agent/
    ├── AGENTS.md                # Master contract and rules
    ├── hooks/
    │   └── hooks.json           # context-mode hooks registry
    ├── instincts/               # Learned patterns & observations
    ├── skills/                  # 53 SKILL.md files (one per skill)
    ├── shared/                  # DE-SLOPPIFY.md, RTK_GUIDE.md, VERIFICATION-GATE.md
    │
    ├── workflows/               # 9 executable workflow chains
    │   ├── brainstorm.md        # Structured exploration
    │   ├── write-plan.md        # Implementation planning
    │   ├── execute-plan.md      # Disciplined execution
    │   ├── high-complexity-dev.md # Multi-agent orchestration
    │   ├── review.md            # Code review
    │   ├── debug.md             # Root cause analysis
    │   ├── ship.md              # Merge and deploy
    │   ├── incident-response.md # Production incidents
    │   └── release.md           # Versioning and rollout
    │
    └── agents/                  # 11 specialized agent personas
        ├── architect.md         # System design and ADRs
        ├── planner.md           # Task decomposition
        ├── tech-lead.md         # Technical leadership
        ├── code-reviewer.md     # Code quality review
        ├── qa-engineer.md       # Testing and verification
        ├── security-reviewer.md # Security vulnerability audit
        ├── accessibility-auditor.md  # WCAG compliance
        ├── adversarial-tester.md     # Chaos and fuzz testing
        ├── data-privacy-officer.md   # GDPR/CCPA/SOC2
        ├── incident-commander.md     # Incident response
        └── release-manager.md        # Release coordination

Full Routing Matrix

The complete routing matrix with all 53 skills, 11 agents, and 7 categories (Architecture & Design, Development, Testing & Quality, Debugging & Fixing, DevOps & Infrastructure, Data & AI, Documentation & UX, Meta & Learning, Compliance & Privacy) is defined in .agent/skills/mega-mind/SKILL.md. Use /mega-mind route <request> to let the orchestrator dispatch automatically.

Workflows

Standard Development Chain (The Z-Pattern)

search-first → tech-lead → brainstorming → writing-plans → test-driven-development →
executing-plans → verification-loop → requesting-code-review →
finishing-a-development-branch → continuous-learning-v2

High-Complexity Chain (Phase 3 Orchestration)

search-first → architect → multi-plan → [Approval] → multi-execute →
verification-loop → security-reviewer → finishing-a-development-branch

Autonomous Loop Chain

writing-plans → autonomous-loops → [Loop Execution] → verification-loop →
continuous-learning-v2

Incident Response Chain

incident-commander → [Mitigation] → debugging → test-driven-development →
verification-loop → finishing-a-development-branch

Release Chain

release-manager → verification-loop → finishing-a-development-branch →
observability-specialist → continuous-learning-v2

Bug Fix

debugging → test-driven-development →
verification-loop → finishing-a-development-branch → continuous-learning-v2

Accessibility Audit Chain

accessibility-auditor → [Fixes] → verification-loop → requesting-code-review →
finishing-a-development-branch

Adversarial Test Chain

adversarial-tester → [Chaos/Fuzz] → debugging → executing-plans →
verification-loop → finishing-a-development-branch

Key Concepts

Task Tracking

All tasks are tracked in <project-root>/docs/plans/task.md:

Task ID	Description	Status	Priority	Dependencies
1	Example task	pending	high	-

Status values: pending, in_progress, completed, blocked

Verification Before Completion

Never mark a task as complete without:

Running tests
Running linting
Building successfully
Manual verification
Checking for regressions

Execution Model

Session loads .agent/AGENTS.md rules
/mega-mind analyzes and routes requests
Design work flows through brainstorming → planning → execution
All work tracked in task tracker
Nothing marked done without verification

RTK Token Optimization

When RTK is installed, CLI commands are automatically optimized:

Original	RTK-Optimized	Savings
`git log`	`rtk git log`	85%
`cargo test`	`rtk cargo test`	90%
`npm test`	`rtk npm test`	90%
`pytest`	`rtk pytest`	90%

Install RTK:

cargo install rtk
# or
curl -sSL https://github.com/rtk-ai/rtk/releases/latest/download/rtk-$(uname -s)-$(uname -m) -o /usr/local/bin/rtk
chmod +x /usr/local/bin/rtk

Installation

See USAGE.md for the full installation guide.

CLI Reference

# Install skills into current directory (.agent/ only when no platform flags are used)
uvx mmo init

# Also install for GitHub Copilot (VS Code)
uvx mmo init --copilot

# Also install for Claude Code
uvx mmo init --claude

# Also install for OpenCode
uvx mmo init --opencode

# Also install for Codex
uvx mmo init --codex

# Also install for pi-coding-agent
uvx mmo init --pi

# Install into a specific path
uvx mmo init /path/to/project
uvx mmo init /path/to/project --copilot

# Overwrite existing installation
uvx mmo init --force
uvx mmo init --copilot --claude --opencode --codex --pi --force

# Show CLI version
uvx mmo --version

Hook prerequisite

The installer writes hooks.json files for .agent/, .github/, .claude/, .opencode/, and .codex/. Those hooks invoke context-mode, so install it first:

npm install -g context-mode
context-mode doctor

If context-mode is missing from your PATH, the installed hooks will not work.

Validate Installation

Use the internal /verify command within your AI assistant to run the verification protocol.

Tests verify:

Core workflow skills existence
Domain expert skills existence
Workflows existence
Agent profiles existence
AGENTS.md validation
Skill frontmatter validation

Contributing

To add new skills:

Create a new directory in .agent/skills/

Add a SKILL.md file with proper frontmatter:

---
name: skill-name
description: What this skill does
triggers:
  - "/trigger"
  - "keyword"
---

Include instructions and examples
Run tests to verify

Credits

This project combines and adapts:

Superpowers by obra - Core workflow philosophy
antigravity-superpowers by skainguyen1412 - Antigravity adaptation
virtual-company by k1lgor - Domain expertise skills
Everything-Claude-Code by affaan-m - Claude Code adaptation
RTK - Token optimization CLI

License

MIT License - Free to use and modify.

Name		Name	Last commit message	Last commit date
Latest commit History 46 Commits
.agent		.agent
.github/workflows		.github/workflows
docs-site		docs-site
scripts		scripts
src/mega_mind		src/mega_mind
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
README.md		README.md
USAGE.md		USAGE.md
mkdocs.yml		mkdocs.yml
pyproject.toml		pyproject.toml

Folders and files

Latest commit

History

Repository files navigation