# pashov/skills architecture

> Architecture diagram of the GitHub repository pashov/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/pashov/skills
- Repository: https://github.com/pashov/skills

## Overview

Pashov Audit Group Skills is a collection of AI-assisted Solidity security workflows: Fizz builds fuzzing suites, Solidity Auditor coordinates security review and reporting, and X-Ray performs pre-audit analysis. The root README documents these as separate skills, not a single chained pipeline. Fizz’s sampled scripts show ABI extraction, entry-point selection, suite generation, handler generation, and fuzz-runner behavior. Auditor and X-Ray internals are represented at their documented directory level where source excerpts were unavailable; those relationships are not inferred beyond explicit documentation.

Main entry points: [`fizz/SKILL.md`](https://github.com/pashov/skills/blob/main/fizz/SKILL.md) (Fizz Skill), [`solidity-auditor/SKILL.md`](https://github.com/pashov/skills/blob/main/solidity-auditor/SKILL.md) (Auditor Skill), [`x-ray/SKILL.md`](https://github.com/pashov/skills/blob/main/x-ray/SKILL.md) (X-Ray Skill), [`fizz/scripts/select_functions.js`](https://github.com/pashov/skills/blob/main/fizz/scripts/select_functions.js) (Function Selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_fizz["Fizz Fuzzing"]
  node_fizz_skill["Fizz Skill<br/>[SKILL.md]"]
  node_abi["ABI Extraction<br/>[extract_abis.js]"]
  node_selection["Function Selection"]
  node_suite["Suite Scaffolding<br/>[generate_suite.js]"]
  node_handlers["Handler Generation"]
  node_templates["Fuzz Templates"]
  node_medusa["Medusa Runner<br/>[run_medusa.js]"]
  node_echidna["Echidna Runner<br/>[run_echidna.js]"]
  node_logviewer["Live Log Viewer<br/>[log-viewer.js]"]
  node_sync["Suite Drift Sync<br/>[fizz_sync.js]"]
end

subgraph group_audit["Solidity Auditor"]
  node_auditor_skill["Auditor Skill<br/>[SKILL.md]"]
  node_audit_agents["Audit Agents"]
  node_audit_sop["Audit Procedure"]
  node_audit_judging["Finding Review<br/>[judging.md]"]
  node_report["Report Guidance"]
end

subgraph group_xray["X-Ray Analysis"]
  node_xray_skill["X-Ray Skill<br/>[SKILL.md]"]
  node_threats["Threat Modeling<br/>[threats.md]"]
  node_git_analysis["Git Security Scan"]
  node_svg["Architecture Diagram<br/>[generate_svg.py]"]
end

node_user(("Engineer"))

node_user -->|"runs fuzzing"| node_fizz_skill
node_user -->|"runs audit"| node_auditor_skill
node_user -->|"runs pre-audit"| node_xray_skill
node_abi -.->|"provides contracts"| node_selection
node_selection -->|"writes selection"| node_suite
node_selection -->|"provides selection"| node_handlers
node_suite -->|"copies scaffold"| node_templates
node_fizz_skill -.->|"extracts metadata"| node_abi
node_fizz_skill -.->|"chooses entry points"| node_selection
node_fizz_skill -.->|"generates suite"| node_suite
node_medusa -->|"starts viewer"| node_logviewer
node_echidna -->|"starts viewer"| node_logviewer
node_fizz_skill -.->|"runs fuzzing"| node_medusa
node_fizz_skill -.->|"runs fuzzing"| node_echidna
node_fizz_skill -.->|"checks drift"| node_sync
node_auditor_skill -.->|"coordinates review"| node_audit_agents
node_auditor_skill -.->|"follows procedure"| node_audit_sop
node_auditor_skill -.->|"reviews findings"| node_audit_judging
node_auditor_skill -.->|"formats results"| node_report
node_xray_skill -.->|"models threats"| node_threats
node_xray_skill -.->|"analyzes history"| node_git_analysis
node_xray_skill -.->|"renders diagrams"| node_svg

click node_fizz_skill "https://github.com/pashov/skills/blob/main/fizz/SKILL.md"
click node_abi "https://github.com/pashov/skills/blob/main/fizz/scripts/extract_abis.js"
click node_selection "https://github.com/pashov/skills/blob/main/fizz/scripts/select_functions.js"
click node_suite "https://github.com/pashov/skills/blob/main/fizz/scripts/generate_suite.js"
click node_handlers "https://github.com/pashov/skills/blob/main/fizz/scripts/generate_handlers.js"
click node_templates "https://github.com/pashov/skills/tree/main/fizz/templates"
click node_medusa "https://github.com/pashov/skills/blob/main/fizz/scripts/run_medusa.js"
click node_echidna "https://github.com/pashov/skills/blob/main/fizz/scripts/run_echidna.js"
click node_logviewer "https://github.com/pashov/skills/blob/main/fizz/scripts/lib/log-viewer.js"
click node_sync "https://github.com/pashov/skills/blob/main/fizz/scripts/fizz_sync.js"
click node_auditor_skill "https://github.com/pashov/skills/blob/main/solidity-auditor/SKILL.md"
click node_audit_agents "https://github.com/pashov/skills/tree/main/solidity-auditor/references/hacking-agents"
click node_audit_sop "https://github.com/pashov/skills/blob/main/solidity-auditor/references/senior-auditor-sop.md"
click node_audit_judging "https://github.com/pashov/skills/blob/main/solidity-auditor/references/judging.md"
click node_report "https://github.com/pashov/skills/blob/main/solidity-auditor/references/report-formatting.md"
click node_xray_skill "https://github.com/pashov/skills/blob/main/x-ray/SKILL.md"
click node_threats "https://github.com/pashov/skills/blob/main/x-ray/references/threats.md"
click node_git_analysis "https://github.com/pashov/skills/blob/main/x-ray/scripts/analyze_git_security.py"
click node_svg "https://github.com/pashov/skills/blob/main/x-ray/scripts/generate_svg.py"

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_fizz_skill,node_abi,node_selection,node_suite,node_handlers,node_templates,node_medusa,node_echidna,node_logviewer,node_sync toneBlue
class node_auditor_skill,node_audit_agents,node_audit_sop,node_audit_judging,node_report toneAmber
class node_xray_skill,node_threats,node_git_analysis,node_svg toneMint
class node_user toneIndigo
```

## Components

### Fizz Fuzzing

- [Fizz Skill](https://github.com/pashov/skills/blob/main/fizz/SKILL.md): `fizz/SKILL.md`
- [ABI Extraction](https://github.com/pashov/skills/blob/main/fizz/scripts/extract_abis.js): `fizz/scripts/extract_abis.js`
- [Function Selection](https://github.com/pashov/skills/blob/main/fizz/scripts/select_functions.js): `fizz/scripts/select_functions.js`
- [Suite Scaffolding](https://github.com/pashov/skills/blob/main/fizz/scripts/generate_suite.js): `fizz/scripts/generate_suite.js`
- [Handler Generation](https://github.com/pashov/skills/blob/main/fizz/scripts/generate_handlers.js): `fizz/scripts/generate_handlers.js`
- [Fuzz Templates](https://github.com/pashov/skills/tree/main/fizz/templates): `fizz/templates`
- [Medusa Runner](https://github.com/pashov/skills/blob/main/fizz/scripts/run_medusa.js): `fizz/scripts/run_medusa.js`
- [Echidna Runner](https://github.com/pashov/skills/blob/main/fizz/scripts/run_echidna.js): `fizz/scripts/run_echidna.js`
- [Live Log Viewer](https://github.com/pashov/skills/blob/main/fizz/scripts/lib/log-viewer.js): `fizz/scripts/lib/log-viewer.js`
- [Suite Drift Sync](https://github.com/pashov/skills/blob/main/fizz/scripts/fizz_sync.js): `fizz/scripts/fizz_sync.js`

### Solidity Auditor

- [Auditor Skill](https://github.com/pashov/skills/blob/main/solidity-auditor/SKILL.md): `solidity-auditor/SKILL.md`
- [Audit Agents](https://github.com/pashov/skills/tree/main/solidity-auditor/references/hacking-agents): `solidity-auditor/references/hacking-agents`
- [Audit Procedure](https://github.com/pashov/skills/blob/main/solidity-auditor/references/senior-auditor-sop.md): `solidity-auditor/references/senior-auditor-sop.md`
- [Finding Review](https://github.com/pashov/skills/blob/main/solidity-auditor/references/judging.md): `solidity-auditor/references/judging.md`
- [Report Guidance](https://github.com/pashov/skills/blob/main/solidity-auditor/references/report-formatting.md): `solidity-auditor/references/report-formatting.md`

### X-Ray Analysis

- [X-Ray Skill](https://github.com/pashov/skills/blob/main/x-ray/SKILL.md): `x-ray/SKILL.md`
- [Threat Modeling](https://github.com/pashov/skills/blob/main/x-ray/references/threats.md): `x-ray/references/threats.md`
- [Git Security Scan](https://github.com/pashov/skills/blob/main/x-ray/scripts/analyze_git_security.py): `x-ray/scripts/analyze_git_security.py`
- [Architecture Diagram](https://github.com/pashov/skills/blob/main/x-ray/scripts/generate_svg.py): `x-ray/scripts/generate_svg.py`

### Other components

- **Engineer**

## Connections

- Engineer → Fizz Skill: runs fuzzing (evidence: `README.md`)
- Engineer → Auditor Skill: runs audit (evidence: `README.md`)
- Engineer → X-Ray Skill: runs pre-audit (evidence: `README.md`)
- ABI Extraction → Function Selection: provides contracts
- Function Selection → Suite Scaffolding: writes selection (evidence: `fizz/scripts/select_functions.js`)
- Function Selection → Handler Generation: provides selection (evidence: `fizz/scripts/generate_handlers.js`)
- Suite Scaffolding → Fuzz Templates: copies scaffold (evidence: `fizz/scripts/generate_suite.js`)
- Fizz Skill → ABI Extraction: extracts metadata
- Fizz Skill → Function Selection: chooses entry points
- Fizz Skill → Suite Scaffolding: generates suite
- Medusa Runner → Live Log Viewer: starts viewer (evidence: `fizz/scripts/run_medusa.js`)
- Echidna Runner → Live Log Viewer: starts viewer (evidence: `fizz/scripts/run_echidna.js`)
- Fizz Skill → Medusa Runner: runs fuzzing
- Fizz Skill → Echidna Runner: runs fuzzing
- Fizz Skill → Suite Drift Sync: checks drift
- Auditor Skill → Audit Agents: coordinates review
- Auditor Skill → Audit Procedure: follows procedure
- Auditor Skill → Finding Review: reviews findings
- Auditor Skill → Report Guidance: formats results
- X-Ray Skill → Threat Modeling: models threats
- X-Ray Skill → Git Security Scan: analyzes history
- X-Ray Skill → Architecture Diagram: renders diagrams
