antigravity-superpowers

Superpowers for Google Antigravity — a complete development workflow powered by composable skills, workflows, and rules.

This repo ports the Superpowers skills library to work natively with Google Antigravity agent, with Antigravity-compatible path conventions, an auto-update workflow, and curated workflow files translated from the upstream skills.

Quick Start

Option 1 — npx (recommended, no install needed)

Inside any project directory:

npx agy-superpowers@latest init

This scaffolds .agent/ with all Superpowers skills, workflows, and rules.
Open the project with Google Antigravity — Superpowers activates automatically.

To overwrite an existing .agent/:

npx agy-superpowers@latest init --force

Option 2 — Global install

npm install -g agy-superpowers
agy-superpowers init

What's Inside

.agent/
├── rules/
│   └── superpowers.md          # Always-on rule: agent checks skills before acting
├── skills/                     # 58 skills (14 upstream + 44 expansion skills)
│   ├── brainstorming/
│   ├── writing-plans/
│   ├── executing-plans/
│   ├── backend-developer/
│   ├── frontend-developer/
│   ├── mobile-developer/
│   ├── growth-hacker/
│   ├── monetization-strategist/
│   └── ...                     # + 48 more skills
├── workflows/
│   ├── brainstorm.md           # /brainstorm
│   ├── write-plan.md           # /write-plan
│   ├── execute-plan.md         # /execute-plan
│   ├── code-review.md          # /code-review
│   ├── debug.md                # /debug
│   ├── publish.md              # /publish
│   └── update-superpowers.md   # /update-superpowers
├── patches/
│   └── skills-patches.md       # AI-driven skill patches (see below)
└── .shared/
    └── update-superpowers.sh   # Shell script for version management

How It Works

Antigravity automatically reads skills before every response. You don't need to invoke them manually — the superpowers.md rule (set to alwaysApply: true) instructs the agent to check for a relevant skill before acting.

The Core Development Loop

💡 Idea → /brainstorm → /write-plan → /execute-plan → /code-review → merge

Additional Workflows

Usage Guide

Getting Started in 5 Minutes

How it works: Superpowers gives your agent 58 specialized skills. You don't need to remember or invoke them — the agent automatically reads and selects the right skill based on what you ask. Just describe what you need in natural language.

Your First Feature: A Walkthrough

Let's say you want to add dark mode to your React app. Here's what the full cycle looks like:

That's it. Five steps from idea to merge-ready code.

Quick Reference: The 5 Commands You'll Use Most

Beyond Code — Skills That Work For You

The agent doesn't just write code — it has specialized knowledge in marketing, pricing, security, legal, and more. When you mention a topic, the relevant skill activates automatically.

🔧 Development Workflow

These are triggered via slash commands or activate automatically during the dev loop:

💻 Technical Skills

Activate when you work on specific technical domains:

Example prompt: "Design a REST API for user management with rate limiting and pagination" → activates api-design + backend-developer

🎨 Product & Design

Example prompt: "Help me prioritize features for the next sprint based on user feedback" → activates product-manager

📈 Marketing & Growth

Example prompt: "Write an ASO-optimized App Store description for my meditation app" → activates app-store-optimizer + copywriter

💰 Revenue & Operations

Example prompt: "Should I charge $9/mo or $29/mo for my SaaS? Here's my target audience..." → activates pricing-psychologist + monetization-strategist

🚀 Validate & Scale

Example prompt: "I have an idea for an AI writing tool — is it worth building?" → activates idea-validator + market-researcher

Power User Tips

When to /brainstorm vs Just Ask

Rule of thumb: if it touches more than one file or involves design tradeoffs → /brainstorm.

How to Write Better Prompts

• Provide context — mention your tech stack, project name, and constraints: "In my Next.js app with Supabase auth..."
• State goals, not solutions — "Users drop off during signup" gives the agent room to find the best fix, vs "Add a progress bar to the signup form"
• Mention specific domains to activate the right skills — "Review the security of my auth flow" triggers security-engineer, "Optimize the SEO for my landing page" triggers seo-specialist

Combining Workflows for Complex Projects

Full product launch cycle:

/brainstorm → /write-plan → /execute-plan → /code-review
    ↓ then in separate conversations:
    "Write marketing copy for..." → copywriter skill
    "Optimize my App Store listing..." → ASO skill
    "Design a pricing strategy..." → pricing skill

Idea → Validation → Build:

"I have an idea for X, is it viable?" → idea-validator
"Research the market for X" → market-researcher
/brainstorm → /write-plan → /execute-plan → build it

Debugging effectively:

/debug → systematic investigation
    ↓ if architectural issue found:
/brainstorm → redesign the component

Configuration

Per-project settings (like auto_commit) live in .agent/config.yml — see Configuration for details.

Common Pitfalls

AI-Driven Skill Patching

Skills are sourced from upstream Superpowers but automatically patched to be Antigravity-native. The patching system uses a human-readable spec at .agent/patches/skills-patches.md which the AI interprets semantically — making patches resilient to upstream changes.

When you run /update-superpowers, skills are:

1. Copied fresh from superpowers/skills/
2. Patched via AI to remove non-Antigravity references
3. Ready to use immediately

Skills Reference

The Indie Hacker Journey

44 expansion skills cover the full indie hacker lifecycle — from first idea to sustainable business:

• Validate: idea-validator, market-researcher
• Design: product-manager, ux-designer, cto-architect
• Build: backend-developer, frontend-developer, frontend-design, mobile-developer, mobile-uiux-promax, game-developer, game-design, chrome-extension-developer, api-design, real-time-features, auth-and-identity, email-infrastructure, saas-architect, devops-engineer, security-engineer, i18n-localization, ai-integrated-product, micro-saas-builder
• Launch: launch-strategist, landing-page-builder, app-store-optimizer, copywriter
• Grow: growth-hacker, content-marketer, seo-specialist, conversion-optimizer, community-manager, influencer-marketer, paid-acquisition-specialist, retention-specialist
• Revenue: monetization-strategist, pricing-psychologist, subscription-billing, bootstrapper-finance
• Operate: solo-founder-ops, analytics-setup, customer-success-manager, data-analyst, indie-legal

Keeping Up to Date

Upstream Superpowers releases are tracked automatically. To update:

/update-superpowers

This workflow will:

1. Pull the latest Superpowers release from GitHub
2. Copy fresh skills from upstream
3. AI-rewrite any changed workflows and rules to stay Antigravity-compatible
4. Apply skill patches via .agent/patches/skills-patches.md
5. Commit all changes with a versioned commit message

Configuration

Per-project settings live in .agent/config.yml. Create or edit this file in your project's .agent/ folder:

# .agent/config.yml

# auto_commit: true | false
# When true (default), Superpowers skills automatically commit after completing
# tasks and writing design docs.
# When false, all git commits and staging are skipped — files are left as
# modified for you to commit manually.
auto_commit: true

This file is preserved across /update-superpowers runs.

Installation

Using This Repo in Your Project

The recommended way is npx (see Quick Start above). Alternatively, clone and copy:

git clone https://github.com/bonnguyenitc/antigravity-superpowers
cp -r antigravity-superpowers/.agent /your/project/

Philosophy

This setup enforces four core principles across every task:

• Test-Driven Development — Write the failing test first, always
• YAGNI — Don't build what isn't needed yet
• Systematic over ad-hoc — Follow the skill process, don't guess
• Evidence over claims — Verify before declaring success

Credits

This project stands on the shoulders of many great open-source projects. A huge thank you to all of them! 🙏

🏗️ Skill Sources

Content from these repos was ported, adapted, and integrated into the skills library:

Antigravity integration, workflow adaptation & 44 expansion skills (UI/UX intelligence databases, mobile design system) by @bonnguyenitc.

License

MIT — see LICENSE for details.