# trustfuture/simon-skills architecture

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

- Interactive diagram: https://gitdiagram.com/trustfuture/simon-skills
- Repository: https://github.com/trustfuture/simon-skills

## Overview

simon-skills is a collection of AI-agent skills for producing faceless videos from a topic through research or scripting, narration, visuals, editing, and publishing materials. Its two production workflows are investigation-video for long-form business/consumer investigations and whiteboard-video for illustrated explainers; video-common supplies shared fact-checking, compliance, cover, copy, and delivery review practices. Source samples establish whiteboard scene, audio, caption, rendering, and mixing behavior. Investigation and shared workflows are represented at their documented skill/reference-directory level where implementation was not sampled.

Main entry points: [`skills/whiteboard-video/SKILL.md`](https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/SKILL.md) (Whiteboard Skill), [`skills/video-common/SKILL.md`](https://github.com/trustfuture/simon-skills/blob/master/skills/video-common/SKILL.md) (Common Skill), [`skills/investigation-video/SKILL.md`](https://github.com/trustfuture/simon-skills/blob/master/skills/investigation-video/SKILL.md) (Investigation Skill), [`skills/whiteboard-video/templates/scenes.js`](https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/templates/scenes.js) (Scene Script)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_investigation["Investigation Video"]
  node_investigation_skill["Investigation Skill<br/>[SKILL.md]"]
  node_research["Research &amp; Facts"]
  node_investigation_edit["Long-form Edit<br/>[index.jsx]"]
  node_investigation_copy["Platform Copy<br/>[八平台发布文案-模板.md]"]
end

subgraph group_whiteboard["Whiteboard Video"]
  node_whiteboard_skill["Whiteboard Skill<br/>[SKILL.md]"]
  node_scene_script["Scene Script<br/>[scenes.js]"]
  node_final_video["Final Video"]
end

subgraph group_shared["Shared Editorial QA"]
  node_common_skill["Common Skill<br/>[SKILL.md]"]
  node_fact_check["Fact Check<br/>[fact-check.md]"]
  node_compliance["Compliance Review<br/>[compliance.md]"]
  node_cover_qa["Cover QA<br/>[cover-qa.md]"]
  node_platform_copy["Platform Copy<br/>[platform-copy.md]"]
  node_delivery_qa["Delivery QA<br/>[delivery-qa.md]"]
end

subgraph group_production["Media Production"]
  node_scene_dsl["Scene DSL<br/>[scene-dsl.js]"]
  node_sticker_gen["Sticker Images<br/>[gen-image.mjs]"]
  node_official_logos["Official Logos<br/>[fetch-logo.mjs]"]
  node_tts["Voice Synthesis<br/>[tts.mjs]"]
  node_audio_cache[("Audio Cache<br/>[content-cache.mjs]")]
  node_captions["Captions &amp; SRT<br/>[captions.cjs]"]
  node_render["Scene Renderer<br/>[render.js]"]
  node_mix["BGM Mix<br/>[mix-bgm.mjs]"]
end

node_agent(("AI Agent"))
node_codex_cli(("Codex ImageGen"))
node_commons(("Wikimedia Commons"))
node_volc(("Volcengine TTS"))

node_agent -->|"provides topic"| node_investigation_skill
node_investigation_skill -->|"guides research"| node_research
node_investigation_skill -->|"guides production"| node_investigation_edit
node_investigation_skill -->|"guides copy"| node_investigation_copy
node_agent -->|"provides topic"| node_whiteboard_skill
node_whiteboard_skill -->|"defines scenes"| node_scene_script
node_scene_script -->|"builds documents"| node_scene_dsl
node_scene_script -.->|"requests stickers"| node_sticker_gen
node_sticker_gen -->|"generates images"| node_codex_cli
node_scene_script -.->|"requests logos"| node_official_logos
node_official_logos -->|"searches and fetches"| node_commons
node_whiteboard_skill -->|"runs narration"| node_tts
node_tts -->|"synthesizes speech"| node_volc
node_tts -->|"reads and writes"| node_audio_cache
node_whiteboard_skill -->|"generates subtitles"| node_captions
node_whiteboard_skill -->|"renders scenes"| node_render
node_render -->|"writes master video"| node_final_video
node_whiteboard_skill -->|"mixes soundtrack"| node_mix
node_mix -->|"writes final video"| node_final_video
node_agent -->|"uses shared checks"| node_common_skill
node_common_skill -->|"checks claims"| node_fact_check
node_common_skill -->|"checks compliance"| node_compliance
node_common_skill -->|"reviews covers"| node_cover_qa
node_common_skill -->|"guides copy"| node_platform_copy
node_common_skill -->|"reviews delivery"| node_delivery_qa

click node_investigation_skill "https://github.com/trustfuture/simon-skills/blob/master/skills/investigation-video/SKILL.md"
click node_research "https://github.com/trustfuture/simon-skills/tree/master/skills/investigation-video/references"
click node_investigation_edit "https://github.com/trustfuture/simon-skills/blob/master/skills/investigation-video/template/remotion/index.jsx"
click node_investigation_copy "https://github.com/trustfuture/simon-skills/blob/master/skills/investigation-video/assets/publishing-reference/%E5%85%AB%E5%B9%B3%E5%8F%B0%E5%8F%91%E5%B8%83%E6%96%87%E6%A1%88-%E6%A8%A1%E6%9D%BF.md"
click node_whiteboard_skill "https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/SKILL.md"
click node_scene_script "https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/templates/scenes.js"
click node_scene_dsl "https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/lib/scene-dsl.js"
click node_sticker_gen "https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/lib/gen-image.mjs"
click node_official_logos "https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/lib/fetch-logo.mjs"
click node_tts "https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/lib/tts/tts.mjs"
click node_audio_cache "https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/lib/tts/content-cache.mjs"
click node_captions "https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/lib/captions.cjs"
click node_render "https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/lib/render.js"
click node_mix "https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/lib/mix-bgm.mjs"
click node_final_video "https://github.com/trustfuture/simon-skills/tree/master/skills/whiteboard-video"
click node_common_skill "https://github.com/trustfuture/simon-skills/blob/master/skills/video-common/SKILL.md"
click node_fact_check "https://github.com/trustfuture/simon-skills/blob/master/skills/video-common/references/fact-check.md"
click node_compliance "https://github.com/trustfuture/simon-skills/blob/master/skills/video-common/references/compliance.md"
click node_cover_qa "https://github.com/trustfuture/simon-skills/blob/master/skills/video-common/references/cover-qa.md"
click node_platform_copy "https://github.com/trustfuture/simon-skills/blob/master/skills/video-common/references/platform-copy.md"
click node_delivery_qa "https://github.com/trustfuture/simon-skills/blob/master/skills/video-common/references/delivery-qa.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_investigation_skill,node_research,node_investigation_edit,node_investigation_copy toneBlue
class node_whiteboard_skill,node_scene_script,node_final_video toneAmber
class node_common_skill,node_fact_check,node_compliance,node_cover_qa,node_platform_copy,node_delivery_qa toneMint
class node_scene_dsl,node_sticker_gen,node_official_logos,node_tts,node_audio_cache,node_captions,node_render,node_mix toneRose
class node_agent,node_codex_cli,node_commons,node_volc toneIndigo
```

## Components

### Investigation Video

- [Investigation Skill](https://github.com/trustfuture/simon-skills/blob/master/skills/investigation-video/SKILL.md): `skills/investigation-video/SKILL.md`
- [Research & Facts](https://github.com/trustfuture/simon-skills/tree/master/skills/investigation-video/references): `skills/investigation-video/references`
- [Long-form Edit](https://github.com/trustfuture/simon-skills/blob/master/skills/investigation-video/template/remotion/index.jsx): `skills/investigation-video/template/remotion/index.jsx`
- [Platform Copy](https://github.com/trustfuture/simon-skills/blob/master/skills/investigation-video/assets/publishing-reference/%E5%85%AB%E5%B9%B3%E5%8F%B0%E5%8F%91%E5%B8%83%E6%96%87%E6%A1%88-%E6%A8%A1%E6%9D%BF.md): `skills/investigation-video/assets/publishing-reference/八平台发布文案-模板.md`

### Whiteboard Video

- [Whiteboard Skill](https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/SKILL.md): `skills/whiteboard-video/SKILL.md`
- [Scene Script](https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/templates/scenes.js): `skills/whiteboard-video/templates/scenes.js`
- [Final Video](https://github.com/trustfuture/simon-skills/tree/master/skills/whiteboard-video): `skills/whiteboard-video`

### Shared Editorial QA

- [Common Skill](https://github.com/trustfuture/simon-skills/blob/master/skills/video-common/SKILL.md): `skills/video-common/SKILL.md`
- [Fact Check](https://github.com/trustfuture/simon-skills/blob/master/skills/video-common/references/fact-check.md): `skills/video-common/references/fact-check.md`
- [Compliance Review](https://github.com/trustfuture/simon-skills/blob/master/skills/video-common/references/compliance.md): `skills/video-common/references/compliance.md`
- [Cover QA](https://github.com/trustfuture/simon-skills/blob/master/skills/video-common/references/cover-qa.md): `skills/video-common/references/cover-qa.md`
- [Platform Copy](https://github.com/trustfuture/simon-skills/blob/master/skills/video-common/references/platform-copy.md): `skills/video-common/references/platform-copy.md`
- [Delivery QA](https://github.com/trustfuture/simon-skills/blob/master/skills/video-common/references/delivery-qa.md): `skills/video-common/references/delivery-qa.md`

### Media Production

- [Scene DSL](https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/lib/scene-dsl.js): `skills/whiteboard-video/lib/scene-dsl.js`
- [Sticker Images](https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/lib/gen-image.mjs): `skills/whiteboard-video/lib/gen-image.mjs`
- [Official Logos](https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/lib/fetch-logo.mjs): `skills/whiteboard-video/lib/fetch-logo.mjs`
- [Voice Synthesis](https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/lib/tts/tts.mjs): `skills/whiteboard-video/lib/tts/tts.mjs`
- [Audio Cache](https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/lib/tts/content-cache.mjs): `skills/whiteboard-video/lib/tts/content-cache.mjs`
- [Captions & SRT](https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/lib/captions.cjs): `skills/whiteboard-video/lib/captions.cjs`
- [Scene Renderer](https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/lib/render.js): `skills/whiteboard-video/lib/render.js`
- [BGM Mix](https://github.com/trustfuture/simon-skills/blob/master/skills/whiteboard-video/lib/mix-bgm.mjs): `skills/whiteboard-video/lib/mix-bgm.mjs`

### Other components

- **AI Agent**
- **Codex ImageGen**
- **Wikimedia Commons**
- **Volcengine TTS**

## Connections

- AI Agent → Investigation Skill: provides topic
- Investigation Skill → Research & Facts: guides research
- Investigation Skill → Long-form Edit: guides production
- Investigation Skill → Platform Copy: guides copy
- AI Agent → Whiteboard Skill: provides topic
- Whiteboard Skill → Scene Script: defines scenes
- Scene Script → Scene DSL: builds documents
- Scene Script → Sticker Images: requests stickers
- Sticker Images → Codex ImageGen: generates images
- Scene Script → Official Logos: requests logos
- Official Logos → Wikimedia Commons: searches and fetches
- Whiteboard Skill → Voice Synthesis: runs narration
- Voice Synthesis → Volcengine TTS: synthesizes speech
- Voice Synthesis → Audio Cache: reads and writes
- Whiteboard Skill → Captions & SRT: generates subtitles
- Whiteboard Skill → Scene Renderer: renders scenes
- Scene Renderer → Final Video: writes master video
- Whiteboard Skill → BGM Mix: mixes soundtrack
- BGM Mix → Final Video: writes final video
- AI Agent → Common Skill: uses shared checks
- Common Skill → Fact Check: checks claims
- Common Skill → Compliance Review: checks compliance
- Common Skill → Cover QA: reviews covers
- Common Skill → Platform Copy: guides copy
- Common Skill → Delivery QA: reviews delivery