# s3ctr4l/antigravity architecture

> Architecture diagram of the GitHub repository s3ctr4l/antigravity, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/s3ctr4l/antigravity
- Repository: https://github.com/s3ctr4l/antigravity

## Overview

Antigravity Awesome Skills is an installable library of SKILL.md playbooks for AI coding assistants, with a companion web catalog for browsing skills. The main user journey is to discover a skill, install it into an assistant’s skills directory, and invoke it in that assistant. README capabilities also include cross-tool support and curated bundles/workflows. The web-app routing and installer behavior are sampled; individual page data wiring and bundle implementation are not, so those links are omitted or kept at documented subsystem level.

Main entry points: [`apps/web-app/src/context/SkillContext.tsx`](https://github.com/s3ctr4l/antigravity/blob/main/apps/web-app/src/context/SkillContext.tsx) (Skill context), [`tools/bin/install.js`](https://github.com/s3ctr4l/antigravity/blob/main/tools/bin/install.js) (Installer CLI), [`apps/web-app/src/App.tsx`](https://github.com/s3ctr4l/antigravity/blob/main/apps/web-app/src/App.tsx) (Web application), [`apps/web-app/src/pages/SkillDetail.tsx`](https://github.com/s3ctr4l/antigravity/blob/main/apps/web-app/src/pages/SkillDetail.tsx) (Skill detail)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_library["Skill library"]
  node_playbooks["Skill playbooks"]
  node_bundles["Bundles and workflows"]
end

subgraph group_install["Installation"]
  node_installer["Installer CLI<br/>[install.js]"]
  node_install_helpers["Install helpers"]
  node_target_dirs["Assistant skill dirs"]
end

subgraph group_catalog["Web catalog"]
  node_web_app["Web application<br/>[App.tsx]"]
  node_skill_provider["Skill context<br/>[SkillContext.tsx]"]
  node_skill_index["Skill index"]
  node_home_page["Catalog home<br/>[Home.tsx]"]
  node_detail_page["Skill detail<br/>[SkillDetail.tsx]"]
end

subgraph group_stars["Skill stars"]
  node_star_button["Star control"]
  node_star_hook["Star state<br/>[useSkillStars.ts]"]
  node_browser_storage[("Browser storage")]
  node_supabase["Supabase<br/>[supabase.ts]"]
  node_star_store[("Star records")]
end

node_developer(("Developer"))
node_assistant(("AI assistant"))

node_developer -->|"runs install"| node_installer
node_installer -->|"uses safety helpers"| node_install_helpers
node_installer -->|"copies skills"| node_playbooks
node_installer -->|"installs into"| node_target_dirs
node_target_dirs -->|"provides skills"| node_assistant
node_assistant -->|"invokes"| node_playbooks
node_developer -->|"browses catalog"| node_web_app
node_web_app -->|"routes home"| node_home_page
node_web_app -->|"routes skill detail"| node_detail_page
node_web_app -->|"provides skill state"| node_skill_provider
node_skill_provider -->|"fetches index"| node_skill_index
node_home_page -->|"reads skills"| node_skill_provider
node_detail_page -->|"reads skills"| node_skill_provider
node_detail_page -->|"renders control"| node_star_button
node_star_button -->|"uses star state"| node_star_hook
node_star_hook -->|"reads and writes"| node_browser_storage
node_star_hook -.->|"queries optionally"| node_supabase
node_skill_provider -.->|"queries optionally"| node_supabase
node_supabase -.->|"reads records"| node_star_store

click node_playbooks "https://github.com/s3ctr4l/antigravity/tree/main/skills"
click node_bundles "https://github.com/s3ctr4l/antigravity/tree/main/skills"
click node_installer "https://github.com/s3ctr4l/antigravity/blob/main/tools/bin/install.js"
click node_install_helpers "https://github.com/s3ctr4l/antigravity/tree/main/tools/lib"
click node_web_app "https://github.com/s3ctr4l/antigravity/blob/main/apps/web-app/src/App.tsx"
click node_skill_provider "https://github.com/s3ctr4l/antigravity/blob/main/apps/web-app/src/context/SkillContext.tsx"
click node_home_page "https://github.com/s3ctr4l/antigravity/blob/main/apps/web-app/src/pages/Home.tsx"
click node_detail_page "https://github.com/s3ctr4l/antigravity/blob/main/apps/web-app/src/pages/SkillDetail.tsx"
click node_star_button "https://github.com/s3ctr4l/antigravity/blob/main/apps/web-app/src/components/SkillStarButton.tsx"
click node_star_hook "https://github.com/s3ctr4l/antigravity/blob/main/apps/web-app/src/hooks/useSkillStars.ts"
click node_supabase "https://github.com/s3ctr4l/antigravity/blob/main/apps/web-app/src/lib/supabase.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_playbooks,node_bundles toneBlue
class node_installer,node_install_helpers,node_target_dirs toneAmber
class node_web_app,node_skill_provider,node_skill_index,node_home_page,node_detail_page toneMint
class node_star_button,node_star_hook,node_browser_storage,node_supabase,node_star_store toneRose
class node_developer,node_assistant toneIndigo
```

## Components

### Skill library

- [Skill playbooks](https://github.com/s3ctr4l/antigravity/tree/main/skills): `skills`
- [Bundles and workflows](https://github.com/s3ctr4l/antigravity/tree/main/skills): `skills`

### Installation

- [Installer CLI](https://github.com/s3ctr4l/antigravity/blob/main/tools/bin/install.js): `tools/bin/install.js`
- [Install helpers](https://github.com/s3ctr4l/antigravity/tree/main/tools/lib): `tools/lib`
- **Assistant skill dirs**

### Web catalog

- [Web application](https://github.com/s3ctr4l/antigravity/blob/main/apps/web-app/src/App.tsx): `apps/web-app/src/App.tsx`
- [Skill context](https://github.com/s3ctr4l/antigravity/blob/main/apps/web-app/src/context/SkillContext.tsx): `apps/web-app/src/context/SkillContext.tsx`
- **Skill index**
- [Catalog home](https://github.com/s3ctr4l/antigravity/blob/main/apps/web-app/src/pages/Home.tsx): `apps/web-app/src/pages/Home.tsx`
- [Skill detail](https://github.com/s3ctr4l/antigravity/blob/main/apps/web-app/src/pages/SkillDetail.tsx): `apps/web-app/src/pages/SkillDetail.tsx`

### Skill stars

- [Star control](https://github.com/s3ctr4l/antigravity/blob/main/apps/web-app/src/components/SkillStarButton.tsx): `apps/web-app/src/components/SkillStarButton.tsx`
- [Star state](https://github.com/s3ctr4l/antigravity/blob/main/apps/web-app/src/hooks/useSkillStars.ts): `apps/web-app/src/hooks/useSkillStars.ts`
- **Browser storage**
- [Supabase](https://github.com/s3ctr4l/antigravity/blob/main/apps/web-app/src/lib/supabase.ts): `apps/web-app/src/lib/supabase.ts`
- **Star records**

### Other components

- **Developer**
- **AI assistant**

## Connections

- Developer → Installer CLI: runs install
- Installer CLI → Install helpers: uses safety helpers
- Installer CLI → Skill playbooks: copies skills
- Installer CLI → Assistant skill dirs: installs into
- Assistant skill dirs → AI assistant: provides skills
- AI assistant → Skill playbooks: invokes
- Developer → Web application: browses catalog
- Web application → Catalog home: routes home
- Web application → Skill detail: routes skill detail
- Web application → Skill context: provides skill state
- Skill context → Skill index: fetches index
- Catalog home → Skill context: reads skills
- Skill detail → Skill context: reads skills
- Skill detail → Star control: renders control
- Star control → Star state: uses star state
- Star state → Browser storage: reads and writes
- Star state → Supabase: queries optionally
- Skill context → Supabase: queries optionally
- Supabase → Star records: reads records