# iamvinodh/youtube-agent-skill architecture

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

- Interactive diagram: https://gitdiagram.com/iamvinodh/youtube-agent-skill
- Repository: https://github.com/iamvinodh/youtube-agent-skill

## Overview

This repository is a set of eleven Claude YouTube-channel skills, with six dependency-free Python tools supporting selected workflows. A creator invokes a skill, supplies material such as a transcript or analytics export, reviews its written recommendations, and publishes manually; there is no publishing integration. The README documents the skills and shared voice file, while excerpts show the tools’ logic and selected calls. Other skill internals were not sampled, so links between those skills and tools are limited to documented relationships.

Main entry points: [`templates/voice.md`](https://github.com/iamvinodh/youtube-agent-skill/blob/main/templates/voice.md) (Creator voice guide), [`skills/yt-viral/SKILL.md`](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-viral/SKILL.md) (Niche research), [`skills/yt-script/SKILL.md`](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-script/SKILL.md) (Script writing), [`skills/yt-package/SKILL.md`](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-package/SKILL.md) (Title and thumbnail)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planning["Planning and research"]
  node_plan["Weekly plan<br/>[SKILL.md]"]
  node_viral["Niche research<br/>[SKILL.md]"]
  node_swipe["Outlier ranking<br/>[swipe.py]"]
end

subgraph group_creation["Script and packaging"]
  node_script["Script writing<br/>[SKILL.md]"]
  node_hookscore["Hook scoring<br/>[hookscore.py]"]
  node_formulas["Hook formulas<br/>[hooks.json]"]
  node_package["Title and thumbnail<br/>[SKILL.md]"]
  node_titlelint["Pairing linter<br/>[title.py]"]
end

subgraph group_editing["Editing utilities"]
  node_edit["Edit decisions<br/>[SKILL.md]"]
  node_deadair["Transcript analysis<br/>[deadair.py]"]
  node_chapters["Chapter drafting<br/>[SKILL.md]"]
  node_chaptertool["Chapter validator<br/>[chapters.py]"]
  node_shorts["Shorts selection<br/>[SKILL.md]"]
end

subgraph group_channel["Channel analysis"]
  node_retention["Retention analysis<br/>[SKILL.md]"]
  node_retentiontool["Retention analyzer<br/>[retention.py]"]
  node_comment["Comment triage<br/>[SKILL.md]"]
  node_seo["Video SEO<br/>[SKILL.md]"]
  node_audit["Channel audit<br/>[SKILL.md]"]
end

subgraph group_shared["Shared guidance"]
  node_voice["Creator voice guide<br/>[voice.md]"]
end

node_creator(("Channel creator"))

node_creator -->|"invokes"| node_plan
node_creator -->|"invokes"| node_viral
node_creator -->|"invokes"| node_script
node_creator -->|"invokes"| node_package
node_creator -->|"invokes"| node_edit
node_creator -->|"invokes"| node_chapters
node_creator -->|"invokes"| node_shorts
node_creator -->|"invokes"| node_retention
node_creator -->|"invokes"| node_comment
node_creator -->|"invokes"| node_seo
node_creator -->|"invokes"| node_audit
node_creator -->|"provides data"| node_swipe
node_creator -->|"provides hook"| node_hookscore
node_creator -->|"provides pairing"| node_titlelint
node_creator -->|"provides transcript"| node_deadair
node_creator -->|"provides transcript"| node_chaptertool
node_creator -->|"provides export"| node_retentiontool
node_voice -->|"guides"| node_plan
node_voice -->|"guides"| node_viral
node_voice -->|"guides"| node_script
node_voice -->|"guides"| node_package
node_voice -->|"guides"| node_edit
node_voice -->|"guides"| node_chapters
node_voice -->|"guides"| node_shorts
node_voice -->|"guides"| node_retention
node_voice -->|"guides"| node_comment
node_voice -->|"guides"| node_seo
node_voice -->|"guides"| node_audit
node_script -->|"scores hooks with"| node_hookscore
node_hookscore -->|"loads formulas"| node_formulas
node_viral -->|"ranks collected videos with"| node_swipe
node_swipe -->|"classifies titles with"| node_formulas
node_package -->|"lints pairing with"| node_titlelint
node_edit -->|"generates EDL with"| node_deadair
node_chapters -->|"drafts chapters with"| node_chaptertool
node_chaptertool -->|"loads transcript parser"| node_deadair
node_retention -->|"analyzes export with"| node_retentiontool
node_retentiontool -->|"loads transcript cues"| node_deadair
node_creator -->|"reviews output"| node_plan
node_creator -->|"reviews findings"| node_viral
node_creator -->|"reviews script"| node_script
node_creator -->|"reviews pairing"| node_package
node_creator -->|"applies edit list"| node_edit
node_creator -->|"retitles chapters"| node_chapters
node_creator -->|"reviews selections"| node_shorts
node_creator -->|"reviews diagnosis"| node_retention
node_creator -->|"reviews replies"| node_comment
node_creator -->|"reviews metadata"| node_seo

click node_plan "https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-plan/SKILL.md"
click node_viral "https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-viral/SKILL.md"
click node_swipe "https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-viral/swipe.py"
click node_script "https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-script/SKILL.md"
click node_hookscore "https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-script/hookscore.py"
click node_formulas "https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-script/hooks.json"
click node_package "https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-package/SKILL.md"
click node_titlelint "https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-package/title.py"
click node_edit "https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-edit/SKILL.md"
click node_deadair "https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-edit/deadair.py"
click node_chapters "https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-chapters/SKILL.md"
click node_chaptertool "https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-chapters/chapters.py"
click node_shorts "https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-shorts/SKILL.md"
click node_retention "https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-retention/SKILL.md"
click node_retentiontool "https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-retention/retention.py"
click node_comment "https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-comment/SKILL.md"
click node_seo "https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-seo/SKILL.md"
click node_audit "https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-audit/SKILL.md"
click node_voice "https://github.com/iamvinodh/youtube-agent-skill/blob/main/templates/voice.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_plan,node_viral,node_swipe toneBlue
class node_script,node_hookscore,node_formulas,node_package,node_titlelint toneAmber
class node_edit,node_deadair,node_chapters,node_chaptertool,node_shorts toneMint
class node_retention,node_retentiontool,node_comment,node_seo,node_audit toneRose
class node_voice,node_creator toneIndigo
```

## Components

### Planning and research

- [Weekly plan](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-plan/SKILL.md): `skills/yt-plan/SKILL.md`
- [Niche research](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-viral/SKILL.md): `skills/yt-viral/SKILL.md`
- [Outlier ranking](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-viral/swipe.py): `skills/yt-viral/swipe.py`

### Script and packaging

- [Script writing](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-script/SKILL.md): `skills/yt-script/SKILL.md`
- [Hook scoring](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-script/hookscore.py): `skills/yt-script/hookscore.py`
- [Hook formulas](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-script/hooks.json): `skills/yt-script/hooks.json`
- [Title and thumbnail](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-package/SKILL.md): `skills/yt-package/SKILL.md`
- [Pairing linter](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-package/title.py): `skills/yt-package/title.py`

### Editing utilities

- [Edit decisions](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-edit/SKILL.md): `skills/yt-edit/SKILL.md`
- [Transcript analysis](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-edit/deadair.py): `skills/yt-edit/deadair.py`
- [Chapter drafting](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-chapters/SKILL.md): `skills/yt-chapters/SKILL.md`
- [Chapter validator](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-chapters/chapters.py): `skills/yt-chapters/chapters.py`
- [Shorts selection](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-shorts/SKILL.md): `skills/yt-shorts/SKILL.md`

### Channel analysis

- [Retention analysis](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-retention/SKILL.md): `skills/yt-retention/SKILL.md`
- [Retention analyzer](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-retention/retention.py): `skills/yt-retention/retention.py`
- [Comment triage](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-comment/SKILL.md): `skills/yt-comment/SKILL.md`
- [Video SEO](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-seo/SKILL.md): `skills/yt-seo/SKILL.md`
- [Channel audit](https://github.com/iamvinodh/youtube-agent-skill/blob/main/skills/yt-audit/SKILL.md): `skills/yt-audit/SKILL.md`

### Shared guidance

- [Creator voice guide](https://github.com/iamvinodh/youtube-agent-skill/blob/main/templates/voice.md): `templates/voice.md`

### Other components

- **Channel creator**

## Connections

- Channel creator → Weekly plan: invokes (evidence: `README.md`)
- Channel creator → Niche research: invokes (evidence: `README.md`)
- Channel creator → Script writing: invokes (evidence: `README.md`)
- Channel creator → Title and thumbnail: invokes (evidence: `README.md`)
- Channel creator → Edit decisions: invokes (evidence: `README.md`)
- Channel creator → Chapter drafting: invokes (evidence: `README.md`)
- Channel creator → Shorts selection: invokes (evidence: `README.md`)
- Channel creator → Retention analysis: invokes (evidence: `README.md`)
- Channel creator → Comment triage: invokes (evidence: `README.md`)
- Channel creator → Video SEO: invokes (evidence: `README.md`)
- Channel creator → Channel audit: invokes (evidence: `README.md`)
- Channel creator → Outlier ranking: provides data (evidence: `README.md`)
- Channel creator → Hook scoring: provides hook (evidence: `README.md`)
- Channel creator → Pairing linter: provides pairing (evidence: `README.md`)
- Channel creator → Transcript analysis: provides transcript (evidence: `README.md`)
- Channel creator → Chapter validator: provides transcript (evidence: `README.md`)
- Channel creator → Retention analyzer: provides export (evidence: `README.md`)
- Creator voice guide → Weekly plan: guides (evidence: `README.md`)
- Creator voice guide → Niche research: guides (evidence: `README.md`)
- Creator voice guide → Script writing: guides (evidence: `README.md`)
- Creator voice guide → Title and thumbnail: guides (evidence: `README.md`)
- Creator voice guide → Edit decisions: guides (evidence: `README.md`)
- Creator voice guide → Chapter drafting: guides (evidence: `README.md`)
- Creator voice guide → Shorts selection: guides (evidence: `README.md`)
- Creator voice guide → Retention analysis: guides (evidence: `README.md`)
- Creator voice guide → Comment triage: guides (evidence: `README.md`)
- Creator voice guide → Video SEO: guides (evidence: `README.md`)
- Creator voice guide → Channel audit: guides (evidence: `README.md`)
- Script writing → Hook scoring: scores hooks with (evidence: `README.md`)
- Hook scoring → Hook formulas: loads formulas (evidence: `skills/yt-script/hookscore.py`)
- Niche research → Outlier ranking: ranks collected videos with (evidence: `README.md`)
- Outlier ranking → Hook formulas: classifies titles with (evidence: `skills/yt-viral/swipe.py`)
- Title and thumbnail → Pairing linter: lints pairing with (evidence: `README.md`)
- Edit decisions → Transcript analysis: generates EDL with (evidence: `README.md`)
- Chapter drafting → Chapter validator: drafts chapters with (evidence: `README.md`)
- Chapter validator → Transcript analysis: loads transcript parser (evidence: `skills/yt-chapters/chapters.py`)
- Retention analysis → Retention analyzer: analyzes export with (evidence: `README.md`)
- Retention analyzer → Transcript analysis: loads transcript cues (evidence: `skills/yt-retention/retention.py`)
- Channel creator → Weekly plan: reviews output (evidence: `README.md`)
- Channel creator → Niche research: reviews findings (evidence: `README.md`)
- Channel creator → Script writing: reviews script (evidence: `README.md`)
- Channel creator → Title and thumbnail: reviews pairing (evidence: `README.md`)
- Channel creator → Edit decisions: applies edit list (evidence: `README.md`)
- Channel creator → Chapter drafting: retitles chapters (evidence: `README.md`)
- Channel creator → Shorts selection: reviews selections (evidence: `README.md`)
- Channel creator → Retention analysis: reviews diagnosis (evidence: `README.md`)
- Channel creator → Comment triage: reviews replies (evidence: `README.md`)
- Channel creator → Video SEO: reviews metadata (evidence: `README.md`)