Add banner image to README.md for enhanced visual appeal

README.md

@@ -1,17 +1,34 @@
-# antigravity-superpowers
+<p align="center">
+  <img src="asset/banner.png" alt="antigravity-superpowers" width="100%" />
+</p>
 
-**Bring the power of [Superpowers](https://github.com/superpowers) to [Antigravity](https://antigravity.dev).**
+<h1 align="center">antigravity-superpowers</h1>
+
+<p align="center">
+  <strong>Bring the power of <a href="https://github.com/superpowers">Superpowers</a> to <a href="https://antigravity.dev">Antigravity</a>.</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/antigravity-superpowers"><img src="https://img.shields.io/npm/v/antigravity-superpowers.svg" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/antigravity-superpowers"><img src="https://img.shields.io/npm/dm/antigravity-superpowers.svg" alt="npm downloads" /></a>
+  <img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg" alt="node version" />
+  <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="license" />
+</p>
+
+---
 
 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.
+> **One command. Full profile. Ready to go.**
 
 ```bash
 npx antigravity-superpowers init
 ```
 
+---
+
 ## 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.
@@ -20,27 +37,33 @@ This is my attempt to bring the full Superpowers skill set to Antigravity — as
 
 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's Included
 
-13 skills covering the full development lifecycle:
+**13 skills** covering the full development lifecycle:
 
-- **`brainstorming`** — structured exploration before committing to an approach
+| Skill                            | Description                                             |
-- **`writing-plans`** — detailed, step-by-step implementation plans
+| -------------------------------- | ------------------------------------------------------- |
-- **`executing-plans`** — disciplined plan execution with progress tracking
+| `brainstorming`                  | Structured exploration before committing to an approach |
-- **`single-flow-task-execution`** — ordered task decomposition with review gates _(new, Antigravity-native)_
+| `writing-plans`                  | Detailed, step-by-step implementation plans             |
-- **`test-driven-development`** — write tests first, implement second
+| `executing-plans`                | Disciplined plan execution with progress tracking       |
-- **`systematic-debugging`** — root cause tracing with supporting techniques
+| `single-flow-task-execution`     | Ordered task decomposition with review gates _(new)_    |
-- **`requesting-code-review`** — structured review flow with checklists
+| `test-driven-development`        | Write tests first, implement second                     |
-- **`receiving-code-review`** — handling feedback systematically
+| `systematic-debugging`           | Root cause tracing with supporting techniques           |
-- **`verification-before-completion`** — prove it works before claiming it's done
+| `requesting-code-review`         | Structured review flow with checklists                  |
-- **`finishing-a-development-branch`** — clean branch wrap-up with workflow options
+| `receiving-code-review`          | Handling feedback systematically                        |
-- **`using-git-worktrees`** — parallel branch management
+| `verification-before-completion` | Prove it works before claiming it's done                |
-- **`using-superpowers`** — skill routing and session bootstrap
+| `finishing-a-development-branch` | Clean branch wrap-up with workflow options              |
-- **`writing-skills`** — create new skills that follow the system's conventions
+| `using-git-worktrees`            | Parallel branch management                              |
+| `using-superpowers`              | Skill routing and session bootstrap                     |
+| `writing-skills`                 | Create new skills that follow the system's conventions  |
 
-Plus supporting infrastructure: workflows, agents, validation tests, and an AGENTS.md contract that ties it all together.
+Plus supporting infrastructure: workflows, agents, validation tests, and an `AGENTS.md` contract that ties it all together.
 
-## Install
+---
+
+## Quick Start
 
 ```bash
 # Scaffold the .agent profile into your project
@@ -54,7 +77,7 @@ npm install -g antigravity-superpowers
 antigravity-superpowers init
 ```
 
-## Usage
+### Options
 
 ```bash
 # Initialize in current directory
@@ -73,6 +96,8 @@ After init, verify everything is wired up:
 bash .agent/tests/run-tests.sh
 ```
 
+---
+
 ## How It Works
 
 The CLI copies a complete `.agent` profile into your project root. Once initialized, Antigravity picks up the profile automatically:
@@ -101,9 +126,11 @@ Session Start → Load AGENTS.md → Load using-superpowers
                      Finish branch
 ```
 
+---
+
 ## 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. Here's what's different:
+> 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
 
@@ -117,8 +144,10 @@ The one notable structural change. The original Superpowers dispatches multiple
 
 ### Task Tracking
 
-- **Original:** `TodoWrite` tool
+|              | Approach                                                                            |
-- **Port:** Live table at `<project-root>/docs/plans/task.md` (created at runtime, not bundled)
+| ------------ | ----------------------------------------------------------------------------------- |
+| **Original** | `TodoWrite` tool                                                                    |
+| **Port**     | Live table at `<project-root>/docs/plans/task.md` (created at runtime, not bundled) |
 
 ### Tool & Platform Vocabulary
 
@@ -150,13 +179,13 @@ Infrastructure added to make the profile work as a first-class Antigravity citiz
 - `.agent/agents/code-reviewer.md` — reviewer agent profile
 - `.agent/tests/` — automated profile validation (skill presence, frontmatter, legacy pattern detection)
 
-### Full Diff
+> **Full Diff:** See [ANTIGRAVITY-PORT-DIFFERENCES.md](ANTIGRAVITY-PORT-DIFFERENCES.md) for the exhaustive skill-by-skill comparison and [CURRENT-FLOW.md](CURRENT-FLOW.md) for the complete workflow diagram.
 
-See [ANTIGRAVITY-PORT-DIFFERENCES.md](ANTIGRAVITY-PORT-DIFFERENCES.md) for the exhaustive skill-by-skill comparison and [CURRENT-FLOW.md](CURRENT-FLOW.md) for the complete workflow diagram.
+---
 
 ## 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.
+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 to make sure everything still checks out:
 
@@ -165,14 +194,16 @@ npm test
 bash .agent/tests/run-tests.sh
 ```
 
-## Local Development
+---
+
+## Development
 
 ```bash
-npm test
+npm test              # Run tests
-npm run smoke:pack
+npm run smoke:pack    # Verify package contents
 ```
 
-## Publishing
+### Publishing
 
 ```bash
 npm version patch
@@ -181,6 +212,8 @@ npm publish
 
 `prepublishOnly` runs `npm test` and `npm run smoke:pack` automatically.
 
+---
+
 ## License
 
 MIT