antigravity-superpowers/README.md

antigravity-superpowers

Bring the power of Superpowers to Antigravity.

---

Superpowers is an incredible skill-based workflow system that gives AI coding assistants structured, reliable behavior — brainstorming, planning, test-driven development, code review, debugging, and more. It was originally designed for Claude Code, but the workflows themselves are platform-agnostic gold.

This project ports that entire system to Antigravity, preserving the original flow as faithfully as possible. The goal is not to reinvent Superpowers — it's to make them available on Antigravity with the minimal set of changes needed for native compatibility. If you've used Superpowers before, everything should feel familiar. If you haven't, this is a great way to start.

One command. Full profile. Ready to go.

git clone https://git.visssoft.com/hanh.tonguyen/antigravity-superpowers.git
cd antigravity-superpowers
sudo npm link                # cách A: link global
antigravity-superpowers init

# hoặc chạy trực tiếp (không cần install)
node bin/antigravity-superpowers.js init

---

What's New in v0.3.0

Feature	Description
9 slash commands	/brainstorm, /write-plan, /execute-plan, /debug, /tdd, /review, /verify, /finish-branch, /worktree
Workflow format fix	Fixed workflow frontmatter to follow Antigravity convention (no name: field, numbered steps)
add-azure-skills	Integrate 192 Microsoft Azure skills with curated bundles
validate command	Run automated checks on your .agent profile (files, skills, workflows, frontmatter, legacy patterns, AGENTS mapping)
list command	List all 13 bundled skills with names and descriptions
--version / -v	Show CLI version
--dry-run / -n	Preview files that would be copied without making changes
--backup / -b	Backup existing .agent to .agent-backup-<timestamp> before overwrite
20 automated tests	Expanded from 3 to 20 tests covering CLI, init, and validate

---

Installation

Install from source

git clone https://git.visssoft.com/hanh.tonguyen/antigravity-superpowers.git
cd antigravity-superpowers

Cách A: Link global (cần sudo)

sudo npm link

Sau đó dùng ở bất kỳ đâu:

antigravity-superpowers --version
antigravity-superpowers init

Cách B: Chạy trực tiếp bằng node (không cần sudo)

node bin/antigravity-superpowers.js --version
node bin/antigravity-superpowers.js init /path/to/your/project

Cách B không cần cài đặt, chạy được ngay. Thay antigravity-superpowers bằng node bin/antigravity-superpowers.js trong tất cả lệnh bên dưới.

Update to latest version

# 1. Pull source mới
cd antigravity-superpowers
git pull

# 2. (Chỉ nếu dùng cách A) Link lại
sudo npm link

# 3. Update profile tại project đã init — giữ backup bản cũ
antigravity-superpowers init --force --backup /path/to/your/project
# hoặc
node bin/antigravity-superpowers.js init --force --backup /path/to/your/project

# 4. Kiểm tra profile sau update
antigravity-superpowers validate /path/to/your/project

Bản cũ được giữ lại tại .agent-backup-<timestamp>. Nếu cần rollback:

rm -rf .agent
mv .agent-backup-<timestamp> .agent

Install from npm (when published)

Package chưa được publish lên npm. Các lệnh dưới đây sẽ hoạt động sau khi publish.

# Run directly (no install)
npx antigravity-superpowers init

# Or install globally
npm install -g antigravity-superpowers

---

Usage

1. Initialize a project

# Initialize in current directory
antigravity-superpowers init

# Initialize in a specific project
antigravity-superpowers init /path/to/project

This copies the complete .agent profile (13 skills, 9 workflows/slash commands, validation tests) into your project root.

2. Validate the profile

antigravity-superpowers validate

Runs 78 checks: required files, all 13 skills present, frontmatter validity, no legacy patterns, AGENTS mapping contract.

3. List available skills

antigravity-superpowers list

Output:

Antigravity Superpowers — 13 skills available:

  brainstorming                    You MUST use this before any creative work...
  executing-plans                  Use when you have a written implementation plan...
  finishing-a-development-branch   Use when implementation is complete, all tests pass...
  receiving-code-review            Use when receiving code review feedback...
  requesting-code-review           Use when completing tasks, implementing major features...
  single-flow-task-execution       Use when executing implementation plans...
  systematic-debugging             Use when encountering any bug, test failure...
  test-driven-development          Use when implementing any feature or bugfix...
  using-git-worktrees              Use when starting feature work that needs isolation...
  using-superpowers                Use when starting any conversation...
  verification-before-completion   Use when about to claim work is complete...
  writing-plans                    Use when you have a spec or requirements...
  writing-skills                   Use when creating new skills, editing existing skills...

4. Preview before copying (dry run)

antigravity-superpowers init --dry-run

Shows all 49 files that would be copied, without making any changes.

5. Update an existing profile

# Replace .agent with latest version
antigravity-superpowers init --force

# Or backup first, then replace
antigravity-superpowers init --force --backup

With --backup, the existing .agent is renamed to .agent-backup-2026-03-19T10-30-00 before the new profile is copied.

6. Add Microsoft Azure skills

Tích hợp 192 Azure skills từ Microsoft Agent-Skills vào project. Các skills này cung cấp tra cứu tài liệu Azure chính thức (troubleshooting, best practices, architecture, security...).

# Xem các bundle có sẵn
antigravity-superpowers add-azure-skills --list-bundles

# Cài bundle quick-start (8 skills cơ bản)
antigravity-superpowers add-azure-skills --bundle quick-start

# Cài bundle popular (21 skills phổ biến)
antigravity-superpowers add-azure-skills --bundle popular

# Cài từng skill riêng lẻ
antigravity-superpowers add-azure-skills --skill azure-functions --skill azure-cosmos-db

# Kết hợp bundle + skill riêng
antigravity-superpowers add-azure-skills --bundle ai-ml --skill azure-container-apps

# Xem toàn bộ 192 skills có sẵn
antigravity-superpowers add-azure-skills --list-skills

Bundles có sẵn:

Bundle	Skills	Mô tả
quick-start	8	App Service, Functions, Blob Storage, SQL, Key Vault, Monitor...
popular	21	Các dịch vụ phổ biến nhất: Cosmos DB, AKS, Container Apps, Logic Apps...
ai-ml	8	AI Services, AI Vision, Bot Service, Machine Learning, Foundry...
devops	8	DevOps, Pipelines, Repos, Boards, Artifacts, Automation...
security	8	Key Vault, RBAC, Policy, Sentinel, Defender, Firewall...

---

CLI Reference

antigravity-superpowers <command> [options]

Commands:
  init [dir]               Initialize .agent profile in a project
  validate [dir]           Validate .agent profile in a project
  list                     List bundled skills
  add-azure-skills [opts]  Add Microsoft Azure skills to a project

Init options:
  -f, --force      Overwrite existing .agent directory
  -b, --backup     Backup existing .agent before overwrite (use with --force)
  -n, --dry-run    Preview files that would be copied

Azure skills options:
  -B, --bundle <name>    Install a bundle (quick-start, popular, ai-ml, devops, security)
  -s, --skill <name>     Install individual skill (repeatable)
  --list-bundles          List available bundles
  --list-skills           List all 192 Azure skills
  --refresh               Re-download skill repository

Global options:
  -v, --version    Show version
  -h, --help       Show help

---

What's Included

13 skills covering the full development lifecycle:

Skill	Description
brainstorming	Structured exploration before committing to an approach
writing-plans	Detailed, step-by-step implementation plans
executing-plans	Disciplined plan execution with progress tracking
single-flow-task-execution	Ordered task decomposition with review gates (new)
test-driven-development	Write tests first, implement second
systematic-debugging	Root cause tracing with supporting techniques
requesting-code-review	Structured review flow with checklists
receiving-code-review	Handling feedback systematically
verification-before-completion	Prove it works before claiming it's done
finishing-a-development-branch	Clean branch wrap-up with workflow options
using-git-worktrees	Parallel branch management
using-superpowers	Skill routing and session bootstrap
writing-skills	Create new skills that follow the system's conventions

9 slash commands (workflows) — type / in Antigravity chat to invoke:

Command	Action
/brainstorm	Explore ideas before creative work
/write-plan	Create detailed implementation plan
/execute-plan	Execute plan step by step
/debug	Systematic debugging workflow
/tdd	Test-driven development
/review	Request structured code review
/verify	Verify work before claiming done
/finish-branch	Clean branch wrap-up
/worktree	Create isolated git worktree

Plus supporting infrastructure: 1 reviewer agent, validation tests, and an AGENTS.md contract that ties it all together.

---

How It Works

The CLI copies a complete .agent profile into your project root. Once initialized, Antigravity picks up the profile automatically:

1. Session starts — loads .agent/AGENTS.md rules and using-superpowers skill
2. Each request gets routed to the most relevant skill
3. Design work flows through brainstorming → planning → execution
4. Every task is tracked in docs/plans/task.md (created at runtime)
5. Nothing is marked done without running verification commands first

Session Start → Load AGENTS.md → Load using-superpowers
                                        ↓
                              Route to relevant skill
                                        ↓
                          ┌─── Design change? ───┐
                          │ yes                   │ no
                     Brainstorm            Single-flow execution
                          ↓                       ↓
                    Writing plans          Verify before completion
                          ↓                       ↓
                  Single-flow execution   Finish branch
                          ↓
                  Verify before completion
                          ↓
                     Finish branch

---

Why This Exists

The original Superpowers repo doesn't support Antigravity, and there's no official port planned. I wanted to use Superpowers workflows in Antigravity projects, so I built this myself.

This is my attempt to bring the full Superpowers skill set to Antigravity — as close to the original as possible. The goal was never to fork and diverge; it was to translate just enough to make everything work natively on a different platform. Superpowers skills bring real structure to AI-assisted development — brainstorming before implementation, planning before coding, verification before completion claims — and that discipline shouldn't be locked to one platform.

This port keeps 12 out of 14 original skills intact and consolidates the remaining 2 into a single new skill that fits Antigravity's execution model. Every skill preserves its original intent, logic, and flow — only the platform-specific references, tool names, and execution primitives have been adapted.

---

What Changed from Original Superpowers

This port aims to stay as close to the original Superpowers as possible. The changes are the minimum required to run natively on Antigravity.

Execution Model

The one notable structural change. The original Superpowers dispatches multiple coding subagents in parallel — but Antigravity doesn't support parallel subagent execution. So the two skills that relied on that capability (dispatching-parallel-agents and subagent-driven-development) couldn't be ported as-is. Instead, they were consolidated into a single new skill — single-flow-task-execution — which preserves the same decomposition logic, task queuing, and review gates, just executed sequentially rather than in parallel. The workflow is the same; the concurrency model is what changed.

Original Skill	What Happened
dispatching-parallel-agents	Merged into single-flow-task-execution
subagent-driven-development	Merged into single-flow-task-execution
single-flow-task-execution	New — consolidates decomposition, queuing, and review loops

Task Tracking

	Approach
Original	TodoWrite tool
Port	Live table at <project-root>/docs/plans/task.md (created at runtime, not bundled)

Tool & Platform Vocabulary

Platform-specific references were translated — the underlying behavior is unchanged:

Original	Antigravity Port
Claude / Claude Code	Antigravity
Skill tool	view_file
TodoWrite	Update docs/plans/task.md
superpowers:<skill>	.agent/skills/<skill>/SKILL.md
CLAUDE.md	.agent/AGENTS.md

Skill Adaptations

Most skills required only terminology and path updates. A few needed slightly more work:

• requesting-code-review — uses a checklist-based review flow instead of subagent dispatch
• writing-plans / executing-plans — handoff paths and tracker references updated for Antigravity conventions

The rest — brainstorming, test-driven-development, verification-before-completion, finishing-a-development-branch, and others — preserve their original behavior with only naming and path normalization.

Antigravity-Native Additions

Infrastructure added to make the profile work as a first-class Antigravity citizen:

• .agent/AGENTS.md — tool translation contract and execution rules
• .agent/workflows/ — workflow entrypoints (brainstorm.md, execute-plan.md, write-plan.md)
• .agent/agents/code-reviewer.md — reviewer agent profile
• .agent/tests/ — automated profile validation (skill presence, frontmatter, legacy pattern detection)

Full Diff: See ANTIGRAVITY-PORT-DIFFERENCES.md for the exhaustive skill-by-skill comparison and CURRENT-FLOW.md for the complete workflow diagram.

---

Development

git clone https://git.visssoft.com/hanh.tonguyen/antigravity-superpowers.git
cd antigravity-superpowers

npm test              # Run 20 tests (cli, init, validate)
npm run smoke:pack    # Verify all 31 required files are packaged
npm link              # Install CLI globally from source

Publishing to npm

npm adduser           # Login to npm (first time only)
npm version patch     # or minor / major
npm publish

prepublishOnly runs npm test and npm run smoke:pack automatically before publish.

---

Contributing

Contributions are welcome! If you find a skill that could be ported more faithfully, a translation that's off, or an Antigravity convention that's not followed — open an issue or PR.

When making changes, run the validation suite:

npm test                           # 20 automated tests
antigravity-superpowers validate   # 78 profile checks
npm run smoke:pack                 # Package integrity

---

License

MIT