# google-gemini/gemini-skills architecture

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

- Interactive diagram: https://gitdiagram.com/google-gemini/gemini-skills
- Repository: https://github.com/google-gemini/gemini-skills

## Overview

This repository is an agent-skill library for building with Gemini APIs, not a single application. Its main user-to-result workflow is a coding agent consulting a skill for current API guidance and using that guidance to produce an application; the README documents broad capabilities, while implementation excerpts are available only for the Omni video tools. The video-tool workflow prepares or inspects local media, uploads files when needed, then requests and downloads generated video. The skill documents’ internal guidance is not sampled, so their detailed behavior is represented at the skill level.

Main entry points: [`skills/gemini-omni-flash-api/scripts/upload_file.py`](https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-omni-flash-api/scripts/upload_file.py) (File upload), [`skills/gemini-omni-flash-api/scripts/video/generate_video.py`](https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-omni-flash-api/scripts/video/generate_video.py) (Video generation), [`skills/gemini-api-dev/SKILL.md`](https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-api-dev/SKILL.md) (Gemini API skill), [`skills/gemini-live-api-dev/SKILL.md`](https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-live-api-dev/SKILL.md) (Live API skill)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api_guidance["API guidance"]
  node_gemini_api_skill["Gemini API skill<br/>[SKILL.md]"]
  node_api_migration["API migration guide<br/>[migration.md]"]
end

subgraph group_live_guidance["Live guidance"]
  node_live_api_skill["Live API skill<br/>[SKILL.md]"]
  node_live_migration["Live migration guide<br/>[migration.md]"]
end

subgraph group_video_tools["Video tools"]
  node_omni_skill["Omni video skill<br/>[SKILL.md]"]
  node_video_prep["Video preparation<br/>[prep_video.py]"]
  node_video_inspect["Video inspection<br/>[inspect_video.py]"]
  node_file_upload["File upload<br/>[upload_file.py]"]
  node_video_generate["Video generation<br/>[generate_video.py]"]
end

node_coding_agent(("Coding agent"))
node_gemini_service{{"Gemini API"}}
node_generated_video["Generated video"]

node_coding_agent -->|"consults"| node_gemini_api_skill
node_coding_agent -->|"consults"| node_live_api_skill
node_coding_agent -->|"consults"| node_omni_skill
node_gemini_api_skill -->|"guides API use"| node_gemini_service
node_live_api_skill -->|"guides API use"| node_gemini_service
node_omni_skill -->|"guides API use"| node_gemini_service
node_video_prep -->|"inspects source"| node_video_inspect
node_file_upload -->|"runs preparation"| node_video_prep
node_video_generate -->|"uploads assets"| node_file_upload
node_video_generate -->|"requests generation"| node_gemini_service
node_file_upload -->|"uploads files"| node_gemini_service
node_gemini_service -.->|"returns video"| node_generated_video

click node_gemini_api_skill "https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-api-dev/SKILL.md"
click node_api_migration "https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-api-dev/references/migration.md"
click node_live_api_skill "https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-live-api-dev/SKILL.md"
click node_live_migration "https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-live-api-dev/references/migration.md"
click node_omni_skill "https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-omni-flash-api/SKILL.md"
click node_video_prep "https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-omni-flash-api/scripts/video/prep_video.py"
click node_video_inspect "https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-omni-flash-api/scripts/video/inspect_video.py"
click node_file_upload "https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-omni-flash-api/scripts/upload_file.py"
click node_video_generate "https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-omni-flash-api/scripts/video/generate_video.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_gemini_api_skill,node_api_migration toneBlue
class node_live_api_skill,node_live_migration toneAmber
class node_omni_skill,node_video_prep,node_video_inspect,node_file_upload,node_video_generate,node_gemini_service toneMint
class node_coding_agent,node_generated_video toneIndigo
```

## Components

### API guidance

- [Gemini API skill](https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-api-dev/SKILL.md): `skills/gemini-api-dev/SKILL.md`
- [API migration guide](https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-api-dev/references/migration.md): `skills/gemini-api-dev/references/migration.md`

### Live guidance

- [Live API skill](https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-live-api-dev/SKILL.md): `skills/gemini-live-api-dev/SKILL.md`
- [Live migration guide](https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-live-api-dev/references/migration.md): `skills/gemini-live-api-dev/references/migration.md`

### Video tools

- [Omni video skill](https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-omni-flash-api/SKILL.md): `skills/gemini-omni-flash-api/SKILL.md`
- [Video preparation](https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-omni-flash-api/scripts/video/prep_video.py): `skills/gemini-omni-flash-api/scripts/video/prep_video.py`
- [Video inspection](https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-omni-flash-api/scripts/video/inspect_video.py): `skills/gemini-omni-flash-api/scripts/video/inspect_video.py`
- [File upload](https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-omni-flash-api/scripts/upload_file.py): `skills/gemini-omni-flash-api/scripts/upload_file.py`
- [Video generation](https://github.com/google-gemini/gemini-skills/blob/main/skills/gemini-omni-flash-api/scripts/video/generate_video.py): `skills/gemini-omni-flash-api/scripts/video/generate_video.py`

### Other components

- **Coding agent**
- **Gemini API**
- **Generated video**

## Connections

- Coding agent → Gemini API skill: consults (evidence: `README.md`)
- Coding agent → Live API skill: consults (evidence: `README.md`)
- Coding agent → Omni video skill: consults (evidence: `README.md`)
- Gemini API skill → Gemini API: guides API use (evidence: `README.md`)
- Live API skill → Gemini API: guides API use (evidence: `README.md`)
- Omni video skill → Gemini API: guides API use (evidence: `README.md`)
- Video preparation → Video inspection: inspects source (evidence: `skills/gemini-omni-flash-api/scripts/video/prep_video.py`)
- File upload → Video preparation: runs preparation (evidence: `skills/gemini-omni-flash-api/scripts/upload_file.py`)
- Video generation → File upload: uploads assets (evidence: `skills/gemini-omni-flash-api/scripts/video/generate_video.py`)
- Video generation → Gemini API: requests generation (evidence: `skills/gemini-omni-flash-api/scripts/video/generate_video.py`)
- File upload → Gemini API: uploads files (evidence: `skills/gemini-omni-flash-api/scripts/upload_file.py`)
- Gemini API → Generated video: returns video
