# janestreet/agent_skills architecture

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

- Interactive diagram: https://gitdiagram.com/janestreet/agent_skills
- Repository: https://github.com/janestreet/agent_skills

## Overview

This repository provides an agent skill, not a standalone application: its SKILL.md is used to make an AI tutor teach a learner through a Socratic process. The README documents the workflow’s diagnostic, leveled skill map, one-question-at-a-time teaching, spaced review, and final assessment. No skill source excerpt was available, so the graph reflects only those documented capabilities and usage paths.

Main entry points: [`socratic-tutor/SKILL.md`](https://github.com/janestreet/agent_skills/blob/master/socratic-tutor/SKILL.md) (Socratic Tutor Skill)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_learner(("Learner"))
node_agent(("AI Agent or Chatbot"))
node_skill["Socratic Tutor Skill<br/>[SKILL.md]"]
node_diagnostic["Diagnostic<br/>[SKILL.md]"]
node_skill_map["Leveled Skill Map<br/>[SKILL.md]"]
node_guided_teaching["One-at-a-Time Teaching<br/>[SKILL.md]"]
node_spaced_review["Spaced Review<br/>[SKILL.md]"]
node_assessment["Final Assessment<br/>[SKILL.md]"]

node_learner -->|"requests teaching"| node_agent
node_agent -->|"uses skill"| node_skill
node_skill -->|"guides tutoring"| node_agent
node_agent -->|"teaches"| node_learner
node_skill -->|"starts with"| node_diagnostic
node_skill -->|"maps skills"| node_skill_map
node_skill -->|"asks questions"| node_guided_teaching
node_skill -->|"includes review"| node_spaced_review
node_skill -->|"ends with"| node_assessment

click node_skill "https://github.com/janestreet/agent_skills/blob/master/socratic-tutor/SKILL.md"
click node_diagnostic "https://github.com/janestreet/agent_skills/blob/master/socratic-tutor/SKILL.md"
click node_skill_map "https://github.com/janestreet/agent_skills/blob/master/socratic-tutor/SKILL.md"
click node_guided_teaching "https://github.com/janestreet/agent_skills/blob/master/socratic-tutor/SKILL.md"
click node_spaced_review "https://github.com/janestreet/agent_skills/blob/master/socratic-tutor/SKILL.md"
click node_assessment "https://github.com/janestreet/agent_skills/blob/master/socratic-tutor/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_learner,node_agent toneIndigo
class node_skill,node_diagnostic,node_skill_map,node_guided_teaching,node_assessment toneTeal
class node_spaced_review toneBlue
```

## Components

### Other components

- **Learner**
- **AI Agent or Chatbot**
- [Socratic Tutor Skill](https://github.com/janestreet/agent_skills/blob/master/socratic-tutor/SKILL.md): `socratic-tutor/SKILL.md`
- [Diagnostic](https://github.com/janestreet/agent_skills/blob/master/socratic-tutor/SKILL.md): `socratic-tutor/SKILL.md`
- [Leveled Skill Map](https://github.com/janestreet/agent_skills/blob/master/socratic-tutor/SKILL.md): `socratic-tutor/SKILL.md`
- [One-at-a-Time Teaching](https://github.com/janestreet/agent_skills/blob/master/socratic-tutor/SKILL.md): `socratic-tutor/SKILL.md`
- [Spaced Review](https://github.com/janestreet/agent_skills/blob/master/socratic-tutor/SKILL.md): `socratic-tutor/SKILL.md`
- [Final Assessment](https://github.com/janestreet/agent_skills/blob/master/socratic-tutor/SKILL.md): `socratic-tutor/SKILL.md`

## Connections

- Learner → AI Agent or Chatbot: requests teaching (evidence: `README.md`)
- AI Agent or Chatbot → Socratic Tutor Skill: uses skill (evidence: `README.md`)
- Socratic Tutor Skill → AI Agent or Chatbot: guides tutoring (evidence: `README.md`)
- AI Agent or Chatbot → Learner: teaches (evidence: `README.md`)
- Socratic Tutor Skill → Diagnostic: starts with (evidence: `README.md`)
- Socratic Tutor Skill → Leveled Skill Map: maps skills (evidence: `README.md`)
- Socratic Tutor Skill → One-at-a-Time Teaching: asks questions (evidence: `README.md`)
- Socratic Tutor Skill → Spaced Review: includes review (evidence: `README.md`)
- Socratic Tutor Skill → Final Assessment: ends with (evidence: `README.md`)