# borghei/claude-skills architecture

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

- Interactive diagram: https://gitdiagram.com/borghei/claude-skills
- Repository: https://github.com/borghei/claude-skills

## Overview

Claude Skills is a cross-domain library of AI-assisted workflows, runnable tools, expert personas, and installable skill bundles. Users discover skills through the site or CLI, then try them in an AI chat or install them for a supported assistant; the assistant uses the selected skill to produce workflow outputs. The README documents broader capabilities such as compliance packs, orchestration patterns, and evaluation rubrics. Sampled source confirms CLI routing, manifest-backed search, site filtering, and examples of standalone tools; connections among unsampled skill content and personas are documented capabilities, not inferred code calls.

Main entry points: [`cli/src/index.js`](https://github.com/borghei/claude-skills/blob/main/cli/src/index.js) (CLI entry), [`engineering`](https://github.com/borghei/claude-skills/tree/main/engineering) (Skill library), [`cli/src/commands`](https://github.com/borghei/claude-skills/tree/main/cli/src/commands) (Install/update commands), [`engineering/rag-architect`](https://github.com/borghei/claude-skills/tree/main/engineering/rag-architect) (Runnable tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Skill discovery"]
  node_web_catalog["Web catalog"]
  node_site_search["Site search/filter<br/>[main.js]"]
  node_cli["CLI entry<br/>[index.js]"]
  node_cli_search["CLI search<br/>[search.js]"]
  node_manifest["Skill manifest<br/>[manifest.js]"]
  node_cli_install["Install/update commands"]
end

subgraph group_library["Skills and tools"]
  node_library_content["Skill library"]
  node_domains["Domain skills"]
  node_tools["Runnable tools"]
  node_personas["Expert personas"]
  node_bundles["Role bundles"]
  node_rag_design["RAG design tool"]
end

subgraph group_assistant["Assistant usage"]
  node_target_ai(("AI assistant"))
  node_skill_runtime["Skill-guided workflow"]
  node_outputs["Workflow outputs"]
  node_orchestration["Agent orchestration"]
end

subgraph group_quality["Workflow quality"]
  node_rubrics["Scoring rubrics"]
  node_evaluator["Rubric evaluator<br/>[engine.py]"]
  node_retrieval_eval["Retrieval evaluation"]
end

node_user(("User"))

node_user -->|"browses skills"| node_web_catalog
node_web_catalog -->|"filters cards"| node_site_search
node_user -->|"runs command"| node_cli
node_cli -->|"dispatches search"| node_cli_search
node_cli_search -->|"loads skills"| node_manifest
node_user -->|"requests install"| node_cli_install
node_cli -->|"dispatches command"| node_cli_install
node_user -->|"selects skill"| node_library_content
node_library_content -->|"organizes workflows"| node_domains
node_user -->|"tries or installs"| node_target_ai
node_target_ai -->|"uses skill"| node_skill_runtime
node_library_content -->|"guides workflow"| node_skill_runtime
node_skill_runtime -->|"produces results"| node_outputs
node_personas -->|"combines skills"| node_skill_runtime
node_bundles -.->|"guides installation"| node_cli_install
node_orchestration -.->|"defines patterns"| node_skill_runtime
node_rubrics -->|"supplies criteria"| node_evaluator
node_user -->|"evaluates artifact"| node_evaluator
node_tools -->|"includes tool"| node_rag_design
node_tools -->|"includes tool"| node_retrieval_eval

click node_library_content "https://github.com/borghei/claude-skills/tree/main/engineering"
click node_domains "https://github.com/borghei/claude-skills/tree/main/business-growth"
click node_tools "https://github.com/borghei/claude-skills/tree/main/engineering/rag-architect"
click node_personas "https://github.com/borghei/claude-skills/tree/main/c-level-advisor"
click node_web_catalog "https://github.com/borghei/claude-skills/tree/main/site"
click node_site_search "https://github.com/borghei/claude-skills/blob/main/site/js/main.js"
click node_cli "https://github.com/borghei/claude-skills/blob/main/cli/src/index.js"
click node_cli_search "https://github.com/borghei/claude-skills/blob/main/cli/src/commands/search.js"
click node_manifest "https://github.com/borghei/claude-skills/blob/main/cli/src/manifest.js"
click node_cli_install "https://github.com/borghei/claude-skills/tree/main/cli/src/commands"
click node_orchestration "https://github.com/borghei/claude-skills/tree/main/standards"
click node_rubrics "https://github.com/borghei/claude-skills/tree/main/evals"
click node_evaluator "https://github.com/borghei/claude-skills/blob/main/evals/engine.py"
click node_rag_design "https://github.com/borghei/claude-skills/blob/main/engineering/rag-architect/rag_pipeline_designer.py"
click node_retrieval_eval "https://github.com/borghei/claude-skills/blob/main/engineering/rag-architect/retrieval_evaluator.py"

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_web_catalog,node_site_search,node_cli,node_cli_search,node_manifest,node_cli_install,node_user toneBlue
class node_library_content,node_domains,node_tools,node_personas,node_bundles,node_rag_design toneAmber
class node_target_ai,node_skill_runtime,node_outputs,node_orchestration toneMint
class node_rubrics,node_evaluator,node_retrieval_eval toneRose
```

## Components

### Skill discovery

- [Web catalog](https://github.com/borghei/claude-skills/tree/main/site): `site`
- [Site search/filter](https://github.com/borghei/claude-skills/blob/main/site/js/main.js): `site/js/main.js`
- [CLI entry](https://github.com/borghei/claude-skills/blob/main/cli/src/index.js): `cli/src/index.js`
- [CLI search](https://github.com/borghei/claude-skills/blob/main/cli/src/commands/search.js): `cli/src/commands/search.js`
- [Skill manifest](https://github.com/borghei/claude-skills/blob/main/cli/src/manifest.js): `cli/src/manifest.js`
- [Install/update commands](https://github.com/borghei/claude-skills/tree/main/cli/src/commands): `cli/src/commands`

### Skills and tools

- [Skill library](https://github.com/borghei/claude-skills/tree/main/engineering): `engineering`
- [Domain skills](https://github.com/borghei/claude-skills/tree/main/business-growth): `business-growth`
- [Runnable tools](https://github.com/borghei/claude-skills/tree/main/engineering/rag-architect): `engineering/rag-architect`
- [Expert personas](https://github.com/borghei/claude-skills/tree/main/c-level-advisor): `c-level-advisor`
- **Role bundles**
- [RAG design tool](https://github.com/borghei/claude-skills/blob/main/engineering/rag-architect/rag_pipeline_designer.py): `engineering/rag-architect/rag_pipeline_designer.py`

### Assistant usage

- **AI assistant**
- **Skill-guided workflow**
- **Workflow outputs**
- [Agent orchestration](https://github.com/borghei/claude-skills/tree/main/standards): `standards`

### Workflow quality

- [Scoring rubrics](https://github.com/borghei/claude-skills/tree/main/evals): `evals`
- [Rubric evaluator](https://github.com/borghei/claude-skills/blob/main/evals/engine.py): `evals/engine.py`
- [Retrieval evaluation](https://github.com/borghei/claude-skills/blob/main/engineering/rag-architect/retrieval_evaluator.py): `engineering/rag-architect/retrieval_evaluator.py`

### Other components

- **User**

## Connections

- User → Web catalog: browses skills
- Web catalog → Site search/filter: filters cards
- User → CLI entry: runs command
- CLI entry → CLI search: dispatches search
- CLI search → Skill manifest: loads skills
- User → Install/update commands: requests install
- CLI entry → Install/update commands: dispatches command
- User → Skill library: selects skill
- Skill library → Domain skills: organizes workflows
- User → AI assistant: tries or installs
- AI assistant → Skill-guided workflow: uses skill
- Skill library → Skill-guided workflow: guides workflow
- Skill-guided workflow → Workflow outputs: produces results
- Expert personas → Skill-guided workflow: combines skills
- Role bundles → Install/update commands: guides installation
- Agent orchestration → Skill-guided workflow: defines patterns
- Scoring rubrics → Rubric evaluator: supplies criteria
- User → Rubric evaluator: evaluates artifact
- Runnable tools → RAG design tool: includes tool
- Runnable tools → Retrieval evaluation: includes tool