# adityavasireddy/agent-skills architecture

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

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

## Overview

This repository is a collection of focused Agent Skills: markdown-based guidance that helps an agent produce a decision record, disciplined task reasoning, a session handoff, or revised prose. The main user workflow is to install a skill and apply it to a task; Crucible supports repeated venture-validation sessions, while Engineering Historian also documents automatic transcript capture and review. The README describes these capabilities, but the implementation excerpts cover only Deslopify’s packaging and validation tooling, which is excluded from this runtime map. Connections therefore reflect documented behavior, not inspected runtime calls.

Main entry points: [`crucible/SKILL.md`](https://github.com/adityavasireddy/agent-skills/blob/main/crucible/SKILL.md) (Crucible skill), [`engineering-historian/SKILL.md`](https://github.com/adityavasireddy/agent-skills/blob/main/engineering-historian/SKILL.md) (Engineering Historian), [`deslopify/SKILL.md`](https://github.com/adityavasireddy/agent-skills/blob/main/deslopify/SKILL.md) (Deslopify skill), [`five-gate-method/SKILL.md`](https://github.com/adityavasireddy/agent-skills/blob/main/five-gate-method/SKILL.md) (Five-gate method)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_venture["Venture validation"]
  node_crucible["Crucible skill<br/>[SKILL.md]"]
  node_assumption_stack["Assumption stack<br/>[SKILL.md]"]
  node_bench["Bench verdict<br/>[SKILL.md]"]
  node_experiment_ledger["Experiment ledger<br/>[SKILL.md]"]
end

subgraph group_task["Task discipline"]
  node_five_gate["Five-gate method<br/>[SKILL.md]"]
end

subgraph group_memory["Engineering memory"]
  node_historian["Engineering Historian<br/>[SKILL.md]"]
  node_capture_review["Capture and review<br/>[SKILL.md]"]
  node_handoff["Session handoff<br/>[SKILL.md]"]
end

subgraph group_communication["Communication skills"]
  node_deslopify["Deslopify skill<br/>[SKILL.md]"]
  node_prose_modes["Prose modes<br/>[SKILL.md]"]
end

node_founder(("Founder or agent"))

node_founder -->|"validates venture"| node_crucible
node_crucible -->|"interrogates idea"| node_assumption_stack
node_crucible -->|"checks argument"| node_bench
node_crucible -->|"records experiment"| node_experiment_ledger
node_experiment_ledger -->|"scores prediction"| node_crucible
node_founder -->|"disciplines task"| node_five_gate
node_founder -->|"captures work"| node_historian
node_historian -->|"drafts records"| node_capture_review
node_founder -->|"preserves context"| node_handoff
node_founder -->|"improves prose"| node_deslopify
node_deslopify -->|"edits drafts audits"| node_prose_modes

click node_crucible "https://github.com/adityavasireddy/agent-skills/blob/main/crucible/SKILL.md"
click node_assumption_stack "https://github.com/adityavasireddy/agent-skills/blob/main/crucible/SKILL.md"
click node_bench "https://github.com/adityavasireddy/agent-skills/blob/main/crucible/SKILL.md"
click node_experiment_ledger "https://github.com/adityavasireddy/agent-skills/blob/main/crucible/SKILL.md"
click node_five_gate "https://github.com/adityavasireddy/agent-skills/blob/main/five-gate-method/SKILL.md"
click node_historian "https://github.com/adityavasireddy/agent-skills/blob/main/engineering-historian/SKILL.md"
click node_capture_review "https://github.com/adityavasireddy/agent-skills/blob/main/engineering-historian/SKILL.md"
click node_handoff "https://github.com/adityavasireddy/agent-skills/blob/main/session-handoff/SKILL.md"
click node_deslopify "https://github.com/adityavasireddy/agent-skills/blob/main/deslopify/SKILL.md"
click node_prose_modes "https://github.com/adityavasireddy/agent-skills/blob/main/deslopify/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_crucible,node_assumption_stack,node_bench,node_experiment_ledger toneBlue
class node_five_gate toneAmber
class node_historian,node_capture_review,node_handoff toneMint
class node_deslopify,node_prose_modes toneRose
class node_founder toneIndigo
```

## Components

### Venture validation

- [Crucible skill](https://github.com/adityavasireddy/agent-skills/blob/main/crucible/SKILL.md): `crucible/SKILL.md`
- [Assumption stack](https://github.com/adityavasireddy/agent-skills/blob/main/crucible/SKILL.md): `crucible/SKILL.md`
- [Bench verdict](https://github.com/adityavasireddy/agent-skills/blob/main/crucible/SKILL.md): `crucible/SKILL.md`
- [Experiment ledger](https://github.com/adityavasireddy/agent-skills/blob/main/crucible/SKILL.md): `crucible/SKILL.md`

### Task discipline

- [Five-gate method](https://github.com/adityavasireddy/agent-skills/blob/main/five-gate-method/SKILL.md): `five-gate-method/SKILL.md`

### Engineering memory

- [Engineering Historian](https://github.com/adityavasireddy/agent-skills/blob/main/engineering-historian/SKILL.md): `engineering-historian/SKILL.md`
- [Capture and review](https://github.com/adityavasireddy/agent-skills/blob/main/engineering-historian/SKILL.md): `engineering-historian/SKILL.md`
- [Session handoff](https://github.com/adityavasireddy/agent-skills/blob/main/session-handoff/SKILL.md): `session-handoff/SKILL.md`

### Communication skills

- [Deslopify skill](https://github.com/adityavasireddy/agent-skills/blob/main/deslopify/SKILL.md): `deslopify/SKILL.md`
- [Prose modes](https://github.com/adityavasireddy/agent-skills/blob/main/deslopify/SKILL.md): `deslopify/SKILL.md`

### Other components

- **Founder or agent**

## Connections

- Founder or agent → Crucible skill: validates venture (evidence: `README.md`)
- Crucible skill → Assumption stack: interrogates idea (evidence: `README.md`)
- Crucible skill → Bench verdict: checks argument (evidence: `README.md`)
- Crucible skill → Experiment ledger: records experiment (evidence: `README.md`)
- Experiment ledger → Crucible skill: scores prediction (evidence: `README.md`)
- Founder or agent → Five-gate method: disciplines task (evidence: `README.md`)
- Founder or agent → Engineering Historian: captures work (evidence: `README.md`)
- Engineering Historian → Capture and review: drafts records (evidence: `README.md`)
- Founder or agent → Session handoff: preserves context (evidence: `README.md`)
- Founder or agent → Deslopify skill: improves prose (evidence: `README.md`)
- Deslopify skill → Prose modes: edits drafts audits (evidence: `README.md`)