How diegosouzapw/awesome-omni-skills works
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: task-runtime.js Task runtime · SQLiteSearchAdapter.js Search adapters · server.js HTTP API · cli.js CLI and guided UI
Components 20
Skill catalog
- Native skills
skills - Curated skills
skills_omni - Search adapters
packages/catalog-core/src/adapters/SQLiteSearchAdapter.js - Search contract
packages/catalog-core/src/adapters/SearchAdapter.js - Search utilities
packages/catalog-core/src/adapters/search-utils.js
Install experience
- CLI and guided UI
packages/cli/src/bin/cli.js - Install flow
packages/cli/src/tui/install-flow.mjs - Install targets
packages/install-targets/src/index.js
Catalog API
- HTTP API
packages/server-api/src/server.js - HTTP runtime
packages/server-api/src/http-runtime.js - Archive formats
packages/server-api/src/archive-format.js
MCP runtime
- MCP tools
packages/server-mcp/src/server.js - Local sidecar
packages/server-mcp/src/local-sidecar.js
A2A runtime
- A2A endpoint
packages/server-a2a/src/server.js - Task runtime
packages/server-a2a/src/task-runtime.js - Task coordination
packages/server-a2a/src/task-coordinator.js - Task execution
packages/server-a2a/src/task-executor.js - Task operations
packages/server-a2a/src/task-operations.js - Task persistence
packages/server-a2a/src/task-store.js
Other components
- Assistant user
Connections 21
- 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
packages/server-api/src/server.js - HTTP API → HTTP runtime: uses middleware
packages/server-api/src/server.js - HTTP API → Archive formats: resolves archives
packages/server-api/src/server.js - Assistant user → MCP tools: requests tools
- MCP tools → Search adapters: searches catalog
packages/server-mcp/src/server.js - MCP tools → Local sidecar: dispatches local tools
packages/server-mcp/src/server.js - Local sidecar → Install targets: lists client targets
packages/server-mcp/src/local-sidecar.js - Assistant user → A2A endpoint: sends task
packages/server-a2a/src/server.js - A2A endpoint → Task runtime: routes RPC
packages/server-a2a/src/server.js - Task runtime → Task operations: evaluates operations
packages/server-a2a/src/task-runtime.js - Task operations → Search adapters: searches skills
packages/server-a2a/src/task-operations.js - Task runtime → Task coordination: coordinates tasks
packages/server-a2a/src/task-runtime.js - Task runtime → Task execution: dispatches work
packages/server-a2a/src/task-runtime.js - Task runtime → Task persistence: persists tasks
packages/server-a2a/src/task-runtime.js - Search adapters → Search contract: extends contract
packages/catalog-core/src/adapters/SQLiteSearchAdapter.js - Search adapters → Search utilities: uses helpers
packages/catalog-core/src/adapters/SQLiteSearchAdapter.js