# zeropointrepo/youtube-skills architecture

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

- Interactive diagram: https://gitdiagram.com/zeropointrepo/youtube-skills
- Repository: https://github.com/zeropointrepo/youtube-skills

## Overview

This repository packages Agent Skills: instructions that let an AI agent fulfill YouTube lookup and transcript requests through TranscriptAPI. The main workflow is user request → installed skill → TranscriptAPI result; the README also describes automatic API-key registration and verification. Skill files and their internal request details were not excerpted, so relationships below reflect documented capabilities rather than inspected implementation calls.

Main entry points: [`skills/youtube-full/SKILL.md`](https://github.com/zeropointrepo/youtube-skills/blob/main/skills/youtube-full/SKILL.md) (YouTube Full), [`skills/transcript/SKILL.md`](https://github.com/zeropointrepo/youtube-skills/blob/main/skills/transcript/SKILL.md) (Transcript), [`skills/captions/SKILL.md`](https://github.com/zeropointrepo/youtube-skills/blob/main/skills/captions/SKILL.md) (Captions), [`skills/subtitles/SKILL.md`](https://github.com/zeropointrepo/youtube-skills/blob/main/skills/subtitles/SKILL.md) (Subtitles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Agent Entry"]
  node_full["YouTube Full<br/>[SKILL.md]"]
end

subgraph group_transcripts["Transcript Retrieval"]
  node_transcript["Transcript<br/>[SKILL.md]"]
  node_captions["Captions<br/>[SKILL.md]"]
  node_subtitles["Subtitles<br/>[SKILL.md]"]
  node_video_transcript["Video Transcript<br/>[SKILL.md]"]
end

subgraph group_discovery["Video Discovery"]
  node_search["YouTube Search<br/>[SKILL.md]"]
  node_data["YouTube Data<br/>[SKILL.md]"]
  node_youtube_api["YouTube API<br/>[SKILL.md]"]
  node_yt["Quick YouTube<br/>[SKILL.md]"]
end

subgraph group_channel_lists["Channel &amp; Playlists"]
  node_channels["YouTube Channels<br/>[SKILL.md]"]
  node_playlist["YouTube Playlist<br/>[SKILL.md]"]
end

subgraph group_access["API Access"]
  node_transcriptapi_skill["TranscriptAPI Skill<br/>[SKILL.md]"]
  node_key_setup["Key Setup<br/>[auth-setup.md]"]
end

node_user(("User"))
node_agent(("AI Agent"))
node_transcriptapi["TranscriptAPI"]

node_user -->|"requests task"| node_agent
node_agent -->|"uses skill"| node_full
node_agent -->|"uses skill"| node_transcript
node_agent -->|"uses skill"| node_captions
node_agent -->|"uses skill"| node_subtitles
node_agent -->|"uses skill"| node_video_transcript
node_agent -->|"uses skill"| node_search
node_agent -->|"uses skill"| node_channels
node_agent -->|"uses skill"| node_playlist
node_agent -->|"uses skill"| node_data
node_agent -->|"uses skill"| node_youtube_api
node_agent -->|"uses skill"| node_transcriptapi_skill
node_agent -->|"uses skill"| node_yt
node_full -->|"gets YouTube data"| node_transcriptapi
node_transcript -->|"gets transcripts"| node_transcriptapi
node_captions -->|"gets captions"| node_transcriptapi
node_subtitles -->|"gets subtitles"| node_transcriptapi
node_video_transcript -->|"gets transcripts"| node_transcriptapi
node_search -->|"searches videos"| node_transcriptapi
node_channels -->|"browses channels"| node_transcriptapi
node_playlist -->|"fetches playlist"| node_transcriptapi
node_data -->|"gets YouTube data"| node_transcriptapi
node_youtube_api -->|"accesses API"| node_transcriptapi
node_transcriptapi_skill -->|"uses API"| node_transcriptapi
node_yt -->|"looks up videos"| node_transcriptapi
node_agent -->|"configures key"| node_key_setup
node_key_setup -->|"registers key"| node_transcriptapi

click node_full "https://github.com/zeropointrepo/youtube-skills/blob/main/skills/youtube-full/SKILL.md"
click node_transcript "https://github.com/zeropointrepo/youtube-skills/blob/main/skills/transcript/SKILL.md"
click node_captions "https://github.com/zeropointrepo/youtube-skills/blob/main/skills/captions/SKILL.md"
click node_subtitles "https://github.com/zeropointrepo/youtube-skills/blob/main/skills/subtitles/SKILL.md"
click node_video_transcript "https://github.com/zeropointrepo/youtube-skills/blob/main/skills/video-transcript/SKILL.md"
click node_search "https://github.com/zeropointrepo/youtube-skills/blob/main/skills/youtube-search/SKILL.md"
click node_channels "https://github.com/zeropointrepo/youtube-skills/blob/main/skills/youtube-channels/SKILL.md"
click node_playlist "https://github.com/zeropointrepo/youtube-skills/blob/main/skills/youtube-playlist/SKILL.md"
click node_data "https://github.com/zeropointrepo/youtube-skills/blob/main/skills/youtube-data/SKILL.md"
click node_youtube_api "https://github.com/zeropointrepo/youtube-skills/blob/main/skills/youtube-api/SKILL.md"
click node_transcriptapi_skill "https://github.com/zeropointrepo/youtube-skills/blob/main/skills/transcriptapi/SKILL.md"
click node_yt "https://github.com/zeropointrepo/youtube-skills/blob/main/skills/yt/SKILL.md"
click node_key_setup "https://github.com/zeropointrepo/youtube-skills/blob/main/skills/transcript/references/auth-setup.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_full,node_user toneBlue
class node_transcript,node_captions,node_subtitles,node_video_transcript toneAmber
class node_search,node_data,node_youtube_api,node_yt,node_transcriptapi toneMint
class node_channels,node_playlist toneRose
class node_transcriptapi_skill,node_key_setup,node_agent toneIndigo
```

## Components

### Agent Entry

- [YouTube Full](https://github.com/zeropointrepo/youtube-skills/blob/main/skills/youtube-full/SKILL.md): `skills/youtube-full/SKILL.md`

### Transcript Retrieval

- [Transcript](https://github.com/zeropointrepo/youtube-skills/blob/main/skills/transcript/SKILL.md): `skills/transcript/SKILL.md`
- [Captions](https://github.com/zeropointrepo/youtube-skills/blob/main/skills/captions/SKILL.md): `skills/captions/SKILL.md`
- [Subtitles](https://github.com/zeropointrepo/youtube-skills/blob/main/skills/subtitles/SKILL.md): `skills/subtitles/SKILL.md`
- [Video Transcript](https://github.com/zeropointrepo/youtube-skills/blob/main/skills/video-transcript/SKILL.md): `skills/video-transcript/SKILL.md`

### Video Discovery

- [YouTube Search](https://github.com/zeropointrepo/youtube-skills/blob/main/skills/youtube-search/SKILL.md): `skills/youtube-search/SKILL.md`
- [YouTube Data](https://github.com/zeropointrepo/youtube-skills/blob/main/skills/youtube-data/SKILL.md): `skills/youtube-data/SKILL.md`
- [YouTube API](https://github.com/zeropointrepo/youtube-skills/blob/main/skills/youtube-api/SKILL.md): `skills/youtube-api/SKILL.md`
- [Quick YouTube](https://github.com/zeropointrepo/youtube-skills/blob/main/skills/yt/SKILL.md): `skills/yt/SKILL.md`

### Channel & Playlists

- [YouTube Channels](https://github.com/zeropointrepo/youtube-skills/blob/main/skills/youtube-channels/SKILL.md): `skills/youtube-channels/SKILL.md`
- [YouTube Playlist](https://github.com/zeropointrepo/youtube-skills/blob/main/skills/youtube-playlist/SKILL.md): `skills/youtube-playlist/SKILL.md`

### API Access

- [TranscriptAPI Skill](https://github.com/zeropointrepo/youtube-skills/blob/main/skills/transcriptapi/SKILL.md): `skills/transcriptapi/SKILL.md`
- [Key Setup](https://github.com/zeropointrepo/youtube-skills/blob/main/skills/transcript/references/auth-setup.md): `skills/transcript/references/auth-setup.md`

### Other components

- **User**
- **AI Agent**
- **TranscriptAPI**

## Connections

- User → AI Agent: requests task (evidence: `README.md`)
- AI Agent → YouTube Full: uses skill (evidence: `README.md`)
- AI Agent → Transcript: uses skill (evidence: `README.md`)
- AI Agent → Captions: uses skill (evidence: `README.md`)
- AI Agent → Subtitles: uses skill (evidence: `README.md`)
- AI Agent → Video Transcript: uses skill (evidence: `README.md`)
- AI Agent → YouTube Search: uses skill (evidence: `README.md`)
- AI Agent → YouTube Channels: uses skill (evidence: `README.md`)
- AI Agent → YouTube Playlist: uses skill (evidence: `README.md`)
- AI Agent → YouTube Data: uses skill (evidence: `README.md`)
- AI Agent → YouTube API: uses skill (evidence: `README.md`)
- AI Agent → TranscriptAPI Skill: uses skill (evidence: `README.md`)
- AI Agent → Quick YouTube: uses skill (evidence: `README.md`)
- YouTube Full → TranscriptAPI: gets YouTube data (evidence: `README.md`)
- Transcript → TranscriptAPI: gets transcripts (evidence: `README.md`)
- Captions → TranscriptAPI: gets captions (evidence: `README.md`)
- Subtitles → TranscriptAPI: gets subtitles (evidence: `README.md`)
- Video Transcript → TranscriptAPI: gets transcripts (evidence: `README.md`)
- YouTube Search → TranscriptAPI: searches videos (evidence: `README.md`)
- YouTube Channels → TranscriptAPI: browses channels (evidence: `README.md`)
- YouTube Playlist → TranscriptAPI: fetches playlist (evidence: `README.md`)
- YouTube Data → TranscriptAPI: gets YouTube data (evidence: `README.md`)
- YouTube API → TranscriptAPI: accesses API (evidence: `README.md`)
- TranscriptAPI Skill → TranscriptAPI: uses API (evidence: `README.md`)
- Quick YouTube → TranscriptAPI: looks up videos (evidence: `README.md`)
- AI Agent → Key Setup: configures key (evidence: `README.md`)
- Key Setup → TranscriptAPI: registers key (evidence: `README.md`)
