# osidemedia/higgsfield-ai-prompt-skill architecture

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

- Interactive diagram: https://gitdiagram.com/osidemedia/higgsfield-ai-prompt-skill
- Repository: https://github.com/osidemedia/higgsfield-ai-prompt-skill

## Overview

This repository is an archived Claude skill library, not a Higgsfield generation engine. Its main workflow routes a user’s natural-language request from the root skill into specialized prompting and model guidance, producing a production-ready prompt for use on Higgsfield. The library also documents distinct production stages and specialist workflows. A smaller internal layer provides model-constraint preflight and generation-learning memory. The graph follows README-documented routing and capabilities plus the sampled tooling excerpts; unsampled skill internals are not assumed to call one another.

Main entry points: [`SKILL.md`](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/SKILL.md) (Root Skill Router), [`skills/higgsfield-prompt/SKILL.md`](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-prompt/SKILL.md) (Prompt Director), [`scripts/preflight.py`](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/scripts/preflight.py) (Prompt Preflight), [`skills/higgsfield-recall/SKILL.md`](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-recall/SKILL.md) (Generation Recall)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Prompt Guidance"]
  node_root["Root Skill Router<br/>[SKILL.md]"]
  node_prompt["Prompt Director<br/>[SKILL.md]"]
  node_models["Model Selection<br/>[SKILL.md]"]
  node_recipes["Genre Recipes<br/>[SKILL.md]"]
  node_soul["Character Consistency<br/>[SKILL.md]"]
  node_templates["Prompt Templates"]
end

subgraph group_production["Production Workflows"]
  node_cinema["Cinema Studio<br/>[SKILL.md]"]
  node_seedance["Seedance Direction<br/>[SKILL.md]"]
  node_seedance25["Seedance 2.5<br/>[SKILL.md]"]
  node_vfx["Seedance VFX<br/>[SKILL.md]"]
  node_acting["Acting Direction<br/>[SKILL.md]"]
  node_pipeline["Production Pipeline<br/>[SKILL.md]"]
  node_scene["Scene Audit<br/>[SKILL.md]"]
  node_character["Character Design<br/>[SKILL.md]"]
  node_image["Image Direction<br/>[SKILL.md]"]
  node_three_d["3D Production<br/>[SKILL.md]"]
  node_marketing["Marketing Studio<br/>[SKILL.md]"]
  node_content["Content Factory<br/>[SKILL.md]"]
  node_repurpose["Video Repurposing<br/>[SKILL.md]"]
  node_canvas["Canvas Workspace<br/>[SKILL.md]"]
end

subgraph group_platform["Platform Guidance"]
  node_troubleshoot["Generation Troubleshooting<br/>[SKILL.md]"]
  node_platform(("Higgsfield Platform"))
  node_result["Generated Media"]
end

subgraph group_internal["Internal Support"]
  node_preflight["Prompt Preflight<br/>[preflight.py]"]
  node_specs["Model Specifications<br/>[model-specs.json]"]
  node_recall["Generation Recall<br/>[SKILL.md]"]
  node_memory[("Learning Memory")]
end

node_user(("Claude User"))

node_user -->|"submits request"| node_root
node_root -->|"routes to"| node_prompt
node_root -->|"routes to"| node_models
node_root -->|"routes to"| node_recipes
node_root -->|"routes to"| node_soul
node_root -->|"routes to"| node_cinema
node_root -->|"routes to"| node_seedance
node_root -->|"routes to"| node_seedance25
node_root -->|"routes to"| node_vfx
node_root -->|"routes to"| node_acting
node_root -->|"routes to"| node_pipeline
node_root -->|"routes to"| node_scene
node_root -->|"routes to"| node_character
node_root -->|"routes to"| node_image
node_root -->|"routes to"| node_three_d
node_root -->|"routes to"| node_marketing
node_root -->|"routes to"| node_content
node_root -->|"routes to"| node_repurpose
node_root -->|"routes to"| node_canvas
node_root -->|"routes to"| node_troubleshoot
node_prompt -->|"uses"| node_templates
node_prompt -.->|"checks constraints"| node_preflight
node_preflight -->|"checks against"| node_specs
node_prompt -->|"produces prompt"| node_result
node_user -.->|"submits prompt"| node_platform
node_platform -.->|"generates media"| node_result
node_recall -->|"reads and writes"| node_memory

click node_root "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/SKILL.md"
click node_prompt "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-prompt/SKILL.md"
click node_models "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-models/SKILL.md"
click node_recipes "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-recipes/SKILL.md"
click node_soul "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-soul/SKILL.md"
click node_templates "https://github.com/osidemedia/higgsfield-ai-prompt-skill/tree/main/templates"
click node_cinema "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-cinema/SKILL.md"
click node_seedance "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-seedance/SKILL.md"
click node_seedance25 "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-seedance-2-5/SKILL.md"
click node_vfx "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-seedance-vfx/SKILL.md"
click node_acting "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-acting/SKILL.md"
click node_pipeline "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-pipeline/SKILL.md"
click node_scene "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-scene-engine/SKILL.md"
click node_character "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-character-design/SKILL.md"
click node_image "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-gpt-image-2/SKILL.md"
click node_three_d "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-3d/SKILL.md"
click node_marketing "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-marketing-studio/SKILL.md"
click node_content "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-content-factory/SKILL.md"
click node_repurpose "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-repurpose/SKILL.md"
click node_canvas "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-canvas/SKILL.md"
click node_troubleshoot "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-troubleshoot/SKILL.md"
click node_preflight "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/scripts/preflight.py"
click node_specs "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/specs/model-specs.json"
click node_recall "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-recall/SKILL.md"
click node_memory "https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/scripts/higgsfield_memory.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_root,node_prompt,node_models,node_recipes,node_soul,node_templates,node_user toneBlue
class node_cinema,node_seedance,node_seedance25,node_vfx,node_acting,node_pipeline,node_scene,node_character,node_image,node_three_d,node_marketing,node_content,node_repurpose,node_canvas toneAmber
class node_troubleshoot,node_platform,node_result toneMint
class node_preflight,node_specs,node_recall,node_memory toneRose
```

## Components

### Prompt Guidance

- [Root Skill Router](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/SKILL.md): `SKILL.md`
- [Prompt Director](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-prompt/SKILL.md): `skills/higgsfield-prompt/SKILL.md`
- [Model Selection](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-models/SKILL.md): `skills/higgsfield-models/SKILL.md`
- [Genre Recipes](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-recipes/SKILL.md): `skills/higgsfield-recipes/SKILL.md`
- [Character Consistency](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-soul/SKILL.md): `skills/higgsfield-soul/SKILL.md`
- [Prompt Templates](https://github.com/osidemedia/higgsfield-ai-prompt-skill/tree/main/templates): `templates`

### Production Workflows

- [Cinema Studio](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-cinema/SKILL.md): `skills/higgsfield-cinema/SKILL.md`
- [Seedance Direction](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-seedance/SKILL.md): `skills/higgsfield-seedance/SKILL.md`
- [Seedance 2.5](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-seedance-2-5/SKILL.md): `skills/higgsfield-seedance-2-5/SKILL.md`
- [Seedance VFX](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-seedance-vfx/SKILL.md): `skills/higgsfield-seedance-vfx/SKILL.md`
- [Acting Direction](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-acting/SKILL.md): `skills/higgsfield-acting/SKILL.md`
- [Production Pipeline](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-pipeline/SKILL.md): `skills/higgsfield-pipeline/SKILL.md`
- [Scene Audit](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-scene-engine/SKILL.md): `skills/higgsfield-scene-engine/SKILL.md`
- [Character Design](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-character-design/SKILL.md): `skills/higgsfield-character-design/SKILL.md`
- [Image Direction](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-gpt-image-2/SKILL.md): `skills/higgsfield-gpt-image-2/SKILL.md`
- [3D Production](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-3d/SKILL.md): `skills/higgsfield-3d/SKILL.md`
- [Marketing Studio](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-marketing-studio/SKILL.md): `skills/higgsfield-marketing-studio/SKILL.md`
- [Content Factory](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-content-factory/SKILL.md): `skills/higgsfield-content-factory/SKILL.md`
- [Video Repurposing](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-repurpose/SKILL.md): `skills/higgsfield-repurpose/SKILL.md`
- [Canvas Workspace](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-canvas/SKILL.md): `skills/higgsfield-canvas/SKILL.md`

### Platform Guidance

- [Generation Troubleshooting](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-troubleshoot/SKILL.md): `skills/higgsfield-troubleshoot/SKILL.md`
- **Higgsfield Platform**
- **Generated Media**

### Internal Support

- [Prompt Preflight](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/scripts/preflight.py): `scripts/preflight.py`
- [Model Specifications](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/specs/model-specs.json): `specs/model-specs.json`
- [Generation Recall](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/skills/higgsfield-recall/SKILL.md): `skills/higgsfield-recall/SKILL.md`
- [Learning Memory](https://github.com/osidemedia/higgsfield-ai-prompt-skill/blob/main/scripts/higgsfield_memory.py): `scripts/higgsfield_memory.py`

### Other components

- **Claude User**

## Connections

- Claude User → Root Skill Router: submits request (evidence: `README.md`)
- Root Skill Router → Prompt Director: routes to (evidence: `README.md`)
- Root Skill Router → Model Selection: routes to (evidence: `README.md`)
- Root Skill Router → Genre Recipes: routes to (evidence: `README.md`)
- Root Skill Router → Character Consistency: routes to (evidence: `README.md`)
- Root Skill Router → Cinema Studio: routes to (evidence: `README.md`)
- Root Skill Router → Seedance Direction: routes to (evidence: `README.md`)
- Root Skill Router → Seedance 2.5: routes to (evidence: `README.md`)
- Root Skill Router → Seedance VFX: routes to (evidence: `README.md`)
- Root Skill Router → Acting Direction: routes to (evidence: `README.md`)
- Root Skill Router → Production Pipeline: routes to (evidence: `README.md`)
- Root Skill Router → Scene Audit: routes to (evidence: `README.md`)
- Root Skill Router → Character Design: routes to (evidence: `README.md`)
- Root Skill Router → Image Direction: routes to (evidence: `README.md`)
- Root Skill Router → 3D Production: routes to (evidence: `README.md`)
- Root Skill Router → Marketing Studio: routes to (evidence: `README.md`)
- Root Skill Router → Content Factory: routes to (evidence: `README.md`)
- Root Skill Router → Video Repurposing: routes to (evidence: `README.md`)
- Root Skill Router → Canvas Workspace: routes to (evidence: `README.md`)
- Root Skill Router → Generation Troubleshooting: routes to (evidence: `README.md`)
- Prompt Director → Prompt Templates: uses (evidence: `README.md`)
- Prompt Director → Prompt Preflight: checks constraints
- Prompt Preflight → Model Specifications: checks against (evidence: `scripts/preflight.py`)
- Prompt Director → Generated Media: produces prompt (evidence: `README.md`)
- Claude User → Higgsfield Platform: submits prompt
- Higgsfield Platform → Generated Media: generates media
- Generation Recall → Learning Memory: reads and writes (evidence: `scripts/higgsfield_memory.py`)
