# kangarooking/director-skills architecture

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

- Interactive diagram: https://gitdiagram.com/kangarooking/director-skills
- Repository: https://github.com/kangarooking/director-skills

## Overview

Director Skills is a collection of agent-guided video-production workflows, not a single runtime application. Users bring a creative brief to an agent, which applies a specialist skill to produce prompts, plans, or production checks. The Miora skill adds a local job-tracking utility for verifying generated files. README capabilities are represented; because the skill instructions were not sampled, links between individual instruction files and their reference materials are omitted.

Main entry points: [`travel-skill/SKILL.md`](https://github.com/kangarooking/director-skills/blob/main/travel-skill/SKILL.md) (Travel Film), [`miora-video-studio/scripts/miora_watch.py`](https://github.com/kangarooking/director-skills/blob/main/miora-video-studio/scripts/miora_watch.py) (Job Watcher), [`cinematic-asset-prompts/SKILL.md`](https://github.com/kangarooking/director-skills/blob/main/cinematic-asset-prompts/SKILL.md) (Asset Prompts), [`action-fight-prompt/SKILL.md`](https://github.com/kangarooking/director-skills/blob/main/action-fight-prompt/SKILL.md) (Fight Prompts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_assets["Visual Assets"]
  node_asset_skill["Asset Prompts<br/>[SKILL.md]"]
  node_asset_refs["Asset Guidance"]
  node_asset_output["Bilingual Prompts"]
end

subgraph group_travel["Travel Production"]
  node_travel_skill["Travel Film<br/>[SKILL.md]"]
  node_travel_refs["Production Guidance"]
  node_travel_templates["Production Templates"]
  node_travel_output["Film Plan"]
  node_travel_tools["Planning Utilities"]
end

subgraph group_action["Action Design"]
  node_fight_skill["Fight Prompts<br/>[SKILL.md]"]
  node_fight_refs["Fight Guidance"]
  node_fight_output["Timed Action Prompt"]
end

subgraph group_miora["Miora Reliability"]
  node_miora_skill["Miora Workflow<br/>[SKILL.md]"]
  node_miora_watch["Job Watcher<br/>[miora_watch.py]"]
  node_verified_video["Verified Video"]
end

node_creator(("Creator"))
node_agent["Skills Agent"]
node_miora_service["Miora Generator"]
node_media[("Media Directory")]
node_markers[("Job Markers")]

node_creator -->|"provides brief"| node_agent
node_agent -->|"applies skill"| node_asset_skill
node_asset_skill -->|"consults"| node_asset_refs
node_asset_skill -->|"produces"| node_asset_output
node_agent -->|"applies skill"| node_travel_skill
node_travel_skill -->|"consults"| node_travel_refs
node_travel_skill -->|"uses templates"| node_travel_templates
node_travel_skill -.->|"runs checks"| node_travel_tools
node_travel_skill -->|"produces plan"| node_travel_output
node_agent -->|"applies skill"| node_fight_skill
node_fight_skill -->|"consults"| node_fight_refs
node_fight_skill -->|"produces"| node_fight_output
node_agent -->|"applies skill"| node_miora_skill
node_miora_skill -.->|"submits generation"| node_miora_service
node_miora_skill -->|"tracks jobs"| node_miora_watch
node_miora_watch -->|"scans files"| node_media
node_miora_watch -->|"reads and writes"| node_markers
node_miora_watch -->|"reports verified"| node_verified_video
node_miora_service -.->|"writes video"| node_media

click node_asset_skill "https://github.com/kangarooking/director-skills/blob/main/cinematic-asset-prompts/SKILL.md"
click node_asset_refs "https://github.com/kangarooking/director-skills/tree/main/cinematic-asset-prompts/references"
click node_travel_skill "https://github.com/kangarooking/director-skills/blob/main/travel-skill/SKILL.md"
click node_travel_refs "https://github.com/kangarooking/director-skills/tree/main/travel-skill/references"
click node_travel_templates "https://github.com/kangarooking/director-skills/tree/main/travel-skill/assets/templates"
click node_travel_tools "https://github.com/kangarooking/director-skills/tree/main/travel-skill/scripts"
click node_fight_skill "https://github.com/kangarooking/director-skills/blob/main/action-fight-prompt/SKILL.md"
click node_fight_refs "https://github.com/kangarooking/director-skills/tree/main/action-fight-prompt/references"
click node_miora_skill "https://github.com/kangarooking/director-skills/blob/main/miora-video-studio/SKILL.md"
click node_miora_watch "https://github.com/kangarooking/director-skills/blob/main/miora-video-studio/scripts/miora_watch.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_asset_skill,node_asset_refs,node_asset_output toneBlue
class node_travel_skill,node_travel_refs,node_travel_templates,node_travel_output,node_travel_tools,node_media,node_markers toneAmber
class node_fight_skill,node_fight_refs,node_fight_output toneMint
class node_miora_skill,node_miora_watch,node_verified_video toneRose
class node_creator,node_agent,node_miora_service toneIndigo
```

## Components

### Visual Assets

- [Asset Prompts](https://github.com/kangarooking/director-skills/blob/main/cinematic-asset-prompts/SKILL.md): `cinematic-asset-prompts/SKILL.md`
- [Asset Guidance](https://github.com/kangarooking/director-skills/tree/main/cinematic-asset-prompts/references): `cinematic-asset-prompts/references`
- **Bilingual Prompts**

### Travel Production

- [Travel Film](https://github.com/kangarooking/director-skills/blob/main/travel-skill/SKILL.md): `travel-skill/SKILL.md`
- [Production Guidance](https://github.com/kangarooking/director-skills/tree/main/travel-skill/references): `travel-skill/references`
- [Production Templates](https://github.com/kangarooking/director-skills/tree/main/travel-skill/assets/templates): `travel-skill/assets/templates`
- **Film Plan**
- [Planning Utilities](https://github.com/kangarooking/director-skills/tree/main/travel-skill/scripts): `travel-skill/scripts`

### Action Design

- [Fight Prompts](https://github.com/kangarooking/director-skills/blob/main/action-fight-prompt/SKILL.md): `action-fight-prompt/SKILL.md`
- [Fight Guidance](https://github.com/kangarooking/director-skills/tree/main/action-fight-prompt/references): `action-fight-prompt/references`
- **Timed Action Prompt**

### Miora Reliability

- [Miora Workflow](https://github.com/kangarooking/director-skills/blob/main/miora-video-studio/SKILL.md): `miora-video-studio/SKILL.md`
- [Job Watcher](https://github.com/kangarooking/director-skills/blob/main/miora-video-studio/scripts/miora_watch.py): `miora-video-studio/scripts/miora_watch.py`
- **Verified Video**

### Other components

- **Creator**
- **Skills Agent**
- **Miora Generator**
- **Media Directory**
- **Job Markers**

## Connections

- Creator → Skills Agent: provides brief
- Skills Agent → Asset Prompts: applies skill
- Asset Prompts → Asset Guidance: consults
- Asset Prompts → Bilingual Prompts: produces
- Skills Agent → Travel Film: applies skill
- Travel Film → Production Guidance: consults
- Travel Film → Production Templates: uses templates
- Travel Film → Planning Utilities: runs checks
- Travel Film → Film Plan: produces plan
- Skills Agent → Fight Prompts: applies skill
- Fight Prompts → Fight Guidance: consults
- Fight Prompts → Timed Action Prompt: produces
- Skills Agent → Miora Workflow: applies skill
- Miora Workflow → Miora Generator: submits generation
- Miora Workflow → Job Watcher: tracks jobs
- Job Watcher → Media Directory: scans files
- Job Watcher → Job Markers: reads and writes
- Job Watcher → Verified Video: reports verified
- Miora Generator → Media Directory: writes video