# sickn33/antigravity-awesome-skills architecture

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

- Interactive diagram: https://gitdiagram.com/sickn33/antigravity-awesome-skills
- Repository: https://github.com/sickn33/antigravity-awesome-skills

## Overview

AAS Core combines a large installable skill catalog with local CLI/MCP tooling and a browser catalog and Workbench. The main supported flow is: an agent searches and selects skills through MCP, a client saves the selection, the CLI validates it and previews a plan, and the user reviews the artifacts. The README also documents direct installation and browser discovery/review. Source excerpts show MCP delegation and web routes; many CLI and browser internals are unsampled, so uncertain implementation links are omitted.

Main entry points: [`apps/web-app/src/App.tsx`](https://github.com/sickn33/antigravity-awesome-skills/blob/main/apps/web-app/src/App.tsx) (Catalog Website), [`apps/web-app/src/pages/Workbench.tsx`](https://github.com/sickn33/antigravity-awesome-skills/blob/main/apps/web-app/src/pages/Workbench.tsx) (Workbench), [`tools/lib/aas-v1/mcp/server.js`](https://github.com/sickn33/antigravity-awesome-skills/blob/main/tools/lib/aas-v1/mcp/server.js) (MCP Server), [`tools/lib/aas-v1/cli/main.js`](https://github.com/sickn33/antigravity-awesome-skills/blob/main/tools/lib/aas-v1/cli/main.js) (AAS CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["AAS Core Runtime"]
  node_mcp["MCP Server<br/>[server.js]"]
  node_adapter["Local MCP Adapter<br/>[server.mjs]"]
  node_cli["AAS CLI<br/>[main.js]"]
  node_search["Catalog Search<br/>[search.js]"]
  node_schema["Manifest Validation"]
  node_installer["Direct Installer<br/>[install.js]"]
end

subgraph group_catalog["Skill Catalog"]
  node_skills[("Skill Catalog")]
end

subgraph group_web["Web Discovery"]
  node_webapp["Catalog Website<br/>[App.tsx]"]
  node_home["Skill Discovery<br/>[Home.tsx]"]
  node_detail["Skill Details<br/>[SkillDetail.tsx]"]
  node_docs["Documentation<br/>[Docs.tsx]"]
end

subgraph group_review["Workbench Review"]
  node_workbench["Workbench<br/>[Workbench.tsx]"]
  node_reviewlogic["Artifact Review<br/>[workbenchReview.ts]"]
  node_handoff["Install Handoff"]
end

node_developer(("Developer"))
node_agent(("Coding Agent"))

node_developer -->|"asks to inspect"| node_agent
node_agent -->|"uses local MCP"| node_adapter
node_adapter -->|"delegates tools"| node_mcp
node_agent -->|"searches and selects"| node_mcp
node_mcp -->|"searches catalog"| node_search
node_search -.->|"reads entries"| node_skills
node_agent -->|"returns selection"| node_developer
node_developer -->|"validates manifest"| node_cli
node_cli -->|"validates data"| node_schema
node_developer -->|"previews plan"| node_cli
node_developer -->|"imports artifacts"| node_workbench
node_workbench -->|"verifies artifacts"| node_reviewlogic
node_workbench -->|"offers handoff"| node_handoff
node_developer -->|"installs selected skills"| node_installer
node_developer -->|"browses catalog"| node_webapp
node_webapp -->|"routes to"| node_home
node_webapp -->|"routes to"| node_detail
node_webapp -->|"routes to"| node_docs

click node_mcp "https://github.com/sickn33/antigravity-awesome-skills/blob/main/tools/lib/aas-v1/mcp/server.js"
click node_adapter "https://github.com/sickn33/antigravity-awesome-skills/blob/main/apps/aas-plugin/src/server.mjs"
click node_cli "https://github.com/sickn33/antigravity-awesome-skills/blob/main/tools/lib/aas-v1/cli/main.js"
click node_search "https://github.com/sickn33/antigravity-awesome-skills/blob/main/tools/lib/aas-v1/search.js"
click node_schema "https://github.com/sickn33/antigravity-awesome-skills/blob/main/tools/lib/aas-v1/schema-validator.js"
click node_skills "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills"
click node_webapp "https://github.com/sickn33/antigravity-awesome-skills/blob/main/apps/web-app/src/App.tsx"
click node_home "https://github.com/sickn33/antigravity-awesome-skills/blob/main/apps/web-app/src/pages/Home.tsx"
click node_detail "https://github.com/sickn33/antigravity-awesome-skills/blob/main/apps/web-app/src/pages/SkillDetail.tsx"
click node_docs "https://github.com/sickn33/antigravity-awesome-skills/blob/main/apps/web-app/src/pages/Docs.tsx"
click node_workbench "https://github.com/sickn33/antigravity-awesome-skills/blob/main/apps/web-app/src/pages/Workbench.tsx"
click node_reviewlogic "https://github.com/sickn33/antigravity-awesome-skills/blob/main/apps/web-app/src/utils/workbenchReview.ts"
click node_handoff "https://github.com/sickn33/antigravity-awesome-skills/blob/main/apps/web-app/src/components/InstallationHandoff.tsx"
click node_installer "https://github.com/sickn33/antigravity-awesome-skills/blob/main/tools/bin/install.js"

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_mcp,node_adapter,node_cli,node_search,node_schema,node_installer toneBlue
class node_skills toneAmber
class node_webapp,node_home,node_detail,node_docs toneMint
class node_workbench,node_reviewlogic,node_handoff toneRose
class node_developer,node_agent toneIndigo
```

## Components

### AAS Core Runtime

- [MCP Server](https://github.com/sickn33/antigravity-awesome-skills/blob/main/tools/lib/aas-v1/mcp/server.js): `tools/lib/aas-v1/mcp/server.js`
- [Local MCP Adapter](https://github.com/sickn33/antigravity-awesome-skills/blob/main/apps/aas-plugin/src/server.mjs): `apps/aas-plugin/src/server.mjs`
- [AAS CLI](https://github.com/sickn33/antigravity-awesome-skills/blob/main/tools/lib/aas-v1/cli/main.js): `tools/lib/aas-v1/cli/main.js`
- [Catalog Search](https://github.com/sickn33/antigravity-awesome-skills/blob/main/tools/lib/aas-v1/search.js): `tools/lib/aas-v1/search.js`
- [Manifest Validation](https://github.com/sickn33/antigravity-awesome-skills/blob/main/tools/lib/aas-v1/schema-validator.js): `tools/lib/aas-v1/schema-validator.js`
- [Direct Installer](https://github.com/sickn33/antigravity-awesome-skills/blob/main/tools/bin/install.js): `tools/bin/install.js`

### Skill Catalog

- [Skill Catalog](https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills): `skills`

### Web Discovery

- [Catalog Website](https://github.com/sickn33/antigravity-awesome-skills/blob/main/apps/web-app/src/App.tsx): `apps/web-app/src/App.tsx`
- [Skill Discovery](https://github.com/sickn33/antigravity-awesome-skills/blob/main/apps/web-app/src/pages/Home.tsx): `apps/web-app/src/pages/Home.tsx`
- [Skill Details](https://github.com/sickn33/antigravity-awesome-skills/blob/main/apps/web-app/src/pages/SkillDetail.tsx): `apps/web-app/src/pages/SkillDetail.tsx`
- [Documentation](https://github.com/sickn33/antigravity-awesome-skills/blob/main/apps/web-app/src/pages/Docs.tsx): `apps/web-app/src/pages/Docs.tsx`

### Workbench Review

- [Workbench](https://github.com/sickn33/antigravity-awesome-skills/blob/main/apps/web-app/src/pages/Workbench.tsx): `apps/web-app/src/pages/Workbench.tsx`
- [Artifact Review](https://github.com/sickn33/antigravity-awesome-skills/blob/main/apps/web-app/src/utils/workbenchReview.ts): `apps/web-app/src/utils/workbenchReview.ts`
- [Install Handoff](https://github.com/sickn33/antigravity-awesome-skills/blob/main/apps/web-app/src/components/InstallationHandoff.tsx): `apps/web-app/src/components/InstallationHandoff.tsx`

### Other components

- **Developer**
- **Coding Agent**

## Connections

- Developer → Coding Agent: asks to inspect (evidence: `README.md`)
- Coding Agent → Local MCP Adapter: uses local MCP (evidence: `README.md`)
- Local MCP Adapter → MCP Server: delegates tools (evidence: `apps/aas-plugin/src/server.mjs`)
- Coding Agent → MCP Server: searches and selects (evidence: `README.md`)
- MCP Server → Catalog Search: searches catalog (evidence: `tools/lib/aas-v1/mcp/server.js`)
- Catalog Search → Skill Catalog: reads entries
- Coding Agent → Developer: returns selection (evidence: `README.md`)
- Developer → AAS CLI: validates manifest (evidence: `README.md`)
- AAS CLI → Manifest Validation: validates data (evidence: `tools/lib/aas-v1/cli/main.js`)
- Developer → AAS CLI: previews plan (evidence: `README.md`)
- Developer → Workbench: imports artifacts (evidence: `README.md`)
- Workbench → Artifact Review: verifies artifacts (evidence: `apps/web-app/src/pages/Workbench.tsx`)
- Workbench → Install Handoff: offers handoff (evidence: `apps/web-app/src/pages/Workbench.tsx`)
- Developer → Direct Installer: installs selected skills (evidence: `README.md`)
- Developer → Catalog Website: browses catalog (evidence: `README.md`)
- Catalog Website → Skill Discovery: routes to (evidence: `apps/web-app/src/App.tsx`)
- Catalog Website → Skill Details: routes to (evidence: `apps/web-app/src/App.tsx`)
- Catalog Website → Documentation: routes to (evidence: `apps/web-app/src/App.tsx`)
