# rahulraabta/skill-quality-auditor architecture

> Architecture diagram of the GitHub repository rahulraabta/skill-quality-auditor, 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/rahulraabta/skill-quality-auditor
- Repository: https://github.com/rahulraabta/skill-quality-auditor

## Overview

This small repository provides two independent skill-audit operations: structural manifest validation and static security scanning. Each accepts a skill directory and returns structured results; no shared orchestrator or user-facing application is shown. The security scanner invokes SkillSpector and normalizes its JSON output, while structural validation delegates to ManifestSpec. The README provides only the project name, so the graph is based on the sampled auditor source; the n8n configuration has no shown product-flow wiring.

Main entry points: [`auditor/structural.py`](https://github.com/rahulraabta/skill-quality-auditor/blob/main/auditor/structural.py) (Structural audit), [`auditor/security.py`](https://github.com/rahulraabta/skill-quality-auditor/blob/main/auditor/security.py) (Security audit)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("Audit caller"))
node_skill["Skill directory"]
node_structural["Structural audit<br/>[structural.py]"]
node_manifestspec["ManifestSpec"]
node_security["Security audit<br/>[security.py]"]
node_skillspector["SkillSpector CLI"]
node_auditresults["Audit results"]

node_user -->|"runs validation"| node_structural
node_user -->|"runs scan"| node_security
node_skill -->|"validates files"| node_structural
node_structural -->|"delegates validation"| node_manifestspec
node_structural -->|"returns validity"| node_auditresults
node_skill -->|"scans files"| node_security
node_security -->|"runs scan"| node_skillspector
node_security -->|"normalizes findings"| node_auditresults

click node_structural "https://github.com/rahulraabta/skill-quality-auditor/blob/main/auditor/structural.py"
click node_security "https://github.com/rahulraabta/skill-quality-auditor/blob/main/auditor/security.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_user,node_skill,node_manifestspec,node_skillspector,node_auditresults toneIndigo
class node_structural,node_security toneTeal
```

## Components

### Other components

- **Audit caller**
- **Skill directory**
- [Structural audit](https://github.com/rahulraabta/skill-quality-auditor/blob/main/auditor/structural.py): `auditor/structural.py`
- **ManifestSpec**
- [Security audit](https://github.com/rahulraabta/skill-quality-auditor/blob/main/auditor/security.py): `auditor/security.py`
- **SkillSpector CLI**
- **Audit results**

## Connections

- Audit caller → Structural audit: runs validation (evidence: `auditor/structural.py`)
- Audit caller → Security audit: runs scan (evidence: `auditor/security.py`)
- Skill directory → Structural audit: validates files (evidence: `auditor/structural.py`)
- Structural audit → ManifestSpec: delegates validation (evidence: `auditor/structural.py`)
- Structural audit → Audit results: returns validity (evidence: `auditor/structural.py`)
- Skill directory → Security audit: scans files (evidence: `auditor/security.py`)
- Security audit → SkillSpector CLI: runs scan (evidence: `auditor/security.py`)
- Security audit → Audit results: normalizes findings (evidence: `auditor/security.py`)
