# jeremylongshore/tons-of-skills-marketplace architecture

> Architecture diagram of the GitHub repository jeremylongshore/tons-of-skills-marketplace, 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/jeremylongshore/tons-of-skills-marketplace
- Repository: https://github.com/jeremylongshore/tons-of-skills-marketplace

## Overview

Tons of Skills is a model-agnostic agent-skills marketplace and management platform. Users discover plugins and skills through the marketplace, install and manage them with the ccpi CLI or a verified native harness, then use the installed skills in an agent harness. The repository also includes an analytics daemon/dashboard and separately consumable MCP integrations. The README documents discovery routes and installation; sampled CLI and analytics sources confirm key dispatch and event flows. Slack-channel modules are included because the source index identifies them as core; unsampled internal relationships are omitted.

Main entry points: [`plugins/mcp/slack-channel/server.ts`](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/server.ts) (Slack MCP server), [`packages/cli/src/program.ts`](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/cli/src/program.ts) (ccpi CLI), [`packages/analytics-dashboard/src/hooks/useWebSocket.ts`](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/analytics-dashboard/src/hooks/useWebSocket.ts) (WebSocket hook), [`marketplace/src`](https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/marketplace/src) (Marketplace site)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Marketplace discovery"]
  node_marketplace["Marketplace site"]
  node_catalogdata[("Plugin catalog")]
  node_bundles["Download bundles"]
end

subgraph group_management["Plugin management"]
  node_cli["ccpi CLI<br/>[program.ts]"]
  node_cliinstall["Install command<br/>[install.ts]"]
  node_clidoctor["Diagnostics<br/>[doctor.ts]"]
  node_clipaths["Harness paths<br/>[paths.ts]"]
  node_validator["Skill validation<br/>[validate.ts]"]
end

subgraph group_analytics["Usage analytics"]
  node_daemon["Analytics daemon<br/>[server.ts]"]
  node_dashboard["Analytics dashboard<br/>[App.tsx]"]
  node_wsclient["WebSocket hook<br/>[useWebSocket.ts]"]
  node_wsservice["WebSocket service<br/>[websocket.ts]"]
  node_eventstore[("Event store<br/>[analyticsStore.ts]")]
end

subgraph group_slack["Slack MCP"]
  node_slackserver["Slack MCP server<br/>[server.ts]"]
  node_slackadmin["Admin commands<br/>[admin.ts]"]
  node_slackcrypto["Crypto utilities<br/>[crypto.ts]"]
  node_slackjournal[("Audit journal<br/>[journal.ts]")]
  node_slacklib["Slack helpers<br/>[lib.ts]"]
  node_slackmanifest["Manifest pins<br/>[manifest.ts]"]
  node_slacknonce["Nonce HITL<br/>[nonce-hitl.ts]"]
  node_slackdispatch["Policy dispatch<br/>[policy-dispatch.ts]"]
  node_slackpolicy["Policy rules<br/>[policy.ts]"]
  node_slackdelivery["Slack delivery<br/>[slack-delivery.ts]"]
  node_slackstream["Stream replies<br/>[stream-reply.ts]"]
  node_slacksupervisor["Supervisor<br/>[supervisor.ts]"]
end

subgraph group_catalog["Skills and integrations"]
  node_skills["Skills corpus"]
  node_databricks["Databricks MCP<br/>[pipelines.ts]"]
  node_prtospec["PR-to-spec"]
end

node_user(("Agent user"))
node_harness(("Claude Code"))

node_user -->|"browses"| node_marketplace
node_marketplace -->|"lists plugins"| node_catalogdata
node_user -->|"downloads"| node_bundles
node_user -->|"runs commands"| node_cli
node_cli -->|"dispatches install"| node_cliinstall
node_cli -->|"dispatches diagnostics"| node_clidoctor
node_cli -->|"dispatches validation"| node_validator
node_cli -->|"detects paths"| node_clipaths
node_cliinstall -->|"uses paths"| node_clipaths
node_cli -->|"manages plugins"| node_harness
node_harness -->|"uses installed skills"| node_skills
node_daemon -.->|"broadcasts events"| node_dashboard
node_dashboard -->|"starts hook"| node_wsclient
node_wsclient -->|"connects"| node_wsservice
node_wsclient -->|"records events"| node_eventstore
node_user -.->|"uses Slack tools"| node_slackserver
node_slackserver -->|"dispatches commands"| node_slackadmin
node_slackserver -.->|"uses guards"| node_slackcrypto
node_slackserver -->|"verifies journal"| node_slackjournal
node_slackserver -->|"uses helpers"| node_slacklib
node_slackserver -->|"finds pins"| node_slackmanifest
node_slackserver -.->|"uses challenges"| node_slacknonce
node_slackserver -->|"records denials"| node_slackdispatch
node_slackserver -->|"parses rules"| node_slackpolicy
node_slackserver -.->|"sends replies"| node_slackdelivery
node_slackserver -.->|"streams replies"| node_slackstream
node_slackserver -.->|"uses supervisor"| node_slacksupervisor
node_user -.->|"requests pipeline data"| node_databricks
node_user -.->|"uses specification tools"| node_prtospec

click node_marketplace "https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/marketplace/src"
click node_catalogdata "https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/plugins"
click node_skills "https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/plugins"
click node_bundles "https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/marketplace"
click node_cli "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/cli/src/program.ts"
click node_cliinstall "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/cli/src/commands/install.ts"
click node_clidoctor "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/cli/src/commands/doctor.ts"
click node_clipaths "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/cli/src/utils/paths.ts"
click node_validator "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/cli/src/commands/validate.ts"
click node_daemon "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/analytics-daemon/src/server.ts"
click node_dashboard "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/analytics-dashboard/src/App.tsx"
click node_wsclient "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/analytics-dashboard/src/hooks/useWebSocket.ts"
click node_wsservice "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/analytics-dashboard/src/services/websocket.ts"
click node_eventstore "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/analytics-dashboard/src/store/analyticsStore.ts"
click node_slackserver "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/server.ts"
click node_slackadmin "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/admin.ts"
click node_slackcrypto "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/crypto.ts"
click node_slackjournal "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/journal.ts"
click node_slacklib "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/lib.ts"
click node_slackmanifest "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/manifest.ts"
click node_slacknonce "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/nonce-hitl.ts"
click node_slackdispatch "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/policy-dispatch.ts"
click node_slackpolicy "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/policy.ts"
click node_slackdelivery "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/slack-delivery.ts"
click node_slackstream "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/stream-reply.ts"
click node_slacksupervisor "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/supervisor.ts"
click node_databricks "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/databricks-workspace-mcp/src/tools/pipelines.ts"
click node_prtospec "https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/plugins/mcp/pr-to-spec/src/core"

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_marketplace,node_catalogdata,node_bundles,node_user toneBlue
class node_cli,node_cliinstall,node_clidoctor,node_clipaths,node_validator toneAmber
class node_daemon,node_dashboard,node_wsclient,node_wsservice,node_eventstore toneMint
class node_slackserver,node_slackadmin,node_slackcrypto,node_slackjournal,node_slacklib,node_slackmanifest,node_slacknonce,node_slackdispatch,node_slackpolicy,node_slackdelivery,node_slackstream,node_slacksupervisor toneRose
class node_skills,node_databricks,node_prtospec,node_harness toneIndigo
```

## Components

### Marketplace discovery

- [Marketplace site](https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/marketplace/src): `marketplace/src`
- [Plugin catalog](https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/plugins): `plugins`
- [Download bundles](https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/marketplace): `marketplace`

### Plugin management

- [ccpi CLI](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/cli/src/program.ts): `packages/cli/src/program.ts`
- [Install command](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/cli/src/commands/install.ts): `packages/cli/src/commands/install.ts`
- [Diagnostics](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/cli/src/commands/doctor.ts): `packages/cli/src/commands/doctor.ts`
- [Harness paths](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/cli/src/utils/paths.ts): `packages/cli/src/utils/paths.ts`
- [Skill validation](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/cli/src/commands/validate.ts): `packages/cli/src/commands/validate.ts`

### Usage analytics

- [Analytics daemon](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/analytics-daemon/src/server.ts): `packages/analytics-daemon/src/server.ts`
- [Analytics dashboard](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/analytics-dashboard/src/App.tsx): `packages/analytics-dashboard/src/App.tsx`
- [WebSocket hook](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/analytics-dashboard/src/hooks/useWebSocket.ts): `packages/analytics-dashboard/src/hooks/useWebSocket.ts`
- [WebSocket service](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/analytics-dashboard/src/services/websocket.ts): `packages/analytics-dashboard/src/services/websocket.ts`
- [Event store](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/packages/analytics-dashboard/src/store/analyticsStore.ts): `packages/analytics-dashboard/src/store/analyticsStore.ts`

### Slack MCP

- [Slack MCP server](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/server.ts): `plugins/mcp/slack-channel/server.ts`
- [Admin commands](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/admin.ts): `plugins/mcp/slack-channel/admin.ts`
- [Crypto utilities](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/crypto.ts): `plugins/mcp/slack-channel/crypto.ts`
- [Audit journal](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/journal.ts): `plugins/mcp/slack-channel/journal.ts`
- [Slack helpers](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/lib.ts): `plugins/mcp/slack-channel/lib.ts`
- [Manifest pins](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/manifest.ts): `plugins/mcp/slack-channel/manifest.ts`
- [Nonce HITL](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/nonce-hitl.ts): `plugins/mcp/slack-channel/nonce-hitl.ts`
- [Policy dispatch](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/policy-dispatch.ts): `plugins/mcp/slack-channel/policy-dispatch.ts`
- [Policy rules](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/policy.ts): `plugins/mcp/slack-channel/policy.ts`
- [Slack delivery](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/slack-delivery.ts): `plugins/mcp/slack-channel/slack-delivery.ts`
- [Stream replies](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/stream-reply.ts): `plugins/mcp/slack-channel/stream-reply.ts`
- [Supervisor](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/slack-channel/supervisor.ts): `plugins/mcp/slack-channel/supervisor.ts`

### Skills and integrations

- [Skills corpus](https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/plugins): `plugins`
- [Databricks MCP](https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/main/plugins/mcp/databricks-workspace-mcp/src/tools/pipelines.ts): `plugins/mcp/databricks-workspace-mcp/src/tools/pipelines.ts`
- [PR-to-spec](https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/plugins/mcp/pr-to-spec/src/core): `plugins/mcp/pr-to-spec/src/core`

### Other components

- **Agent user**
- **Claude Code**

## Connections

- Agent user → Marketplace site: browses (evidence: `README.md`)
- Marketplace site → Plugin catalog: lists plugins (evidence: `README.md`)
- Agent user → Download bundles: downloads (evidence: `README.md`)
- Agent user → ccpi CLI: runs commands (evidence: `README.md`)
- ccpi CLI → Install command: dispatches install (evidence: `packages/cli/src/program.ts`)
- ccpi CLI → Diagnostics: dispatches diagnostics (evidence: `packages/cli/src/program.ts`)
- ccpi CLI → Skill validation: dispatches validation (evidence: `packages/cli/src/program.ts`)
- ccpi CLI → Harness paths: detects paths (evidence: `packages/cli/src/program.ts`)
- Install command → Harness paths: uses paths (evidence: `packages/cli/src/commands/install.ts`)
- ccpi CLI → Claude Code: manages plugins (evidence: `README.md`)
- Claude Code → Skills corpus: uses installed skills (evidence: `README.md`)
- Analytics daemon → Analytics dashboard: broadcasts events
- Analytics dashboard → WebSocket hook: starts hook (evidence: `packages/analytics-dashboard/src/App.tsx`)
- WebSocket hook → WebSocket service: connects (evidence: `packages/analytics-dashboard/src/hooks/useWebSocket.ts`)
- WebSocket hook → Event store: records events (evidence: `packages/analytics-dashboard/src/hooks/useWebSocket.ts`)
- Agent user → Slack MCP server: uses Slack tools
- Slack MCP server → Admin commands: dispatches commands (evidence: `plugins/mcp/slack-channel/server.ts`)
- Slack MCP server → Crypto utilities: uses guards (evidence: `plugins/mcp/slack-channel/server.ts`)
- Slack MCP server → Audit journal: verifies journal (evidence: `plugins/mcp/slack-channel/server.ts`)
- Slack MCP server → Slack helpers: uses helpers (evidence: `plugins/mcp/slack-channel/server.ts`)
- Slack MCP server → Manifest pins: finds pins (evidence: `plugins/mcp/slack-channel/server.ts`)
- Slack MCP server → Nonce HITL: uses challenges (evidence: `plugins/mcp/slack-channel/server.ts`)
- Slack MCP server → Policy dispatch: records denials (evidence: `plugins/mcp/slack-channel/server.ts`)
- Slack MCP server → Policy rules: parses rules (evidence: `plugins/mcp/slack-channel/server.ts`)
- Slack MCP server → Slack delivery: sends replies (evidence: `plugins/mcp/slack-channel/server.ts`)
- Slack MCP server → Stream replies: streams replies (evidence: `plugins/mcp/slack-channel/server.ts`)
- Slack MCP server → Supervisor: uses supervisor (evidence: `plugins/mcp/slack-channel/server.ts`)
- Agent user → Databricks MCP: requests pipeline data
- Agent user → PR-to-spec: uses specification tools
