# diegosouzapw/awesome-omni-skills architecture

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

- Interactive diagram: https://gitdiagram.com/diegosouzapw/awesome-omni-skills
- Repository: https://github.com/diegosouzapw/awesome-omni-skills

## Overview

Awesome Omni Skills is an installable catalog of AI-assistant playbooks, with CLI, read-only API, MCP, and A2A runtime surfaces. The principal user journey is discovering skills, selecting skills or bundles, producing an install plan, and installing to an assistant client. The README documents the product capabilities; sampled server excerpts and the source index support several runtime connections. CLI internals and some A2A task modules were not sampled, so those links are left unverified rather than inferred.

Main entry points: [`packages/server-a2a/src/task-runtime.js`](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-a2a/src/task-runtime.js) (Task runtime), [`packages/catalog-core/src/adapters/SQLiteSearchAdapter.js`](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/catalog-core/src/adapters/SQLiteSearchAdapter.js) (Search adapters), [`packages/server-api/src/server.js`](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-api/src/server.js) (HTTP API), [`packages/cli/src/bin/cli.js`](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/cli/src/bin/cli.js) (CLI and guided UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Skill catalog"]
  node_skills["Native skills"]
  node_curated["Curated skills"]
  node_search["Search adapters"]
  node_searchbase["Search contract<br/>[SearchAdapter.js]"]
  node_searchutils["Search utilities<br/>[search-utils.js]"]
end

subgraph group_install["Install experience"]
  node_cli["CLI and guided UI<br/>[cli.js]"]
  node_installer["Install flow<br/>[install-flow.mjs]"]
  node_targets["Install targets<br/>[index.js]"]
end

subgraph group_api["Catalog API"]
  node_api["HTTP API<br/>[server.js]"]
  node_http["HTTP runtime<br/>[http-runtime.js]"]
  node_archive["Archive formats<br/>[archive-format.js]"]
end

subgraph group_mcp["MCP runtime"]
  node_mcp["MCP tools<br/>[server.js]"]
  node_sidecar["Local sidecar<br/>[local-sidecar.js]"]
end

subgraph group_a2a["A2A runtime"]
  node_a2asrv["A2A endpoint<br/>[server.js]"]
  node_runtime["Task runtime<br/>[task-runtime.js]"]
  node_coordinator["Task coordination"]
  node_executor["Task execution<br/>[task-executor.js]"]
  node_operations["Task operations<br/>[task-operations.js]"]
  node_store[("Task persistence<br/>[task-store.js]")]
end

node_user(("Assistant user"))

node_user -->|"invokes"| node_cli
node_cli -.->|"offers"| node_installer
node_installer -.->|"selects clients"| node_targets
node_cli -->|"installs catalog skills"| node_skills
node_user -->|"requests discovery"| node_api
node_api -->|"lists skills"| node_search
node_api -->|"uses middleware"| node_http
node_api -->|"resolves archives"| node_archive
node_user -->|"requests tools"| node_mcp
node_mcp -->|"searches catalog"| node_search
node_mcp -->|"dispatches local tools"| node_sidecar
node_sidecar -->|"lists client targets"| node_targets
node_user -->|"sends task"| node_a2asrv
node_a2asrv -->|"routes RPC"| node_runtime
node_runtime -->|"evaluates operations"| node_operations
node_operations -->|"searches skills"| node_search
node_runtime -->|"coordinates tasks"| node_coordinator
node_runtime -->|"dispatches work"| node_executor
node_runtime -->|"persists tasks"| node_store
node_search -->|"extends contract"| node_searchbase
node_search -->|"uses helpers"| node_searchutils

click node_skills "https://github.com/diegosouzapw/awesome-omni-skills/tree/main/skills"
click node_curated "https://github.com/diegosouzapw/awesome-omni-skills/tree/main/skills_omni"
click node_search "https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/catalog-core/src/adapters/SQLiteSearchAdapter.js"
click node_searchbase "https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/catalog-core/src/adapters/SearchAdapter.js"
click node_searchutils "https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/catalog-core/src/adapters/search-utils.js"
click node_cli "https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/cli/src/bin/cli.js"
click node_installer "https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/cli/src/tui/install-flow.mjs"
click node_targets "https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/install-targets/src/index.js"
click node_api "https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-api/src/server.js"
click node_http "https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-api/src/http-runtime.js"
click node_archive "https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-api/src/archive-format.js"
click node_mcp "https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-mcp/src/server.js"
click node_sidecar "https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-mcp/src/local-sidecar.js"
click node_a2asrv "https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-a2a/src/server.js"
click node_runtime "https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-a2a/src/task-runtime.js"
click node_coordinator "https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-a2a/src/task-coordinator.js"
click node_executor "https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-a2a/src/task-executor.js"
click node_operations "https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-a2a/src/task-operations.js"
click node_store "https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-a2a/src/task-store.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_skills,node_curated,node_search,node_searchbase,node_searchutils,node_user toneBlue
class node_cli,node_installer,node_targets toneAmber
class node_api,node_http,node_archive toneMint
class node_mcp,node_sidecar toneRose
class node_a2asrv,node_runtime,node_coordinator,node_executor,node_operations,node_store toneIndigo
```

## Components

### Skill catalog

- [Native skills](https://github.com/diegosouzapw/awesome-omni-skills/tree/main/skills): `skills`
- [Curated skills](https://github.com/diegosouzapw/awesome-omni-skills/tree/main/skills_omni): `skills_omni`
- [Search adapters](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/catalog-core/src/adapters/SQLiteSearchAdapter.js): `packages/catalog-core/src/adapters/SQLiteSearchAdapter.js`
- [Search contract](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/catalog-core/src/adapters/SearchAdapter.js): `packages/catalog-core/src/adapters/SearchAdapter.js`
- [Search utilities](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/catalog-core/src/adapters/search-utils.js): `packages/catalog-core/src/adapters/search-utils.js`

### Install experience

- [CLI and guided UI](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/cli/src/bin/cli.js): `packages/cli/src/bin/cli.js`
- [Install flow](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/cli/src/tui/install-flow.mjs): `packages/cli/src/tui/install-flow.mjs`
- [Install targets](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/install-targets/src/index.js): `packages/install-targets/src/index.js`

### Catalog API

- [HTTP API](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-api/src/server.js): `packages/server-api/src/server.js`
- [HTTP runtime](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-api/src/http-runtime.js): `packages/server-api/src/http-runtime.js`
- [Archive formats](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-api/src/archive-format.js): `packages/server-api/src/archive-format.js`

### MCP runtime

- [MCP tools](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-mcp/src/server.js): `packages/server-mcp/src/server.js`
- [Local sidecar](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-mcp/src/local-sidecar.js): `packages/server-mcp/src/local-sidecar.js`

### A2A runtime

- [A2A endpoint](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-a2a/src/server.js): `packages/server-a2a/src/server.js`
- [Task runtime](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-a2a/src/task-runtime.js): `packages/server-a2a/src/task-runtime.js`
- [Task coordination](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-a2a/src/task-coordinator.js): `packages/server-a2a/src/task-coordinator.js`
- [Task execution](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-a2a/src/task-executor.js): `packages/server-a2a/src/task-executor.js`
- [Task operations](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-a2a/src/task-operations.js): `packages/server-a2a/src/task-operations.js`
- [Task persistence](https://github.com/diegosouzapw/awesome-omni-skills/blob/main/packages/server-a2a/src/task-store.js): `packages/server-a2a/src/task-store.js`

### Other components

- **Assistant user**

## Connections

- Assistant user → CLI and guided UI: invokes
- CLI and guided UI → Install flow: offers
- Install flow → Install targets: selects clients
- CLI and guided UI → Native skills: installs catalog skills
- Assistant user → HTTP API: requests discovery
- HTTP API → Search adapters: lists skills (evidence: `packages/server-api/src/server.js`)
- HTTP API → HTTP runtime: uses middleware (evidence: `packages/server-api/src/server.js`)
- HTTP API → Archive formats: resolves archives (evidence: `packages/server-api/src/server.js`)
- Assistant user → MCP tools: requests tools
- MCP tools → Search adapters: searches catalog (evidence: `packages/server-mcp/src/server.js`)
- MCP tools → Local sidecar: dispatches local tools (evidence: `packages/server-mcp/src/server.js`)
- Local sidecar → Install targets: lists client targets (evidence: `packages/server-mcp/src/local-sidecar.js`)
- Assistant user → A2A endpoint: sends task (evidence: `packages/server-a2a/src/server.js`)
- A2A endpoint → Task runtime: routes RPC (evidence: `packages/server-a2a/src/server.js`)
- Task runtime → Task operations: evaluates operations (evidence: `packages/server-a2a/src/task-runtime.js`)
- Task operations → Search adapters: searches skills (evidence: `packages/server-a2a/src/task-operations.js`)
- Task runtime → Task coordination: coordinates tasks (evidence: `packages/server-a2a/src/task-runtime.js`)
- Task runtime → Task execution: dispatches work (evidence: `packages/server-a2a/src/task-runtime.js`)
- Task runtime → Task persistence: persists tasks (evidence: `packages/server-a2a/src/task-runtime.js`)
- Search adapters → Search contract: extends contract (evidence: `packages/catalog-core/src/adapters/SQLiteSearchAdapter.js`)
- Search adapters → Search utilities: uses helpers (evidence: `packages/catalog-core/src/adapters/SQLiteSearchAdapter.js`)
