Agent-almanac audit-icon-pipeline

install

source · Clone the upstream repo

git clone https://github.com/pjt222/agent-almanac

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/pjt222/agent-almanac "$T" && mkdir -p ~/.claude/skills && cp -r "$T/i18n/de/skills/audit-icon-pipeline" ~/.claude/skills/pjt222-agent-almanac-audit-icon-pipeline-c700a4 && rm -rf "$T"

manifest: i18n/de/skills/audit-icon-pipeline/SKILL.md

source content

Icon-Pipeline pruefen

Fehlende Glyphen, fehlende Icons und veraltete Manifeste erkennen durch Abgleich von Registries mit Glyph-Zuordnungsdateien, Icon-Verzeichnissen und Manifesten. Erzeugt einen strukturierten Lueckenbericht fuer Skills, Agents und Teams.

Wann verwenden

Nach dem Hinzufuegen neuer Skills, Agents oder Teams, um zu pruefen, ob Icons benoetigt werden
Vor einem vollstaendigen Pipeline-Rendering, um fehlende Elemente zu identifizieren
Nach Registry-Aktualisierungen, um Manifest-Synchronisation sicherzustellen
Periodische Zustandspruefung der Icon-Pipeline

Eingaben

Optional: Entitaetstypfilter —
```
skill
```
,
```
agent
```
,
```
team
```
oder
```
all
```
(Standard:
```
all
```
)
Optional: Zu pruefende Palette (Standard:
```
cyberpunk
```
— die Referenzpalette)

Verfahren

Schritt 1: Registries lesen

Alle Entitaets-IDs aus den massgeblichen Registries zusammentragen.

```
skills/_registry.yml
```
lesen — alle Skill-IDs ueber alle Domaenen extrahieren
```
agents/_registry.yml
```
lesen — alle Agent-IDs extrahieren
```
teams/_registry.yml
```
lesen — alle Team-IDs extrahieren
Zaehlerstaende festhalten: Gesamt-Skills, -Agents, -Teams

Erwartet: Drei Listen von Entitaets-IDs mit Zaehlerstaenden, die

total_skills

total_agents

total_teams

entsprechen.

Bei Fehler: Falls eine Registry-Datei fehlt, den Pfad melden und diesen Entitaetstyp ueberspringen.

Schritt 2: Glyph-Zuordnungen lesen

Alle zugeordneten Entitaets-IDs aus den Glyph-Zuordnungsdateien zusammentragen.

```
viz/R/glyphs.R
```
lesen — alle Schluessel aus der
```
SKILL_GLYPHS
```
-Liste extrahieren
```
viz/R/agent_glyphs.R
```
lesen — alle Schluessel aus der
```
AGENT_GLYPHS
```
-Liste extrahieren
```
viz/R/team_glyphs.R
```
lesen — alle Schluessel aus der
```
TEAM_GLYPHS
```
-Liste extrahieren

Erwartet: Drei Listen zugeordneter IDs.

Bei Fehler: Falls eine Glyph-Datei fehlt, dies melden und alle Entitaeten dieses Typs als nicht zugeordnet markieren.

Schritt 3: Fehlende Glyphen berechnen

Registry-IDs gegen zugeordnete IDs abgleichen.

Fehlende Skill-Glyphen:
```
registry_skill_ids - mapped_skill_ids
```
Fehlende Agent-Glyphen:
```
registry_agent_ids - mapped_agent_ids
```
Fehlende Team-Glyphen:
```
registry_team_ids - mapped_team_ids
```

Erwartet: Listen von Entitaets-IDs, die in Registries existieren, aber keine zugeordnete Glyphen-Funktion haben.

Bei Fehler: Falls die Differenzberechnung fehlschlaegt, ID-Formate zwischen Registry und Glyph-Dateien pruefen (z.B. Unterstriche vs. Bindestriche).

Schritt 4: Gerenderte Icons pruefen

Verifizieren, dass zugeordnete Glyphen entsprechende gerenderte Icon-Dateien haben.

Fuer jede zugeordnete Skill-ID pruefen:

viz/public/icons/<palette>/<domain>/<skillId>.webp

Fuer jede zugeordnete Agent-ID pruefen:

viz/public/icons/<palette>/agents/<agentId>.webp

Fuer jede zugeordnete Team-ID pruefen:

viz/public/icons/<palette>/teams/<teamId>.webp

HD-Varianten in
```
viz/public/icons-hd/
```
mit derselben Struktur pruefen

Erwartet: Listen von Entitaeten mit Glyphen, aber fehlenden gerenderten Icons (Standard und/oder HD).

Bei Fehler: Falls das Icon-Verzeichnis nicht existiert, wurde die Pipeline noch nicht ausgefuehrt — alle als fehlend melden.

Schritt 5: Manifest-Aktualitaet pruefen

Manifest-Zaehlerstaende mit Registry-Zaehlerstaenden vergleichen.

```
viz/public/data/icon-manifest.json
```
lesen — Eintraege zaehlen

viz/public/data/agent-icon-manifest.json

lesen — Eintraege zaehlen

```
viz/public/data/team-icon-manifest.json
```
lesen — Eintraege zaehlen
Mit Registry-Gesamtzahlen vergleichen

Erwartet: Manifest-Zaehlerstaende stimmen mit Registry-Zaehlerstaenden ueberein. Abweichungen zeigen veraltete Manifeste an.

Bei Fehler: Falls Manifest-Dateien nicht existieren, muss die Daten-Pipeline zuerst ausgefuehrt werden (

node build-data.js && node build-icon-manifest.js

Step 6: Detect Orphan Icons

Walk

viz/public/icons*/

and flag WebP files whose

<palette>/<domain>/<skillId>

triple does not appear in

icon-manifest.json

Enumerate all WebP files:
```
find viz/public/icons* -name "*.webp"
```
For each file, extract
```
<domain>/<id>
```
from its path
Check if
```
<domain>/<id>
```
has an entry in
```
icon-manifest.json
```
Collect non-matching files as orphans — they exist on disk but are no longer referenced

# Quick orphan count per palette
node -e "
const fs = require('fs');
const manifest = JSON.parse(fs.readFileSync('viz/public/data/icon-manifest.json'));
const ids = new Set(manifest.map(e => e.domain + '/' + e.id));
const orphans = require('child_process')
  .execSync('find viz/public/icons -name \"*.webp\"').toString().trim().split('\n')
  .filter(p => { const parts = p.split('/'); const id = parts.slice(-2).join('/').replace('.webp',''); return !ids.has(id); });
console.log('Orphans:', orphans.length);
orphans.forEach(p => console.log(' ', p));
"

Expected: Zero orphans. Any orphans indicate skills re-homed to a different domain without cleanup.

On failure: Delete orphans manually — they have no corresponding manifest entry and will not be served.

Schritt 6: Lueckenbericht generieren

Eine strukturierte Zusammenfassung erstellen.

Ausgabe als uebersichtliche Tabelle oder Liste formatieren:

=== Icon Pipeline Audit ===

MISSING GLYPHS (no glyph function):
  Skills: 5 missing — [list]
  Agents: 2 missing — [list]
  Teams: 0 missing

MISSING ICONS (glyph exists, no rendered WebP):
  Standard (512px): 3 skills, 1 agent
  HD (1024px): 8 skills, 3 agents, 1 team

STALE MANIFESTS:
  icon-manifest.json: 320 entries vs 326 registry (stale)
  agent-icon-manifest.json: 66 entries vs 66 registry (OK)
  team-icon-manifest.json: 15 entries vs 15 registry (OK)

Naechste Schritte basierend auf den Ergebnissen vorschlagen

Erwartet: Ein vollstaendiger Lueckenbericht mit umsetzbaren naechsten Schritten.

Bei Fehler: Falls alle Pruefungen ohne Luecken bestehen, "Pipeline vollstaendig synchron" als positives Ergebnis melden.

Validierungscheckliste

Alle drei Registries erfolgreich gelesen
Alle drei Glyph-Zuordnungsdateien geprueft
Icon-Verzeichnisse fuer Standard und HD durchsucht
Manifest-Aktualitaet verifiziert
Lueckenbericht mit Zaehlerstaenden und Entitaetslisten erstellt
Umsetzbare naechste Schritte angegeben

Haeufige Fehler

ID-Format-Abweichung: Registry verwendet Kebab-Case (
```
create-skill
```
), Glyph-Zuordnungen koennen Snake-Case-Schluessel verwenden — Vergleich muss normalisieren
Palettenannahme: Nur die Cyberpunk-Palette zu pruefen uebersieht palettenspezifische Rendering-Luecken
Leere Verzeichnisse: Ein vorhandenes, aber leeres Domaenenverzeichnis zaehlt beim Globbing als "Icons vorhanden" — Dateiexistenz pruefen, nicht Verzeichnisexistenz
HD nicht gerendert: HD-Icons befinden sich in einem separaten Verzeichnisbaum (
```
icons-hd/
```
) — nicht mit Standard-Icons verwechseln