# kykiles/skills architecture

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

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

## Overview

This repository provides Agent Skills for Claude and Codex. The principal workflow is an engineer using a language-specific skill to write, fix, refactor, or test code; the `direktor` skill covers larger tasks through audit, planning, delegated execution, verification, and merge. The README also describes a feedback loop in which lessons are recorded and repeated issues may lead to skill changes through a PR. The supplied tree is limited to evaluation cases, so skill internals and evaluation wiring cannot be verified here.

Main entry points: [`docs/skill-lessons.md`](https://github.com/kykiles/skills/blob/main/docs/skill-lessons.md) (Lesson journal), [`direktor/SKILL.md`](https://github.com/kykiles/skills/blob/main/direktor/SKILL.md) (Direktor), [`rust-zdorovogo-cheloveka/SKILL.md`](https://github.com/kykiles/skills/blob/main/rust-zdorovogo-cheloveka/SKILL.md) (Rust skill), [`go-zdorovogo-cheloveka/SKILL.md`](https://github.com/kykiles/skills/blob/main/go-zdorovogo-cheloveka/SKILL.md) (Go skill)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_skills["Agent skills"]
  node_rust_skill["Rust skill<br/>[SKILL.md]"]
  node_go_skill["Go skill<br/>[SKILL.md]"]
  node_direktor["Direktor<br/>[SKILL.md]"]
end

subgraph group_learning["Skill learning"]
  node_lesson_block["Lessons block<br/>[learning-block.md]"]
  node_lesson_journal["Lesson journal<br/>[skill-lessons.md]"]
  node_lesson_archive["Lesson archive"]
end

subgraph group_evals["Skill evaluations"]
  node_go_evals["Go evaluations"]
  node_rust_evals["Rust evaluations"]
end

node_engineer(("Engineer"))
node_claude(("Claude"))
node_codex(("Codex"))

node_claude -->|"uses skill"| node_rust_skill
node_claude -->|"uses skill"| node_go_skill
node_claude -->|"uses skill"| node_direktor
node_codex -->|"uses skill"| node_rust_skill
node_codex -->|"uses skill"| node_go_skill
node_codex -->|"uses skill"| node_direktor
node_engineer -->|"applies guidance"| node_rust_skill
node_engineer -->|"applies guidance"| node_go_skill
node_engineer -->|"delegates task"| node_direktor
node_direktor -->|"assigns work"| node_engineer
node_engineer -->|"records lessons"| node_lesson_journal
node_lesson_block -->|"guides recording"| node_lesson_journal
node_lesson_journal -->|"archives lessons"| node_lesson_archive
node_lesson_journal -.->|"informs changes"| node_rust_skill
node_lesson_journal -.->|"informs changes"| node_go_skill

click node_rust_skill "https://github.com/kykiles/skills/blob/main/rust-zdorovogo-cheloveka/SKILL.md"
click node_go_skill "https://github.com/kykiles/skills/blob/main/go-zdorovogo-cheloveka/SKILL.md"
click node_direktor "https://github.com/kykiles/skills/blob/main/direktor/SKILL.md"
click node_lesson_block "https://github.com/kykiles/skills/blob/main/docs/learning-block.md"
click node_lesson_journal "https://github.com/kykiles/skills/blob/main/docs/skill-lessons.md"
click node_lesson_archive "https://github.com/kykiles/skills/blob/main/docs/skill-lessons-archive.md"
click node_go_evals "https://github.com/kykiles/skills/tree/main/evals/go-zdorovogo-cheloveka"
click node_rust_evals "https://github.com/kykiles/skills/tree/main/evals/rust-zdorovogo-cheloveka"

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_rust_skill,node_go_skill,node_direktor toneBlue
class node_lesson_block,node_lesson_journal,node_lesson_archive toneAmber
class node_go_evals,node_rust_evals toneMint
class node_engineer,node_claude,node_codex toneIndigo
```

## Components

### Agent skills

- [Rust skill](https://github.com/kykiles/skills/blob/main/rust-zdorovogo-cheloveka/SKILL.md): `rust-zdorovogo-cheloveka/SKILL.md`
- [Go skill](https://github.com/kykiles/skills/blob/main/go-zdorovogo-cheloveka/SKILL.md): `go-zdorovogo-cheloveka/SKILL.md`
- [Direktor](https://github.com/kykiles/skills/blob/main/direktor/SKILL.md): `direktor/SKILL.md`

### Skill learning

- [Lessons block](https://github.com/kykiles/skills/blob/main/docs/learning-block.md): `docs/learning-block.md`
- [Lesson journal](https://github.com/kykiles/skills/blob/main/docs/skill-lessons.md): `docs/skill-lessons.md`
- [Lesson archive](https://github.com/kykiles/skills/blob/main/docs/skill-lessons-archive.md): `docs/skill-lessons-archive.md`

### Skill evaluations

- [Go evaluations](https://github.com/kykiles/skills/tree/main/evals/go-zdorovogo-cheloveka): `evals/go-zdorovogo-cheloveka`
- [Rust evaluations](https://github.com/kykiles/skills/tree/main/evals/rust-zdorovogo-cheloveka): `evals/rust-zdorovogo-cheloveka`

### Other components

- **Engineer**
- **Claude**
- **Codex**

## Connections

- Claude → Rust skill: uses skill (evidence: `README.md`)
- Claude → Go skill: uses skill (evidence: `README.md`)
- Claude → Direktor: uses skill (evidence: `README.md`)
- Codex → Rust skill: uses skill (evidence: `README.md`)
- Codex → Go skill: uses skill (evidence: `README.md`)
- Codex → Direktor: uses skill (evidence: `README.md`)
- Engineer → Rust skill: applies guidance (evidence: `README.md`)
- Engineer → Go skill: applies guidance (evidence: `README.md`)
- Engineer → Direktor: delegates task (evidence: `README.md`)
- Direktor → Engineer: assigns work (evidence: `README.md`)
- Engineer → Lesson journal: records lessons (evidence: `README.md`)
- Lessons block → Lesson journal: guides recording (evidence: `README.md`)
- Lesson journal → Lesson archive: archives lessons (evidence: `README.md`)
- Lesson journal → Rust skill: informs changes (evidence: `README.md`)
- Lesson journal → Go skill: informs changes (evidence: `README.md`)
