oh-my-antigravity

The Ultimate Agentic Toolkit for Google Gemini Antigravity.

Ported from oh-my-claudecode with ❤️

Give your Antigravity agent the collective intelligence of the "Oh My" ecosystem with 73 specialized Skills and 35 automated Workflows.

📦 NPM Package: oh-my-oma
⚡ Quick Install: npm install -g oh-my-oma

✅ Migration Status: Complete - Antigravity-ready ✅
📊 Compatibility: 73/73 Skills ✅ | 35/35 Workflows ✅ | 0 Issues
📖 See: Migration Status Report | Migration Plan

✅ Migration Complete

This project is fully migrated to Google Antigravity:

• ✅ Skills & Workflows: All content reviewed for Antigravity compatibility
• ✅ Hooks Replacement: Legacy hooks converted to Workflows + GEMINI.md rules
• ✅ Installation Scripts: Use ~/.gemini/antigravity/ paths

✨ What is oh-my-antigravity?

oh-my-antigravity is a comprehensive collection of AI agent "personas" (Skills) and automated procedures (Workflows) designed to supercharge your development workflow with Google's Antigravity AI coding assistant.

Think of it as:

• 🧠 Skills = Expert personas your agent can embody (architect, security-reviewer, scientist...)
• ⚡️ Workflows = Slash commands that trigger automated procedures (/autopilot, /swarm, /ultrawork...)

🚀 Features

🧠 73 Specialized Skills

| Category | Skills | Description | |----------|--------|-------------| | Architecture | architect, architect-medium, architect-low, planner, analyst | System design & strategic planning | | Execution | executor, executor-high, executor-low, autopilot, ultrapilot | Code implementation & task execution | | Quality | critic, code-reviewer, security-reviewer, aireview ⭐ | Code review & security auditing | | Research | scientist, researcher, deepsearch, explore, analyze | Deep analysis & investigation | | Testing | tdd-guide, qa-tester, ultraqa, build-fixer | Test-driven development & QA | | Design | designer, frontend-ui-ux, vision | UI/UX design & visual analysis | | Specialized | git-master, writer, writer-memory, learner | Git operations, documentation, memory |

⚡️ 35 Workflows

| Workflow | Description | |----------|-------------| | /autopilot | Full autonomous execution from idea to working code | | /ultrawork | Maximum performance mode with parallel agent orchestration | | /swarm | N coordinated agents on shared task list with atomic claiming | | /ultrapilot | Parallel autopilot with file ownership partitioning | | /pipeline | Sequential agent chaining with data passing between stages | | /aireview ⭐ | Multi-agent AI code review with confidence scoring | | /start-dev ⭐ | Intelligent adaptive workflow with pattern library loading | | /ralph | Self-referential loop until task completion | | /research | Orchestrate parallel scientist agents for research | | /tdd | Test-Driven Development enforcement workflow | | /doctor | Diagnose environment and verify required tools | | /mcp-setup | Configure popular MCP servers for enhanced capabilities | | /help | Guide on using oh-my-antigravity |

📦 Installation

Recommended (NPM Global Install)

# Install CLI globally
npm install -g oh-my-oma

# Install skills/workflows to user scope (~/.gemini/antigravity/*)
oh-my-oma setup --scope user

# Install to a specific project (<project>/.agent/*)
oh-my-oma setup --scope project-local --target /path/to/your/project

Diagnostics and verification:

oh-my-oma doctor
oh-my-oma verify

Option 1: Local Installation (Per Project)

Copy the .agent directory to your project:

# Clone the repository
git clone https://github.com/YourUsername/oh-my-antigravity.git

# Navigate to the repository
cd oh-my-antigravity

# Optional: install CLI from local checkout
npm install -g .

# Run the installer (installs to current directory by default)
./install.sh /path/to/your/project

Option 2: Global Installation (All Projects)

Install globally so all projects can access the skills and workflows:

# Run the global installer
./install_global.sh

This installs to:

• Skills → ~/.gemini/antigravity/skills/
• Workflows (canonical) → ~/.gemini/antigravity/global_workflows/
• Workflows (compat discovery links) → ~/.agent/workflows/, ~/.agents/workflows/, ~/_agent/workflows/, ~/_agents/workflows/

Installation Validation

Validate install and governance/sync baseline in one command:

oh-my-oma verify

Quick diagnostics:

oh-my-oma doctor

🎮 Usage

Using Skills

Just ask naturally! Skills are automatically recognized:

"Act as an architect and design a microservices system."
"Run a security review on this file."
"Deepsearch the root cause of this bug."
"Be a frontend-ui-ux expert and improve this component."

Using Workflows

Trigger workflows with slash commands:

### Rules (GEMINI.md)

Add project rules in `GEMINI.md` and global rules in `~/.gemini/antigravity/GEMINI.md`.
/autopilot Build a REST API for user authentication
/ultrawork Implement all pending features in parallel
/aireview Review the last 5 commits
/doctor Check if my environment is set up correctly
/help Show me all available commands

📖 Documentation

| Document | Description | |----------|-------------| | FEATURES.md | Complete feature documentation | | ARCHITECTURE.md | System architecture overview | | REFERENCE.md | API and command reference | | COMPATIBILITY.md | Compatibility information |

🔧 Requirements

• Google Antigravity (Gemini-powered AI coding assistant)
• CLI Tools (recommended for enhanced functionality):
  • fd - Fast file finder
  • rg (ripgrep) - Fast text search
  • sg (ast-grep) - Structural code search

Run /doctor to verify your environment setup.

🛡️ Skill Governance

This repository includes a governance policy and checker for Skills + Workflows in Antigravity IDE:

• Policy: docs/SKILL_GOVERNANCE.md
• Checker: scripts/check-skill-governance.sh
• Debt allowlist: .governance/skill-lint.allowlist

Run governance check:

bash scripts/check-skill-governance.sh

Generate and verify catalog baseline:

node scripts/generate-catalog-docs.js
node scripts/generate-catalog-docs.js --verify

Sync and verify metadata/counts:

node scripts/sync-metadata.js
node scripts/sync-metadata.js --verify

One-shot full verification:

bash scripts/verify-repo.sh

📌 Governance Status (2026-02-06)

• Governance check result: 0 issues, 0 allowlisted debt
• Runtime-incompatible task syntax removed from active skills/workflows
• Deprecated migration in place:
  • learn-about-omc (deprecated) -> learn-about-oma (canonical)

🤝 Contributing

Contributions are welcome! Feel free to:

1. Fork the repository
2. Create a feature branch
3. Submit a Pull Request

📄 License

MIT License - See LICENSE for details.

🙏 Credits

Special thanks to:

• oh-my-claudecode - The original project that inspired this work
• oh-my-opencode - The OpenCode scaffold adaptation in the same ecosystem
• everything-claude-code - Legacy Claude Code resources (historical reference)