# bootloops-ai/skills architecture

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

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

## Overview

BootLoops skills is a library of standalone research protocols for agents, with two plugin bundles as distribution routes. A user either selects skills through the Claude setup skill or installs a plugin; the agent then loads and follows the chosen instructions to produce more checkable scientific work. The README documents these routes and the skills’ scope. Individual skill instructions were not sampled, so their internal steps and interactions are not mapped.

Main entry points: [`plugins/bootloops-protocols`](https://github.com/bootloops-ai/skills/tree/main/plugins/bootloops-protocols) (Protocols plugin), [`plugins/bootloops-research`](https://github.com/bootloops-ai/skills/tree/main/plugins/bootloops-research) (Research plugin), [`.claude-plugin/marketplace.json`](https://github.com/bootloops-ai/skills/blob/main/.claude-plugin/marketplace.json) (Claude marketplace), [`.agents/plugins/marketplace.json`](https://github.com/bootloops-ai/skills/blob/main/.agents/plugins/marketplace.json) (Codex marketplace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_protocols["Protocol layer"]
  node_protocol_catalog["Protocol skills"]
  node_acceptance["Acceptance gate<br/>[SKILL.md]"]
  node_constants["Constant recognition<br/>[SKILL.md]"]
  node_planted["Planted truth<br/>[SKILL.md]"]
  node_independence["Independence bookkeeping<br/>[SKILL.md]"]
  node_timing["Timing discipline<br/>[SKILL.md]"]
  node_reading["Reading contract<br/>[SKILL.md]"]
  node_tool_stewardship["Tool stewardship<br/>[SKILL.md]"]
end

subgraph group_research["Research skills"]
  node_research_catalog["Research skills"]
  node_prove["Prove protocol<br/>[SKILL.md]"]
  node_referee["Referee simulation<br/>[SKILL.md]"]
  node_literature["Literature review<br/>[SKILL.md]"]
  node_references["Reference check<br/>[SKILL.md]"]
  node_prose["Prose lint<br/>[SKILL.md]"]
end

subgraph group_distribution["Distribution"]
  node_setup["Setup skill<br/>[SKILL.md]"]
  node_protocol_plugin["Protocols plugin"]
  node_research_plugin["Research plugin"]
  node_claude_marketplace["Claude marketplace<br/>[marketplace.json]"]
  node_codex_marketplace["Codex marketplace<br/>[marketplace.json]"]
end

node_user(("User"))
node_agent(("AI agent"))

node_user -->|"opens clone"| node_setup
node_setup -->|"offers selection"| node_user
node_user -->|"selects skills"| node_protocol_catalog
node_protocol_catalog -->|"loads directly"| node_agent
node_user -->|"adds marketplace"| node_claude_marketplace
node_user -->|"adds marketplace"| node_codex_marketplace
node_claude_marketplace -->|"offers install"| node_protocol_plugin
node_claude_marketplace -->|"offers install"| node_research_plugin
node_codex_marketplace -->|"offers install"| node_protocol_plugin
node_codex_marketplace -->|"offers install"| node_research_plugin
node_user -->|"installs plugin"| node_protocol_plugin
node_user -->|"installs plugin"| node_research_plugin
node_protocol_plugin -->|"provides skills"| node_agent
node_research_plugin -->|"provides skills"| node_agent
node_agent -->|"follows protocol"| node_acceptance
node_agent -->|"follows protocol"| node_constants
node_agent -->|"follows protocol"| node_planted
node_agent -->|"follows protocol"| node_independence
node_agent -->|"follows protocol"| node_timing
node_agent -->|"follows protocol"| node_reading
node_agent -->|"follows protocol"| node_tool_stewardship
node_agent -->|"follows protocol"| node_prove
node_agent -->|"follows protocol"| node_referee
node_agent -->|"follows protocol"| node_literature
node_agent -->|"follows protocol"| node_references
node_agent -->|"follows protocol"| node_prose

click node_protocol_catalog "https://github.com/bootloops-ai/skills/tree/main/skills"
click node_acceptance "https://github.com/bootloops-ai/skills/blob/main/skills/acceptance-gate/SKILL.md"
click node_constants "https://github.com/bootloops-ai/skills/blob/main/skills/constant-recognition/SKILL.md"
click node_planted "https://github.com/bootloops-ai/skills/blob/main/skills/planted-truth/SKILL.md"
click node_independence "https://github.com/bootloops-ai/skills/blob/main/skills/independence-bookkeeping/SKILL.md"
click node_timing "https://github.com/bootloops-ai/skills/blob/main/skills/timing-discipline/SKILL.md"
click node_reading "https://github.com/bootloops-ai/skills/blob/main/skills/reading-contract/SKILL.md"
click node_tool_stewardship "https://github.com/bootloops-ai/skills/blob/main/skills/tool-stewardship/SKILL.md"
click node_research_catalog "https://github.com/bootloops-ai/skills/tree/main/plugins/bootloops-research/skills"
click node_prove "https://github.com/bootloops-ai/skills/blob/main/skills/prove-protocol/SKILL.md"
click node_referee "https://github.com/bootloops-ai/skills/blob/main/skills/referee-sim/SKILL.md"
click node_literature "https://github.com/bootloops-ai/skills/blob/main/skills/lit-review/SKILL.md"
click node_references "https://github.com/bootloops-ai/skills/blob/main/skills/ref-check/SKILL.md"
click node_prose "https://github.com/bootloops-ai/skills/blob/main/skills/prose-lint/SKILL.md"
click node_setup "https://github.com/bootloops-ai/skills/blob/main/.claude/skills/bootloops-setup/SKILL.md"
click node_protocol_plugin "https://github.com/bootloops-ai/skills/tree/main/plugins/bootloops-protocols"
click node_research_plugin "https://github.com/bootloops-ai/skills/tree/main/plugins/bootloops-research"
click node_claude_marketplace "https://github.com/bootloops-ai/skills/blob/main/.claude-plugin/marketplace.json"
click node_codex_marketplace "https://github.com/bootloops-ai/skills/blob/main/.agents/plugins/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_protocol_catalog,node_acceptance,node_constants,node_planted,node_independence,node_timing,node_reading,node_tool_stewardship,node_user toneBlue
class node_research_catalog,node_prove,node_referee,node_literature,node_references,node_prose toneAmber
class node_setup,node_protocol_plugin,node_research_plugin,node_claude_marketplace,node_codex_marketplace toneMint
class node_agent toneIndigo
```

## Components

### Protocol layer

- [Protocol skills](https://github.com/bootloops-ai/skills/tree/main/skills): `skills`
- [Acceptance gate](https://github.com/bootloops-ai/skills/blob/main/skills/acceptance-gate/SKILL.md): `skills/acceptance-gate/SKILL.md`
- [Constant recognition](https://github.com/bootloops-ai/skills/blob/main/skills/constant-recognition/SKILL.md): `skills/constant-recognition/SKILL.md`
- [Planted truth](https://github.com/bootloops-ai/skills/blob/main/skills/planted-truth/SKILL.md): `skills/planted-truth/SKILL.md`
- [Independence bookkeeping](https://github.com/bootloops-ai/skills/blob/main/skills/independence-bookkeeping/SKILL.md): `skills/independence-bookkeeping/SKILL.md`
- [Timing discipline](https://github.com/bootloops-ai/skills/blob/main/skills/timing-discipline/SKILL.md): `skills/timing-discipline/SKILL.md`
- [Reading contract](https://github.com/bootloops-ai/skills/blob/main/skills/reading-contract/SKILL.md): `skills/reading-contract/SKILL.md`
- [Tool stewardship](https://github.com/bootloops-ai/skills/blob/main/skills/tool-stewardship/SKILL.md): `skills/tool-stewardship/SKILL.md`

### Research skills

- [Research skills](https://github.com/bootloops-ai/skills/tree/main/plugins/bootloops-research/skills): `plugins/bootloops-research/skills`
- [Prove protocol](https://github.com/bootloops-ai/skills/blob/main/skills/prove-protocol/SKILL.md): `skills/prove-protocol/SKILL.md`
- [Referee simulation](https://github.com/bootloops-ai/skills/blob/main/skills/referee-sim/SKILL.md): `skills/referee-sim/SKILL.md`
- [Literature review](https://github.com/bootloops-ai/skills/blob/main/skills/lit-review/SKILL.md): `skills/lit-review/SKILL.md`
- [Reference check](https://github.com/bootloops-ai/skills/blob/main/skills/ref-check/SKILL.md): `skills/ref-check/SKILL.md`
- [Prose lint](https://github.com/bootloops-ai/skills/blob/main/skills/prose-lint/SKILL.md): `skills/prose-lint/SKILL.md`

### Distribution

- [Setup skill](https://github.com/bootloops-ai/skills/blob/main/.claude/skills/bootloops-setup/SKILL.md): `.claude/skills/bootloops-setup/SKILL.md`
- [Protocols plugin](https://github.com/bootloops-ai/skills/tree/main/plugins/bootloops-protocols): `plugins/bootloops-protocols`
- [Research plugin](https://github.com/bootloops-ai/skills/tree/main/plugins/bootloops-research): `plugins/bootloops-research`
- [Claude marketplace](https://github.com/bootloops-ai/skills/blob/main/.claude-plugin/marketplace.json): `.claude-plugin/marketplace.json`
- [Codex marketplace](https://github.com/bootloops-ai/skills/blob/main/.agents/plugins/marketplace.json): `.agents/plugins/marketplace.json`

### Other components

- **User**
- **AI agent**

## Connections

- User → Setup skill: opens clone (evidence: `README.md`)
- Setup skill → User: offers selection (evidence: `README.md`)
- User → Protocol skills: selects skills (evidence: `README.md`)
- Protocol skills → AI agent: loads directly (evidence: `README.md`)
- User → Claude marketplace: adds marketplace (evidence: `README.md`)
- User → Codex marketplace: adds marketplace (evidence: `README.md`)
- Claude marketplace → Protocols plugin: offers install (evidence: `README.md`)
- Claude marketplace → Research plugin: offers install (evidence: `README.md`)
- Codex marketplace → Protocols plugin: offers install (evidence: `README.md`)
- Codex marketplace → Research plugin: offers install (evidence: `README.md`)
- User → Protocols plugin: installs plugin (evidence: `README.md`)
- User → Research plugin: installs plugin (evidence: `README.md`)
- Protocols plugin → AI agent: provides skills (evidence: `README.md`)
- Research plugin → AI agent: provides skills (evidence: `README.md`)
- AI agent → Acceptance gate: follows protocol (evidence: `README.md`)
- AI agent → Constant recognition: follows protocol (evidence: `README.md`)
- AI agent → Planted truth: follows protocol (evidence: `README.md`)
- AI agent → Independence bookkeeping: follows protocol (evidence: `README.md`)
- AI agent → Timing discipline: follows protocol (evidence: `README.md`)
- AI agent → Reading contract: follows protocol (evidence: `README.md`)
- AI agent → Tool stewardship: follows protocol (evidence: `README.md`)
- AI agent → Prove protocol: follows protocol (evidence: `README.md`)
- AI agent → Referee simulation: follows protocol (evidence: `README.md`)
- AI agent → Literature review: follows protocol (evidence: `README.md`)
- AI agent → Reference check: follows protocol (evidence: `README.md`)
- AI agent → Prose lint: follows protocol (evidence: `README.md`)
