Communitygithub.com

Markenrichtlinien-Builder

Verwandle vorhandene Marken-Assets in wiederverwendbare Regeln, trenne aufgezeichnete Fakten von abgeleiteten Entscheidungen und prüfe vorgeschlagene Dokumente gegen die Markenspezifikation.

Was ist Markenrichtlinien-Builder?

Der Markenrichtlinien-Builder verwandelt einen Ordner mit Marken-Assets (Stylesheets, Theme-Dateien, Logos, Bilder, Notizen) in eine strukturierte, maschinenlesbare Markenspezifikation (`brand-spec.json`). Er führt eine Prüfung durch, kennzeichnet jeden nicht direkt aus einer Deklaration lesbaren Wert als `"source": "inferred"` und zwingt den Benutzer, diese abgeleiteten Werte mit dem Markeninhaber zu bestätigen, bevor sie in einem Agenten-Skill verwendet werden. Das Tool generiert fertige Regelblöcke (`references/skill-rules.md`), die in den Skill eingefügt werden können, und prüft jeden Ausgabeentwurf mit `tools/brand_check.py` anhand von zwölf nicht verhandelbaren Markenregeln. Es ist besonders nützlich für Entwickler, die mit KI-Agenten wie Claude Code, Cursor oder Codex arbeiten, um konsistente Markenrichtlinien durchzusetzen, ohne dass ein Agent die Marke neu interpretieren oder falsch darstellen kann.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/byoverseas/knacco-free-skills/tree/HEAD/skills/kit-brand-guide-builder

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Markenrichtlinien-Builder?

Ein Ordner mit Marken-Assets ist kein Marken-Skill. Ein Marken-Skill ist ein schriftlicher Satz von Regeln, die ein Agent ohne Aufforderung anwendet, und er kann nur aus einer Prüfung dessen aufgebaut werden, was die Marke tatsächlich tut.

Status: v1.0 | Kategorie: Skills | Preis: Kostenlos

Lies den Produktleitfaden, bevor du eine Prüfung durchführst. Führe die enthaltenen Tools aus diesem Produktordner aus. Bewahre deine Markendateien in deinem eigenen Arbeitsbereich auf.

Was dieser Skill tut

  1. Nimmt einen Ordner mit Marken-Assets entgegen: Stylesheets, Theme-Dateien, Logodateien, Bilder, Notizen.
  2. Führt tools/brand_audit.py über den Ordner aus und schreibt brand-spec.json mit einer priorisierten Palette, benannten Farbrollen, der Typografie-Hierarchie, Logovarianten und Freiraum, Bildregeln, sicheren Kontrastpaarungen und Anti-Patterns.
  3. Markiert jeden Wert, den er nicht aus einer Deklaration lesen konnte, als "source": "inferred" und listet seinen Pfad in unconfirmed auf.
  4. Stellt die zwölf Eigentümerfragen dem Markeninhaber und zeichnet die Antworten zu diesen Pfaden auf.
  5. Übergibt dir die Regelblöcke in references/skill-rules.md zum Einfügen in den Skill, den du baust, und prüft jede Ausgabe mit tools/brand_check.py, bevor sie ausgeliefert wird.

Route

  • Einen Ordner prüfen → python3 tools/brand_audit.py <ordner> --out brand-spec.json --json, dann lies Abschnitt 4 der GUIDE.md, bevor du einem einzelnen Wert vertraust.
  • Den Eigentümer fragen → references/owner-questions.md. Alle zwölf, auch wenn die Prüfung nur eine Frage aufwirft.
  • Den Skill bauen → references/skill-rules.md. Füge die Blöcke in den Skill ein, fülle die bestätigten Werte aus, behalte die Ablehnungsregeln.
  • Eine Ausgabe prüfen → python3 tools/brand_check.py brand-spec.json output-description.json. Zwölf Regeln, eine Punktzahl, Exit 2 bei Fehlschlag.
  • Text auf Konformität prüfen → Richte den Prüfer auf eine Textdatei. Er prüft die Palette, die Schriftgrößen und den Markennamen und überspringt Regeln, die Text nicht transportieren kann.

Nicht verhandelbare Regeln

  • Die Prüfung kommt vor dem Skill. Ein Skill, der aus einem Ordner ohne Prüfung geschrieben wurde, ist ein Satz von Vermutungen mit Markenvokabular.
  • Jeder abgeleitete Wert wird vom Eigentümer bestätigt. Eine Regel, die auf einer unbestätigten Ableitung basiert, ist schlimmer als keine Regel.
  • Die Spezifikation ist die einzige Quelle für Farbe, Schrift und Logo. Der gebaute Skill führt keine eigene Kopie der Palette mit.
  • Der Skill wendet die Marke an. Er entwirft sie nicht neu, verbessert sie nicht und modernisiert sie nicht.
  • Kein Logo wird jemals neu gezeichnet, neu gestreckt oder aus einer Beschreibung neu aufgebaut. Die Datei wird so verwendet, wie sie ist, oder die Ausgabe wird ohne sie ausgeliefert.
  • Der Prüfer läuft vor der Auslieferung. Ein vom Eigentümer gefundener Markenbruch ist ein anderes Problem als einer, den der Prüfer findet.

Dateien

DateiVerwendung
GUIDE.mdDie vollständige Methode: Sammeln, Prüfen, Bauen – und warum die Reihenfolge nicht umgekehrt werden kann
references/audit-fields.mdJedes Feld in der Markenspezifikation: Typ, wie es abgeleitet, gelesen oder erschlossen wird
references/skill-rules.mdEinfügefertige Regelblöcke für den Skill, den du baust
references/owner-questions.mdDie zwölf Fragen, mit Erläuterung, was schiefgeht, wenn eine ausgelassen wird
tools/brand_audit.pyDurchläuft einen Ordner und schreibt brand-spec.json
tools/brand_check.pyZwölf Regeln gegen einen vorgeschlagenen Ausgabeentwurf, bewertet mit Punkten von 100

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Verwandte Skills