# sharon-laicc/viral-video-decomposer architecture

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

- Interactive diagram: https://gitdiagram.com/sharon-laicc/viral-video-decomposer
- Repository: https://github.com/sharon-laicc/viral-video-decomposer

## Overview

Video Structure Analyzer is an agent skill for turning short-video links or supplied media evidence into reusable analysis and production assets. The documented workflow moves from source material through shot evidence and viral-mechanism analysis to a production blueprint and HTML, Markdown, and JSON outputs. The README establishes these stages and the skill’s supporting reference files; implementation-level calls are not shown, so edges reflect documented relationships only.

Main entry points: [`skill/SKILL.md`](https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/SKILL.md) (Standalone skill), [`SKILL.md`](https://github.com/sharon-laicc/viral-video-decomposer/blob/main/SKILL.md) (Repository skill entry), [`plugins/video-structure-analyzer/SKILL.md`](https://github.com/sharon-laicc/viral-video-decomposer/blob/main/plugins/video-structure-analyzer/SKILL.md) (Analyzer plugin skill), [`skill/references/output-contract.md`](https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/references/output-contract.md) (Output contract)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Skill entry"]
  node_root_skill["Repository skill entry<br/>[SKILL.md]"]
  node_standalone_skill["Standalone skill<br/>[SKILL.md]"]
  node_plugin_skill["Analyzer plugin skill<br/>[SKILL.md]"]
end

subgraph group_analysis["Analysis workflow"]
  node_source_material["Video source material"]
  node_shot_evidence["Shot evidence<br/>[SKILL.md]"]
  node_mechanism["Viral mechanism<br/>[SKILL.md]"]
  node_blueprint["Production blueprint<br/>[SKILL.md]"]
  node_originality["Originality guardrails<br/>[SKILL.md]"]
end

subgraph group_outputs["Deliverables"]
  node_html_report["HTML report<br/>[SKILL.md]"]
  node_shot_breakdown["Shot breakdown<br/>[SKILL.md]"]
  node_json_brief["JSON brief<br/>[SKILL.md]"]
  node_contact_sheet["Contact sheet and frames<br/>[SKILL.md]"]
end

subgraph group_references["Skill references"]
  node_output_contract["Output contract<br/>[output-contract.md]"]
  node_report_style["Report style guide<br/>[report-style.md]"]
  node_report_css["Report styles"]
end

node_creator(("Creator or agent"))

node_creator -->|"invokes"| node_root_skill
node_creator -->|"installs or invokes"| node_standalone_skill
node_root_skill -->|"accepts"| node_source_material
node_standalone_skill -->|"accepts"| node_source_material
node_source_material -->|"yields frames"| node_shot_evidence
node_shot_evidence -->|"supports analysis"| node_mechanism
node_mechanism -->|"informs"| node_blueprint
node_standalone_skill -->|"applies guardrails"| node_originality
node_standalone_skill -->|"produces"| node_html_report
node_standalone_skill -->|"produces"| node_shot_breakdown
node_standalone_skill -->|"produces"| node_json_brief
node_standalone_skill -->|"produces"| node_contact_sheet
node_standalone_skill -->|"loads as needed"| node_output_contract
node_standalone_skill -->|"loads as needed"| node_report_style
node_standalone_skill -->|"loads as needed"| node_report_css
node_plugin_skill -.->|"accepts"| node_source_material

click node_root_skill "https://github.com/sharon-laicc/viral-video-decomposer/blob/main/SKILL.md"
click node_standalone_skill "https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/SKILL.md"
click node_plugin_skill "https://github.com/sharon-laicc/viral-video-decomposer/blob/main/plugins/video-structure-analyzer/SKILL.md"
click node_shot_evidence "https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/SKILL.md"
click node_mechanism "https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/SKILL.md"
click node_blueprint "https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/SKILL.md"
click node_originality "https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/SKILL.md"
click node_html_report "https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/SKILL.md"
click node_shot_breakdown "https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/SKILL.md"
click node_json_brief "https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/SKILL.md"
click node_contact_sheet "https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/SKILL.md"
click node_output_contract "https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/references/output-contract.md"
click node_report_style "https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/references/report-style.md"
click node_report_css "https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/references/viral-video-lab.css"

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_root_skill,node_standalone_skill,node_plugin_skill toneBlue
class node_source_material,node_shot_evidence,node_mechanism,node_blueprint,node_originality toneAmber
class node_html_report,node_shot_breakdown,node_json_brief,node_contact_sheet toneMint
class node_output_contract,node_report_style,node_report_css toneRose
class node_creator toneIndigo
```

## Components

### Skill entry

- [Repository skill entry](https://github.com/sharon-laicc/viral-video-decomposer/blob/main/SKILL.md): `SKILL.md`
- [Standalone skill](https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/SKILL.md): `skill/SKILL.md`
- [Analyzer plugin skill](https://github.com/sharon-laicc/viral-video-decomposer/blob/main/plugins/video-structure-analyzer/SKILL.md): `plugins/video-structure-analyzer/SKILL.md`

### Analysis workflow

- **Video source material**
- [Shot evidence](https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/SKILL.md): `skill/SKILL.md`
- [Viral mechanism](https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/SKILL.md): `skill/SKILL.md`
- [Production blueprint](https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/SKILL.md): `skill/SKILL.md`
- [Originality guardrails](https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/SKILL.md): `skill/SKILL.md`

### Deliverables

- [HTML report](https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/SKILL.md): `skill/SKILL.md`
- [Shot breakdown](https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/SKILL.md): `skill/SKILL.md`
- [JSON brief](https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/SKILL.md): `skill/SKILL.md`
- [Contact sheet and frames](https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/SKILL.md): `skill/SKILL.md`

### Skill references

- [Output contract](https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/references/output-contract.md): `skill/references/output-contract.md`
- [Report style guide](https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/references/report-style.md): `skill/references/report-style.md`
- [Report styles](https://github.com/sharon-laicc/viral-video-decomposer/blob/main/skill/references/viral-video-lab.css): `skill/references/viral-video-lab.css`

### Other components

- **Creator or agent**

## Connections

- Creator or agent → Repository skill entry: invokes (evidence: `README.md`)
- Creator or agent → Standalone skill: installs or invokes (evidence: `README.md`)
- Repository skill entry → Video source material: accepts (evidence: `README.md`)
- Standalone skill → Video source material: accepts (evidence: `README.md`)
- Video source material → Shot evidence: yields frames (evidence: `README.md`)
- Shot evidence → Viral mechanism: supports analysis (evidence: `README.md`)
- Viral mechanism → Production blueprint: informs (evidence: `README.md`)
- Standalone skill → Originality guardrails: applies guardrails (evidence: `README.md`)
- Standalone skill → HTML report: produces (evidence: `README.md`)
- Standalone skill → Shot breakdown: produces (evidence: `README.md`)
- Standalone skill → JSON brief: produces (evidence: `README.md`)
- Standalone skill → Contact sheet and frames: produces (evidence: `README.md`)
- Standalone skill → Output contract: loads as needed (evidence: `README.md`)
- Standalone skill → Report style guide: loads as needed (evidence: `README.md`)
- Standalone skill → Report styles: loads as needed (evidence: `README.md`)
- Analyzer plugin skill → Video source material: accepts
