# sickn33/agentic-awesome-skills architecture

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

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

## Overview

AAS Core is a local skill-catalog discovery and review tool, accompanied by a hosted catalog and browser-local Workbench. The principal workflow is an agent searches and reads the catalog, chooses exact skill IDs, then a client saves a manifest; the CLI validates it and produces an immutable preview for human review. The MCP server exposes the core tools, while the web app supports catalog discovery and artifact review. The README documents these boundaries; unsampled implementation details are represented only where documented.

Main entry points: [`tools/lib/aas-v1/mcp/server.js`](https://github.com/sickn33/agentic-awesome-skills/blob/main/tools/lib/aas-v1/mcp/server.js) (MCP Server), [`tools/lib/aas-v1/cli/main.js`](https://github.com/sickn33/agentic-awesome-skills/blob/main/tools/lib/aas-v1/cli/main.js) (Core CLI), [`apps/aas-plugin/src/server.mjs`](https://github.com/sickn33/agentic-awesome-skills/blob/main/apps/aas-plugin/src/server.mjs) (Protocol Adapter), [`tools/lib/aas-v1/search.js`](https://github.com/sickn33/agentic-awesome-skills/blob/main/tools/lib/aas-v1/search.js) (Catalog Search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Local AAS Core"]
  node_mcp["MCP Server<br/>[server.js]"]
  node_plugin["Protocol Adapter<br/>[server.mjs]"]
  node_search["Catalog Search<br/>[search.js]"]
  node_core["Core API<br/>[index.js]"]
  node_cli["Core CLI<br/>[main.js]"]
  node_installer["Direct Installer<br/>[install.js]"]
end

subgraph group_web["Catalog Web App"]
  node_web["Catalog Browser<br/>[Home.tsx]"]
  node_detail["Skill Detail<br/>[SkillDetail.tsx]"]
  node_docs["Documentation<br/>[Docs.tsx]"]
end

subgraph group_review["Selection Review"]
  node_workbench["Artifact Workbench<br/>[Workbench.tsx]"]
  node_reviewlogic["Artifact Checks<br/>[workbenchReview.ts]"]
end

subgraph group_catalog["Skill Collection"]
  node_catalogdata[("Skill Catalog")]
end

node_agent(("Coding Agent"))
node_client(("MCP Client"))

node_agent -->|"selects via"| node_mcp
node_client -->|"connects to"| node_plugin
node_plugin -->|"delegates tools"| node_mcp
node_mcp -->|"uses core API"| node_core
node_mcp -->|"searches catalog"| node_search
node_search -.->|"queries"| node_catalogdata
node_agent -->|"inspects skills"| node_catalogdata
node_client -->|"validates manifest"| node_cli
node_cli -->|"uses core API"| node_core
node_cli -->|"writes preview"| node_client
node_client -->|"imports artifacts"| node_workbench
node_workbench -->|"verifies artifacts"| node_reviewlogic
node_agent -->|"browses catalog"| node_web
node_web -.->|"opens skill"| node_detail
node_client -->|"installs selected IDs"| node_installer
node_agent -->|"reads guides"| node_docs

click node_catalogdata "https://github.com/sickn33/agentic-awesome-skills/tree/main/skills"
click node_mcp "https://github.com/sickn33/agentic-awesome-skills/blob/main/tools/lib/aas-v1/mcp/server.js"
click node_plugin "https://github.com/sickn33/agentic-awesome-skills/blob/main/apps/aas-plugin/src/server.mjs"
click node_search "https://github.com/sickn33/agentic-awesome-skills/blob/main/tools/lib/aas-v1/search.js"
click node_core "https://github.com/sickn33/agentic-awesome-skills/blob/main/tools/lib/aas-v1/index.js"
click node_cli "https://github.com/sickn33/agentic-awesome-skills/blob/main/tools/lib/aas-v1/cli/main.js"
click node_web "https://github.com/sickn33/agentic-awesome-skills/blob/main/apps/web-app/src/pages/Home.tsx"
click node_detail "https://github.com/sickn33/agentic-awesome-skills/blob/main/apps/web-app/src/pages/SkillDetail.tsx"
click node_docs "https://github.com/sickn33/agentic-awesome-skills/blob/main/apps/web-app/src/pages/Docs.tsx"
click node_workbench "https://github.com/sickn33/agentic-awesome-skills/blob/main/apps/web-app/src/pages/Workbench.tsx"
click node_reviewlogic "https://github.com/sickn33/agentic-awesome-skills/blob/main/apps/web-app/src/utils/workbenchReview.ts"
click node_installer "https://github.com/sickn33/agentic-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_plugin,node_search,node_core,node_cli,node_installer,node_client toneBlue
class node_web,node_detail,node_docs toneAmber
class node_workbench,node_reviewlogic toneMint
class node_catalogdata toneRose
class node_agent toneIndigo
```

## Components

### Local AAS Core

- [MCP Server](https://github.com/sickn33/agentic-awesome-skills/blob/main/tools/lib/aas-v1/mcp/server.js): `tools/lib/aas-v1/mcp/server.js`
- [Protocol Adapter](https://github.com/sickn33/agentic-awesome-skills/blob/main/apps/aas-plugin/src/server.mjs): `apps/aas-plugin/src/server.mjs`
- [Catalog Search](https://github.com/sickn33/agentic-awesome-skills/blob/main/tools/lib/aas-v1/search.js): `tools/lib/aas-v1/search.js`
- [Core API](https://github.com/sickn33/agentic-awesome-skills/blob/main/tools/lib/aas-v1/index.js): `tools/lib/aas-v1/index.js`
- [Core CLI](https://github.com/sickn33/agentic-awesome-skills/blob/main/tools/lib/aas-v1/cli/main.js): `tools/lib/aas-v1/cli/main.js`
- [Direct Installer](https://github.com/sickn33/agentic-awesome-skills/blob/main/tools/bin/install.js): `tools/bin/install.js`

### Catalog Web App

- [Catalog Browser](https://github.com/sickn33/agentic-awesome-skills/blob/main/apps/web-app/src/pages/Home.tsx): `apps/web-app/src/pages/Home.tsx`
- [Skill Detail](https://github.com/sickn33/agentic-awesome-skills/blob/main/apps/web-app/src/pages/SkillDetail.tsx): `apps/web-app/src/pages/SkillDetail.tsx`
- [Documentation](https://github.com/sickn33/agentic-awesome-skills/blob/main/apps/web-app/src/pages/Docs.tsx): `apps/web-app/src/pages/Docs.tsx`

### Selection Review

- [Artifact Workbench](https://github.com/sickn33/agentic-awesome-skills/blob/main/apps/web-app/src/pages/Workbench.tsx): `apps/web-app/src/pages/Workbench.tsx`
- [Artifact Checks](https://github.com/sickn33/agentic-awesome-skills/blob/main/apps/web-app/src/utils/workbenchReview.ts): `apps/web-app/src/utils/workbenchReview.ts`

### Skill Collection

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

### Other components

- **Coding Agent**
- **MCP Client**

## Connections

- Coding Agent → MCP Server: selects via (evidence: `README.md`)
- MCP Client → Protocol Adapter: connects to (evidence: `README.md`)
- Protocol Adapter → MCP Server: delegates tools (evidence: `apps/aas-plugin/src/server.mjs`)
- MCP Server → Core API: uses core API (evidence: `tools/lib/aas-v1/mcp/server.js`)
- MCP Server → Catalog Search: searches catalog (evidence: `tools/lib/aas-v1/mcp/server.js`)
- Catalog Search → Skill Catalog: queries
- Coding Agent → Skill Catalog: inspects skills (evidence: `README.md`)
- MCP Client → Core CLI: validates manifest (evidence: `README.md`)
- Core CLI → Core API: uses core API (evidence: `tools/lib/aas-v1/cli/main.js`)
- Core CLI → MCP Client: writes preview (evidence: `README.md`)
- MCP Client → Artifact Workbench: imports artifacts (evidence: `README.md`)
- Artifact Workbench → Artifact Checks: verifies artifacts (evidence: `apps/web-app/src/pages/Workbench.tsx`)
- Coding Agent → Catalog Browser: browses catalog (evidence: `README.md`)
- Catalog Browser → Skill Detail: opens skill
- MCP Client → Direct Installer: installs selected IDs (evidence: `README.md`)
- Coding Agent → Documentation: reads guides (evidence: `README.md`)
