# kkkkhazix/khazix-skills architecture

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

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

## Overview

Khazix Skills is a collection of six Agent Skills: structured instructions and supporting references that guide an AI agent from a user request to a research, writing, maintenance, information-retrieval, or storage-analysis result. The clearest implemented runtime is storage-analyzer: read-only scanning, agent-led interpretation, report generation, and guarded browser actions. Other skills’ capabilities are documented in the README, but their instruction files were not sampled; those branches are therefore shown at skill level, with relationships based on documentation rather than assumed internal calls.

Main entry points: [`storage-analyzer/scripts/server.py`](https://github.com/kkkkhazix/khazix-skills/blob/main/storage-analyzer/scripts/server.py) (Action server), [`storage-analyzer/scripts/scan.py`](https://github.com/kkkkhazix/khazix-skills/blob/main/storage-analyzer/scripts/scan.py) (Disk scanner), [`aihot/SKILL.md`](https://github.com/kkkkhazix/khazix-skills/blob/main/aihot/SKILL.md) (AI news queries), [`storage-analyzer/scripts/build_report.py`](https://github.com/kkkkhazix/khazix-skills/blob/main/storage-analyzer/scripts/build_report.py) (Static report builder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storage["Storage analysis"]
  node_storage_skill["Storage workflow<br/>[SKILL.md]"]
  node_scanner["Disk scanner<br/>[scan.py]"]
  node_analysis["Scan interpretation"]
  node_report_builder["Static report builder<br/>[build_report.py]"]
  node_report_template["Interactive report"]
  node_report_server["Action server<br/>[server.py]"]
end

subgraph group_knowledge["Project knowledge"]
  node_neat_skill["Knowledge closeout<br/>[SKILL.md]"]
  node_neat_refs["Governance guidance"]
  node_leader_skill["Goal definition<br/>[SKILL.md]"]
end

subgraph group_research["Research and writing"]
  node_hv_skill["Long-form research<br/>[SKILL.md]"]
  node_hv_pdf["PDF formatter<br/>[md_to_pdf.py]"]
  node_hv_schema["Research schema<br/>[schema.json]"]
  node_writer_skill["Style-guided writing<br/>[SKILL.md]"]
  node_writer_refs["Style references"]
end

subgraph group_news["AI news"]
  node_aihot_skill["AI news queries<br/>[SKILL.md]"]
  node_local_sync[("Local sync data<br/>[sync.md]")]
end

node_user(("User"))
node_agent(("AI agent"))
node_local_files[("Local filesystem")]
node_browser(("Browser"))
node_project_docs["Project knowledge"]
node_agent_memory[("Agent memory")]
node_aihot_service["AI HOT service"]

node_user -->|"requests help"| node_agent
node_agent -->|"uses instructions"| node_storage_skill
node_storage_skill -->|"guides scanning"| node_scanner
node_agent -.->|"runs scan"| node_scanner
node_scanner -->|"reads sizes"| node_local_files
node_scanner -->|"emits JSON"| node_analysis
node_agent -->|"classifies results"| node_analysis
node_analysis -->|"provides JSON"| node_report_builder
node_report_builder -->|"injects data"| node_report_template
node_report_server -->|"serves report"| node_report_template
node_report_server -->|"opens report"| node_browser
node_browser -->|"posts actions"| node_report_server
node_report_server -->|"opens or deletes"| node_local_files
node_agent -.->|"builds report"| node_report_builder
node_agent -.->|"serves report"| node_report_server
node_user -->|"requests closeout"| node_neat_skill
node_neat_skill -->|"uses guidance"| node_neat_refs
node_agent -->|"aligns documentation"| node_project_docs
node_agent -->|"aligns memory"| node_agent_memory
node_user -->|"shares an idea"| node_leader_skill
node_leader_skill -->|"defines a goal"| node_agent
node_user -->|"requests research"| node_hv_skill
node_hv_skill -.->|"structures research"| node_hv_schema
node_agent -.->|"converts report"| node_hv_pdf
node_user -->|"requests article"| node_writer_skill
node_writer_skill -->|"uses examples"| node_writer_refs
node_user -->|"asks for news"| node_aihot_skill
node_aihot_skill -->|"queries news"| node_aihot_service
node_aihot_skill -->|"syncs selections"| node_local_sync

click node_storage_skill "https://github.com/kkkkhazix/khazix-skills/blob/main/storage-analyzer/SKILL.md"
click node_scanner "https://github.com/kkkkhazix/khazix-skills/blob/main/storage-analyzer/scripts/scan.py"
click node_report_builder "https://github.com/kkkkhazix/khazix-skills/blob/main/storage-analyzer/scripts/build_report.py"
click node_report_template "https://github.com/kkkkhazix/khazix-skills/blob/main/storage-analyzer/assets/report_template.html"
click node_report_server "https://github.com/kkkkhazix/khazix-skills/blob/main/storage-analyzer/scripts/server.py"
click node_neat_skill "https://github.com/kkkkhazix/khazix-skills/blob/main/neat-freak/SKILL.md"
click node_neat_refs "https://github.com/kkkkhazix/khazix-skills/tree/main/neat-freak/references"
click node_leader_skill "https://github.com/kkkkhazix/khazix-skills/blob/main/leader/SKILL.md"
click node_hv_skill "https://github.com/kkkkhazix/khazix-skills/blob/main/hv-analysis/SKILL.md"
click node_hv_pdf "https://github.com/kkkkhazix/khazix-skills/blob/main/hv-analysis/scripts/md_to_pdf.py"
click node_hv_schema "https://github.com/kkkkhazix/khazix-skills/blob/main/hv-analysis/references/schema.json"
click node_writer_skill "https://github.com/kkkkhazix/khazix-skills/blob/main/khazix-writer/SKILL.md"
click node_writer_refs "https://github.com/kkkkhazix/khazix-skills/tree/main/khazix-writer/references"
click node_aihot_skill "https://github.com/kkkkhazix/khazix-skills/blob/main/aihot/SKILL.md"
click node_local_sync "https://github.com/kkkkhazix/khazix-skills/blob/main/aihot/references/sync.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_storage_skill,node_scanner,node_analysis,node_report_builder,node_report_template,node_report_server,node_user,node_browser toneBlue
class node_neat_skill,node_neat_refs,node_leader_skill,node_local_files,node_agent_memory toneAmber
class node_hv_skill,node_hv_pdf,node_hv_schema,node_writer_skill,node_writer_refs toneMint
class node_aihot_skill,node_local_sync toneRose
class node_agent,node_project_docs,node_aihot_service toneIndigo
```

## Components

### Storage analysis

- [Storage workflow](https://github.com/kkkkhazix/khazix-skills/blob/main/storage-analyzer/SKILL.md): `storage-analyzer/SKILL.md`
- [Disk scanner](https://github.com/kkkkhazix/khazix-skills/blob/main/storage-analyzer/scripts/scan.py): `storage-analyzer/scripts/scan.py`
- **Scan interpretation**
- [Static report builder](https://github.com/kkkkhazix/khazix-skills/blob/main/storage-analyzer/scripts/build_report.py): `storage-analyzer/scripts/build_report.py`
- [Interactive report](https://github.com/kkkkhazix/khazix-skills/blob/main/storage-analyzer/assets/report_template.html): `storage-analyzer/assets/report_template.html`
- [Action server](https://github.com/kkkkhazix/khazix-skills/blob/main/storage-analyzer/scripts/server.py): `storage-analyzer/scripts/server.py`

### Project knowledge

- [Knowledge closeout](https://github.com/kkkkhazix/khazix-skills/blob/main/neat-freak/SKILL.md): `neat-freak/SKILL.md`
- [Governance guidance](https://github.com/kkkkhazix/khazix-skills/tree/main/neat-freak/references): `neat-freak/references`
- [Goal definition](https://github.com/kkkkhazix/khazix-skills/blob/main/leader/SKILL.md): `leader/SKILL.md`

### Research and writing

- [Long-form research](https://github.com/kkkkhazix/khazix-skills/blob/main/hv-analysis/SKILL.md): `hv-analysis/SKILL.md`
- [PDF formatter](https://github.com/kkkkhazix/khazix-skills/blob/main/hv-analysis/scripts/md_to_pdf.py): `hv-analysis/scripts/md_to_pdf.py`
- [Research schema](https://github.com/kkkkhazix/khazix-skills/blob/main/hv-analysis/references/schema.json): `hv-analysis/references/schema.json`
- [Style-guided writing](https://github.com/kkkkhazix/khazix-skills/blob/main/khazix-writer/SKILL.md): `khazix-writer/SKILL.md`
- [Style references](https://github.com/kkkkhazix/khazix-skills/tree/main/khazix-writer/references): `khazix-writer/references`

### AI news

- [AI news queries](https://github.com/kkkkhazix/khazix-skills/blob/main/aihot/SKILL.md): `aihot/SKILL.md`
- [Local sync data](https://github.com/kkkkhazix/khazix-skills/blob/main/aihot/references/sync.md): `aihot/references/sync.md`

### Other components

- **User**
- **AI agent**
- **Local filesystem**
- **Browser**
- **Project knowledge**
- **Agent memory**
- **AI HOT service**

## Connections

- User → AI agent: requests help (evidence: `README.md`)
- AI agent → Storage workflow: uses instructions (evidence: `README.md`)
- Storage workflow → Disk scanner: guides scanning (evidence: `README.md`)
- AI agent → Disk scanner: runs scan
- Disk scanner → Local filesystem: reads sizes (evidence: `storage-analyzer/scripts/scan.py`)
- Disk scanner → Scan interpretation: emits JSON (evidence: `storage-analyzer/scripts/scan.py`)
- AI agent → Scan interpretation: classifies results
- Scan interpretation → Static report builder: provides JSON (evidence: `storage-analyzer/scripts/build_report.py`)
- Static report builder → Interactive report: injects data (evidence: `storage-analyzer/scripts/build_report.py`)
- Action server → Interactive report: serves report (evidence: `storage-analyzer/scripts/server.py`)
- Action server → Browser: opens report (evidence: `storage-analyzer/scripts/server.py`)
- Browser → Action server: posts actions (evidence: `storage-analyzer/scripts/server.py`)
- Action server → Local filesystem: opens or deletes (evidence: `storage-analyzer/scripts/server.py`)
- AI agent → Static report builder: builds report
- AI agent → Action server: serves report
- User → Knowledge closeout: requests closeout (evidence: `README.md`)
- Knowledge closeout → Governance guidance: uses guidance (evidence: `README.md`)
- AI agent → Project knowledge: aligns documentation (evidence: `README.md`)
- AI agent → Agent memory: aligns memory (evidence: `README.md`)
- User → Goal definition: shares an idea (evidence: `README.md`)
- Goal definition → AI agent: defines a goal (evidence: `README.md`)
- User → Long-form research: requests research (evidence: `README.md`)
- Long-form research → Research schema: structures research
- AI agent → PDF formatter: converts report
- User → Style-guided writing: requests article (evidence: `README.md`)
- Style-guided writing → Style references: uses examples (evidence: `README.md`)
- User → AI news queries: asks for news (evidence: `README.md`)
- AI news queries → AI HOT service: queries news (evidence: `README.md`)
- AI news queries → Local sync data: syncs selections (evidence: `README.md`)