# simota/agent-skills architecture

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

## Overview

This repository distributes reusable AI-agent skills, with Nexus presented as the orchestrator for a user’s task. The documented flow is a user invoking a skill, Nexus coordinating specialist work, and the skill producing an artifact such as an investigation report or implementation. The README also identifies project-local Orbit, Darwin, and Lore extensions. Source excerpts mainly cover repository-maintenance scripts, not skill runtime internals, so the graph focuses on documented product relationships and does not infer implementation details.

Main entry points: [`scout`](https://github.com/simota/agent-skills/tree/main/scout) (Global Skills), [`nexus`](https://github.com/simota/agent-skills/tree/main/nexus) (Nexus), [`.agents/skills/orbit/SKILL.md`](https://github.com/simota/agent-skills/blob/main/.agents/skills/orbit/SKILL.md) (Orbit), [`.agents/skills/darwin/SKILL.md`](https://github.com/simota/agent-skills/blob/main/.agents/skills/darwin/SKILL.md) (Darwin)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Task Orchestration"]
  node_nexus["Nexus"]
end

subgraph group_specialists["Reusable Specialists"]
  node_global_skills["Global Skills"]
end

subgraph group_local["Local Extensions"]
  node_orbit["Orbit<br/>[SKILL.md]"]
  node_darwin["Darwin<br/>[SKILL.md]"]
  node_lore["Lore<br/>[SKILL.md]"]
end

node_user(("User"))
node_result["Task Output"]

node_user -->|"invokes"| node_nexus
node_user -->|"invokes"| node_global_skills
node_nexus -->|"coordinates"| node_global_skills
node_global_skills -->|"produces"| node_result
node_user -.->|"invokes"| node_orbit
node_user -.->|"invokes"| node_darwin
node_user -.->|"invokes"| node_lore

click node_nexus "https://github.com/simota/agent-skills/tree/main/nexus"
click node_global_skills "https://github.com/simota/agent-skills/tree/main/scout"
click node_orbit "https://github.com/simota/agent-skills/blob/main/.agents/skills/orbit/SKILL.md"
click node_darwin "https://github.com/simota/agent-skills/blob/main/.agents/skills/darwin/SKILL.md"
click node_lore "https://github.com/simota/agent-skills/blob/main/.agents/skills/lore/SKILL.md"

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_nexus,node_user toneBlue
class node_global_skills toneAmber
class node_orbit,node_darwin,node_lore toneMint
class node_result toneRose
```

## Components

### Task Orchestration

- [Nexus](https://github.com/simota/agent-skills/tree/main/nexus): `nexus`

### Reusable Specialists

- [Global Skills](https://github.com/simota/agent-skills/tree/main/scout): `scout`

### Local Extensions

- [Orbit](https://github.com/simota/agent-skills/blob/main/.agents/skills/orbit/SKILL.md): `.agents/skills/orbit/SKILL.md`
- [Darwin](https://github.com/simota/agent-skills/blob/main/.agents/skills/darwin/SKILL.md): `.agents/skills/darwin/SKILL.md`
- [Lore](https://github.com/simota/agent-skills/blob/main/.agents/skills/lore/SKILL.md): `.agents/skills/lore/SKILL.md`

### Other components

- **User**
- **Task Output**

## Connections

- User → Nexus: invokes (evidence: `README.md`)
- User → Global Skills: invokes (evidence: `README.md`)
- Nexus → Global Skills: coordinates (evidence: `README.md`)
- Global Skills → Task Output: produces (evidence: `README.md`)
- User → Orbit: invokes (evidence: `README.md`)
- User → Darwin: invokes (evidence: `README.md`)
- User → Lore: invokes (evidence: `README.md`)
