Codex Skills: Speicherorte, Funktionsweise der $-Aufrufe und Erstellung

Ein Skill ist ein Verzeichnis. Die einzige erforderliche Datei ist SKILL.md: YAML-Frontmatter mit einem name und einer description, gefolgt von Markdown-Anweisungen. Drei optionale Ordner liefern die Substanz, auf die sich die Anweisungen beziehen können: scripts/ für ausführbaren Code, den der Skill von Codex ausführen lässt, references/ für Dokumentationen, die zu lang für Inline-Text sind, und assets/ für Templates. Eine optionale agents/openai.yaml fügt UI-Metadaten und Abhängigkeiten für die Distribution hinzu.

---
name: apply-design-system
description: Apply the project design system when building or editing UI. Use for any component, page, or styling task; reads DESIGN.md and forbids colors, fonts, or spacing outside its tokens.
---

# Apply the design system

1. Read DESIGN.md at the repo root before writing any UI code.
2. Use only its semantic tokens for color, its type scale for text,
   and its spacing scale for layout.
3. If a needed value has no token, stop and say so instead of
   inventing one.

• .agents/skills/ im Repository: Projekt-Skills, die mit jedem geteilt werden, der das Repo klont.
• ~/.agents/skills/: Ihre persönlichen Skills, die in jedem Projekt verfügbar sind.
• /etc/codex/skills: vom Administrator verwaltete Skills auf gemeinsam genutzten Maschinen.
• System-Bundles, die mit dem Produkt ausgeliefert werden.
• Installierte Skills: $skill-installer lädt kuratierte Skills; Plugins ermöglichen die Distribution darüber hinaus.

Der Repo-Standort ist derjenige, der das Teamverhalten verändert. Ein Skill in .agents/skills/ reist mit der Codebasis mit: Jeder Collaborator, jeder CI-Run und jeder frische Clone erhält dieselben Prozeduren ohne Setup. Projektvereinbarungen, das Styling der UI oder Release-Prozesse gehören hierher und nicht in das Home-Verzeichnis einer einzelnen Person.

Der explizite Aufruf ist der einfache Fall: Geben Sie $ in der Codex CLI ein und wählen Sie den Skill aus; er wird unabhängig von seiner Beschreibung geladen. Interessanter ist der implizite Fall: Codex hält den Namen und die Beschreibung jedes Skills bereit und lädt den vollständigen Inhalt, wenn die Anfrage Ihrer Meinung nach passt. Diese Entscheidung ist nur so gut wie die Beschreibung, was diese zur eigentlichen Schnittstelle macht. "Verwenden für jede Komponente, Seite oder Styling-Aufgabe" liefert dem Matcher Verben und Situationen zur Zuordnung; "Design-Helfer" liefert nichts.

Codex liest AGENTS.md bei jedem Durchlauf: Sie enthält die dauerhaften Anweisungen des Projekts, Build-Befehle, Konventionen und Einschränkungen – jede Zeile kostet bei jeder Anfrage Rechenkapazität. Skills sind das gegenteilige Konzept: nahezu null Kosten im Leerlauf, vollständige Prozeduren bei Relevanz. Die effiziente Aufteilung besteht aus kurzen Regeln in AGENTS.md, langen Prozeduren in Skills und dauerhaften Artefakten (Token-Dateien, DESIGN.md, Schemas) im Repo, auf die beide verweisen können. Die vollständige Dateitaxonomie, einschließlich der Position von CLAUDE.md und DESIGN.md, finden Sie unter CLAUDE.md vs AGENTS.md vs SKILL.md vs DESIGN.md.

Der obige Beispiel-Skill besteht aus neun Zeilen Anweisungen, und genau das ist seine Stärke. Alles, was er erzwingt, lebt in einem Artefakt: einer DESIGN.md im Repo-Root, die das eigentliche System enthält – semantische Design-Tokens für Light- und Dark-Mode, die Typografie-Skala, Spacing, Motive und Verbote. Codex ist ein starker Implementierer, besitzt aber kein visuelles Gedächtnis zwischen den Sessions; die Datei ist das Gedächtnis. Skills voller Adjektive ("clean, modern, konsistent") bewirken nichts, da es keinen Referenzpunkt für die Prüfung der Arbeit gibt. Ein Skill, der auf eine Datei mit exakten Werten verweist, macht jede Styling-Entscheidung zu einem einfachen Nachschlagevorgang.

npx --yes identityforge@latest apply ambient-sage

The SKILL.md convention grew into an open agent-skills standard: Claude Code discovers the same shape under .claude/skills/, and Cursor's Agent Skills load the same way next to its Rules. Discovery paths and invocation syntax differ per tool; the anatomy and the description-driven trigger do not. Write skills that reference artifacts in your repository rather than one tool's internals and they transfer almost verbatim; the Claude Code side of the same story is in Claude Code skills, explained.