lowlightstudio/the-lineage

THE LINEAGE

Ein Foto geht hinein. Der Skill misst zehn Merkmale auf dem Rechner des Benutzers, erkennt, zu welchem Jahrzehnt diese Merkmale gehören, und erstellt den Stammbaum des Fotos: einen Look pro Jahrzehnt auf dem Stamm von den 1930er bis zu den 2020ern, zwei weitere daneben als Zweige – jeder ein benannter Film, Kameramann, Fotograf, Kampagne oder Workflow mit Begründung, warum er dazu gehört. Dann studiert er die Richtung des Stamms und wächst einen 2027er-Zweig an der Stelle, wo die Bibliothek gar keinen Look hat: einen Namen, ein Rezept, was er von wem erbt, und den Beweis, dass es eine Lücke ist („Keiner der 107 Looks ist gleichzeitig so warm und so körnig“). Dieser Lückensatz ist die Signatur: Er macht den Zweig zu einem Look, den noch niemand gemacht hat, nicht zu einer Vermutung.

Alles bis zum Zweig ist lokale Arithmetik und kostet nichts. Das Einzige, was generiert wird, ist die finale Neubelichtung des eigenen Fotos des Benutzers in diesen Zweig, und sie läuft auf dem Higgsfield-Konto des Benutzers, nachdem er zugestimmt hat.

Installation

bash install.sh              # den Skill, den Studio-Ordner, Prüfung der optionalen Tools
bash install.sh --higgsfield # zusätzlich Higgsfield CLI + MCP, um auf dem eigenen Konto zu generieren

Nur Standard-Python-Bibliothek. JPEG und HEIC werden über sips (macOS) oder ffmpeg geöffnet; PNG benötigt nichts.

Ausführung

Wenn der Benutzer danach fragt, tut Claude Folgendes:

1. Den Stammbaum erstellen. python3 scripts/lineage.py trace "<foto>" --project "<projekt>" (beliebiges JPG, PNG oder HEIC; das Projekt ist standardmäßig the-lineage). Es gibt die vier Messwerte (Licht, Körnung, Bildausschnitt, Farbe), das Jahrzehnt mit seinem Anteil an der Punktzahl und den Zweitplatzierten sowie den Stamm von den 1930ern bis heute mit dem aus, was jeder Look mit dem Foto gemeinsam hat. Teilen Sie dem Benutzer zuerst das Jahrzehnt mit, dann die zwei oder drei wichtigsten Looks des Stamms. Wenn es „eine knappe Sache“ sagt, nennen Sie beide Jahrzehnte: Das ist die ehrliche Messung.
2. Den Zweig wachsen lassen. python3 scripts/lineage.py grow latest --project "<projekt>". Es gibt den 2027er-Zweig aus: seinen Namen und seine Aussage, das Rezept (Licht, Farbe, Schwarztöne, Körnung, Optik, Format), was er erbt und von welchem Look, und die Lücke. Wenn der Benutzer eine andere Option möchte, findet --seed 1 (2, 3…) eine weitere Lücke mit denselben Regeln.
3. Exportieren. python3 scripts/lineage.py export latest --project "<projekt>" schreibt trees/<id>.svg (ein druckbares Poster: der Stamm, der von 1930 aufsteigt, die purpurrote 2027er-Knospe an der Spitze), trees/<id>.json (jede Zahl) und trees/<id>-branch.md (die Zweigkarte mit dem Rezept). Öffnen Sie das Poster (open <datei> auf einem Mac) und sagen Sie in einem Satz, worauf zuerst zu achten ist: die Knospe und der Stamm-Look direkt darunter.
4. Anhalten und vor der Generierung fragen. Nur wenn der Benutzer den Look auf seinem eigenen Foto haben möchte: python3 scripts/lineage.py request latest --project "<projekt>" schreibt eine Bildbearbeitungsanfrage. Teilen Sie ihm mit, dass es eine Generierung ist und was sie auf seinem Higgsfield-Plan kostet, und warten Sie auf ein Ja. Führen Sie sie dann aus (siehe unten) und überprüfen Sie mit python3 scripts/lineage.py status latest --project "<projekt>".

Erklären eines Knotens: python3 scripts/lineage.py node <id> gibt einen Look vollständig aus (warum er in der Linie ist, was er weitergibt, Personen, wo er zu finden ist, Eltern). python3 scripts/lineage.py library --decade 1970 listet ein Jahrzehnt auf. Eigene Referenzen: python3 scripts/lineage.py add --name "..." --year 1994 --why "..." --image ref.jpg misst das Bild und fügt den Look für jeden folgenden Baum zur eigenen Linie hinzu (Referenzen sind maschinenweit, nicht projektspezifisch; --project wird akzeptiert und ignoriert).

Probieren Sie es mit dem beigefügten Beispiel aus (kostet nichts): python3 scripts/lineage.py example --project demo (oder --photo pool für das zweite Standbild). Um zu prüfen, ob es auf diesem Rechner funktioniert: python3 scripts/selftest.py.

Wie bewerte ich das Ergebnis?

• Warnen Sie vor schwacher Grundlage. Ohne Personen, eine sichtbare Lichtquelle oder Studiolicht hat der Meter wenig, woran er sich halten kann: Übereinstimmungen unter 30 Prozent über den gesamten Stamm bedeuten, dass das Foto schlecht passt. Sagen Sie es, bevor der Benutzer den Baum als Geschichte liest.
• Das Jahrzehnt ist eine Messung, kein Urteil. Ein Anteil über 25 Prozent mit deutlichem Abstand zum Zweitplatzierten ist eine sichere Messung; weniger als 5 Punkte Unterschied sind eine knappe Sache, und beide Jahrzehnte sind gültig. Die Neukomprimierung eines Fotos verändert seine Körnung und kann sie verschieben.
• Ein Stamm-Look verdient seinen Platz, wenn er zwei charakteristische Merkmale mit dem Foto teilt (die shares-Zeile), nicht nur eine Farbe. Eine Übereinstimmung über 50 Prozent ist nahe Verwandtschaft; unter 30 Prozent hatte das Jahrzehnt einfach nichts Näheres – sagen Sie es.
• Ein Zweig ist gut, wenn sein Lückensatz ein Paar starker Merkmale nennt, die kein Look in der Bibliothek zusammen hat, sein nächstgelegener vorhandener Look bei 70 Prozent oder weniger liegt und er den Bildausschnitt des Fotos beibehält. Lehnen Sie einen Zweig ab, dessen Rezept sich beim Film widerspricht (Split-Toning bei Schwarz-Weiß): Wachsen Sie einen anderen Samen.
• Durchgezogene Linien sind dokumentierte Einflüsse, gepunktete Linien sind Verwandtschaft von Merkmalen. Stellen Sie eine gepunktete Linie niemals als Geschichte dar.
• Die lokalen Zahlen sind Arithmetik, die Sie im Baum-JSON überprüfen können; references/method.md erklärt jede einzelne und ihre Grenzen. library/reading-card.md ist dieselbe Messung mit dem Auge.

Generierung auf dem Higgsfield-Konto des Benutzers

Nichts in diesem Skill generiert von selbst. request schreibt ~/LOWLIGHT STUDIO/<project>/requests/<id>.json (Prompt, das Foto des Benutzers als Referenz, Seitenverhältnis). Claude führt es über das Higgsfield MCP aus, das als der Benutzer angemeldet ist, und legt das Ergebnis ab:

python3 scripts/studio_bus.py requests <project>
python3 scripts/studio_bus.py receive <project> <id> <heruntergeladene Datei>

Es ist eine Bildbearbeitung: Der Prompt beschreibt nur das Licht, die Farbe und die Filmoberfläche des Zweigs. Verwenden Sie ein Edit-Modell, das der Plan des Benutzers anbietet (Nano Banana Pro oder ein Seedream Edit-Modell funktionieren gut). Bevor Sie etwas ausführen, teilen Sie dem Benutzer mit, wie viele Generationen es sind und was es auf seinem Plan kostet, und warten Sie auf ein Ja. Siehe references/generation.md.

Kommunikation mit anderen Abteilungen

Siehe references/studio.md. Es liest taste aus „The Eye“, wenn es existiert (Vorlieben und Ablehnungen beeinflussen, wo der 2027er-Zweig wächst; der Zweig sagt taste_used) und veröffentlicht lineage: die letzten zwölf Bäume mit ihren Knoten und Zweigen, die The Eye als zusätzliches Deck nutzen kann. Ohne andere Abteilungen funktioniert es genauso.

Dateien

Pfad	Was es ist
scripts/lineage.py	der Motor und seine Kommandozeile: example, trace, grow, export, request, status, trees, library, node, add
scripts/meter.py	der Fotomesser: zehn Merkmale, Messwerte, Palette, Format (python3 scripts/meter.py foto.jpg --brief)
scripts/demo_photo.py	zeichnet die beiden Beispiel-Standbilder aus Code (niemandes Bilder sind enthalten)
scripts/selftest.py	ein Probelauf mit synthetischen Fotos und den Beispielen: python3 scripts/selftest.py
library/lineage.json	die 107 Looks, 1930er bis 2020er: Personen, Grund, Merkmale, Palette, Eltern
library/examples/	die beiden Beispiel-Standbilder, aus Code gezeichnet (siehe seine README)
library/reading-card.md	dieselbe Messung mit dem Auge, für ein Foto an der Wand oder auf dem Handy
references/method.md	wie der Meter, das Jahrzehnt, der Stamm und die Lücke berechnet werden, und ihre Grenzen
references/library.md	wie ein Look geschrieben wird, wie man einen hinzufügt oder korrigiert
references/generation.md	Higgsfield-Einrichtung und wie die Anfrage aufgebaut wird
references/studio.md	der gemeinsame Bus zwischen den Abteilungen von THE STUDIO

Die Ausgaben landen in ~/LOWLIGHT STUDIO/<project>/: trees/, requests/, received/.