# caldoai/skills architecture

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

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

## Overview

Caldo Skills is a small catalog of agent skills, distributed through the skills CLI or as a Claude Code plugin marketplace. Its two documented capabilities are untangling codebases and pruning tests. The README describes installation and skill registration, but no skill instructions were excerpted, so their internal behavior and invocation details are not mapped.

Main entry points: [`skills/untangle-codebase/SKILL.md`](https://github.com/caldoai/skills/blob/main/skills/untangle-codebase/SKILL.md) (Untangle codebase), [`skills/prune-tests/SKILL.md`](https://github.com/caldoai/skills/blob/main/skills/prune-tests/SKILL.md) (Prune tests), [`.claude-plugin/marketplace.json`](https://github.com/caldoai/skills/blob/main/.claude-plugin/marketplace.json) (Plugin marketplace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_skills["Agent skills"]
  node_untangle["Untangle codebase<br/>[SKILL.md]"]
  node_prune["Prune tests<br/>[SKILL.md]"]
end

subgraph group_distribution["Distribution"]
  node_marketplace["Plugin marketplace<br/>[marketplace.json]"]
end

node_user(("User"))
node_skills_cli["Skills CLI"]
node_claude_code["Claude Code"]

node_user -->|"installs with"| node_skills_cli
node_skills_cli -->|"installs skill"| node_untangle
node_skills_cli -->|"installs skill"| node_prune
node_user -->|"adds marketplace"| node_claude_code
node_claude_code -->|"loads marketplace"| node_marketplace
node_user -.->|"uses for untangling"| node_untangle
node_user -.->|"uses for pruning"| node_prune

click node_untangle "https://github.com/caldoai/skills/blob/main/skills/untangle-codebase/SKILL.md"
click node_prune "https://github.com/caldoai/skills/blob/main/skills/prune-tests/SKILL.md"
click node_marketplace "https://github.com/caldoai/skills/blob/main/.claude-plugin/marketplace.json"

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_untangle,node_prune,node_user toneBlue
class node_marketplace toneAmber
class node_skills_cli,node_claude_code toneIndigo
```

## Components

### Agent skills

- [Untangle codebase](https://github.com/caldoai/skills/blob/main/skills/untangle-codebase/SKILL.md): `skills/untangle-codebase/SKILL.md`
- [Prune tests](https://github.com/caldoai/skills/blob/main/skills/prune-tests/SKILL.md): `skills/prune-tests/SKILL.md`

### Distribution

- [Plugin marketplace](https://github.com/caldoai/skills/blob/main/.claude-plugin/marketplace.json): `.claude-plugin/marketplace.json`

### Other components

- **User**
- **Skills CLI**
- **Claude Code**

## Connections

- User → Skills CLI: installs with (evidence: `README.md`)
- Skills CLI → Untangle codebase: installs skill (evidence: `README.md`)
- Skills CLI → Prune tests: installs skill (evidence: `README.md`)
- User → Claude Code: adds marketplace (evidence: `README.md`)
- Claude Code → Plugin marketplace: loads marketplace (evidence: `README.md`)
- User → Untangle codebase: uses for untangling
- User → Prune tests: uses for pruning
