Skills

Jede Entwicklergewohnheit entspricht einem eigenständigen Skill, einem Ordner mit Referenzdokumenten, Skripten und Fallstricken aus echten Fehlschlägen. In Claude Code rufst du ihn per Slash-Befehl auf, in Codex direkt über den Skill-Namen.

Skill	Wann nutzen	Was er tut
/think	Vor neuem Code	Hinterfragt Anforderungen und erstellt direkt umsetzbare, entscheidungsreife Pläne.
/ui	Frontend-UIs bauen	Entwickelt unverwechselbare UIs mit klarer gestalterischer Richtung statt Standard-Vorlagen, auf Wunsch auch mit Iteration anhand von Screenshots.
/check	Nach einer Aufgabe, vor Merge oder Release	Prüft Diffs gegen Projektvorgaben, verifiziert Ergebnisse und übernimmt freigegebene Release- und Maintainer-Aufgaben.
/hunt	Bugs und Regressionen	Systematisches Debugging: Ursache klären, bevor Code geändert wird, besonders wenn etwas vorher funktioniert hat.
/write	Texte schreiben oder feilen	Formuliert chinesische und englische Texte natürlich um, entfernt hölzernen KI-Ton.
/learn	Unbekannte Themen erforschen	Recherche in sechs Phasen: sammeln, verdichten, gliedern, ausarbeiten, überarbeiten, dann selbst prüfen und veröffentlichen.
/read	Webseiten oder PDFs lesen	Erstellt prägnante Zusammenfassungen oder sauberes Markdown für Zitate und Notizen.
/health	Agenten-Konfiguration prüfen	Prüft Codex, Claude Code, Projektanweisungen, Verifier-Ausgaben und KI-Wartbarkeit, zuerst als ressourcenschonende Übersicht, dann im Detail.

Installation

Claude Code, Codex, Cursor und andere Agenten

npx skills add tw93/Waza -a claude-code codex cursor -g -y

Skills landen zentral in ~/.agents/skills. Claude Code bindet sie per Symlink ein; Codex, Cursor, Gemini CLI, Copilot, Amp, Kimi Code CLI und alle Agenten, die dieses Verzeichnis nutzen, laden die 8 Skills automatisch. Agenten mit eigenem Skill-Verzeichnis gibst du nach -a mit ihrer ID an (zum Beispiel antigravity-cli oder qwen-code). Aktualisierung über npx skills update -g -y. Du kannst deinen Agenten auch direkt mit der Installation beauftragen:

Lies https://github.com/tw93/Waza/blob/main/llms.txt und installiere Waza für mich

Host-Plugin-Methode (Skills erhalten ein Namespace-Präfix, z. B. /waza:check):

# Claude Code (Update: claude plugin update waza)
/plugin marketplace add tw93/Waza
/plugin install waza@waza

# Codex (Update: codex plugin marketplace upgrade waza, dann codex plugin add waza@waza)
codex plugin marketplace add tw93/Waza
codex plugin add waza@waza

Claude Desktop: Lade waza.zip herunter, öffne Customize > Skills > "+" > Create skill und lade die ZIP-Datei hoch. Zum Aktualisieren klickst du auf der Skill-Karte auf "...", wählst Replace und lädst die neueste ZIP-Datei hoch.

Pi: pi install npm:@tw93/waza, Update über pi update npm:@tw93/waza.

Skill-Kombinationen

Du entscheidest, wie Skills kombiniert werden. Jeder Skill stoppt nach Erreichen des Zielergebnisses; ausdrücklich freigegebene Workflows laufen weiter, ohne dass du jeden Übergang einzeln bestätigen musst.

Typische Workflows:

• Neues Feature: /think prüft den Plan, nach Freigabe implementieren, dann mit /check prüfen und mergen
• Bugfix: /hunt findet die Ursache, dann beheben, dann mit /check die Diffs prüfen und bei Bedarf releasen
• Recherche: /read holt das Material, /learn strukturiert es, /write formuliert aus

Welche Regeln in welcher Phase gelten, von der Idee bis zur Retro, steht in den AI-Coding-Regeln.

Projekt-Kontext

Waza liefert universelle Entwicklergewohnheiten. /check liest zur Laufzeit nur öffentliche Projektdateien (README, Paketdefinitionen, Makefile, CI-Workflows) und deine Vorgaben, niemals private Pfade, Zugangsdaten oder Tokens. Die Vorlage für den Review-Kontext findest du in skills/check/references/project-context.md.

Extras

Die curl-URLs verwenden das neueste GitHub-Release-Asset. Für die neuesten Skripte von main setzt du WAZA_REF=main vor den Befehl.

Statusleiste

Minimale Statusleiste für Claude Code: Kontext-Window, 5-Stunden- und 7-Tage-Kontingente farbcodiert, ohne Fortschrittsbalken und ohne Ablenkung.

(
  set -e
  WAZA_STATUSLINE_SCRIPT="$(mktemp -t waza-statusline.XXXXXX)"
  trap 'rm -f "$WAZA_STATUSLINE_SCRIPT"' EXIT
  curl -fL https://github.com/tw93/Waza/releases/latest/download/setup-statusline.sh -o "$WAZA_STATUSLINE_SCRIPT"
  # vorher prüfen: less "$WAZA_STATUSLINE_SCRIPT"
  bash "$WAZA_STATUSLINE_SCRIPT"
)

Codex-Statuszeile in ~/.codex/config.toml:

[tui]
status_line = ["model-with-reasoning", "current-dir", "context-used", "five-hour-limit", "weekly-limit"]
status_line_use_colors = true

Codex zeigt das verbleibende Kontingent, die Claude-Code-Statusleiste oben den verbrauchten Anteil (upstream gibt es five-hour-used / weekly-used noch nicht).

Optionale Regeln

Optionale Regeln wirken auch außerhalb von Skill-Aufrufen, sobald sie in den dauerhaften Anweisungen deines Agenten installiert sind. Die Installation der Waza-Skills allein aktiviert sie nicht. Kopiere die gewünschten Befehle (bei Codex oder Antigravity ersetzt du claude-code durch codex bzw. antigravity-cli):

(
  set -e
  WAZA_RULE_SCRIPT="$(mktemp -t waza-rule.XXXXXX)"
  trap 'rm -f "$WAZA_RULE_SCRIPT"' EXIT
  curl -fL https://github.com/tw93/Waza/releases/latest/download/setup-rule.sh -o "$WAZA_RULE_SCRIPT"
  # vorher prüfen: less "$WAZA_RULE_SCRIPT"

  # Englisch-Coaching: hängt eine kurze 😇-Korrektur an, wenn dein Prompt einen Englischfehler enthält
  bash "$WAZA_RULE_SCRIPT" english claude-code

  # Anti-Patterns: stets aktive, skillübergreifende Leitplanken (erst lesen, dann handeln; kein Scope Creep; keine ungefragten Zusammenfassungen)
  bash "$WAZA_RULE_SCRIPT" anti-patterns claude-code

  # Routing-Hinweis: weist Nicht-Claude-Hosts an, Waza-Skills zu bevorzugen, wenn eine Anfrage zu ihren Triggern passt
  bash "$WAZA_RULE_SCRIPT" waza-routing claude-code

  # Klare Alltagsantworten: einheitliche Begriffe, explizite Bedingungen, Unsicherheit bleibt erhalten
  bash "$WAZA_RULE_SCRIPT" clarity claude-code
)

Clarity übernimmt Prinzipien für klares Schreiben aus ASD-STE100, ohne die Grammatik von kontrolliertem Englisch vorzuschreiben oder deinen Stil zu ändern. Führe den Befehl erneut aus, um die installierte Regel zu aktualisieren, und starte danach eine neue Sitzung. Codex installiert einen markierten Block in ~/.codex/AGENTS.md; Claude Code und Antigravity installieren eine Regeldatei. Bei anderen Tools kopierst du die Regel in deren dauerhafte benutzerdefinierte Anweisungen.

Warum Waza

Waza (技, わざ) bezeichnet in den Kampfkünsten eine Technik, die durch ständiges Üben zur instinktiven Gewohnheit wird. Gute Entwickler schreiben nicht nur Code. Sie hinterfragen Anforderungen, debuggen bis zur Ursache, prüfen ihre eigenen Diffs und lesen Primärquellen. KI kann all das leisten, driftet ohne Struktur aber ins Beliebige und Ungenaue ab. Jeder Waza-Skill legt das Ziel, die roten Linien und die Art der Überprüfung fest und überlässt den Lösungsweg dem Modell. Je besser die Modelle werden, desto mehr zahlt sich diese Zurückhaltung aus.

Tools wie Superpowers und gstack sind mächtig, aber schwer: zu viele Skills, zu viel Konfiguration. Waza bleibt klein, acht Skills für die Gewohnheiten, die wirklich zählen, jeder mit einer Aufgabe und einem klaren Auslöser. Waza ist aus echten Projekten entstanden und in über 300 Sitzungen über 7 Projekte hinweg verfeinert worden, jeder Fallstrick geht auf einen echten Fehlschlag zurück. Der /health-Skill ist aus dem sechsschichtigen Claude-Code-Framework aus diesem Beitrag entstanden.

Teil einer Trilogie: Kaku (書く) schreibt Code, Waza (技) trainiert Gewohnheiten, Kami (紙) liefert Dokumente. Als Familie gedacht ist Kaku der Vater, Waza die große Schwester und Kami die kleine Schwester.

Deinstallation

npx skills remove tw93/Waza -g
rm -f ~/.claude/statusline.sh
rm -f ~/.claude/rules/english.md
rm -f ~/.claude/rules/anti-patterns.md
rm -f ~/.claude/rules/waza-routing.md
rm -f ~/.claude/rules/clarity.md

Für die Statusleiste entfernst du außerdem den Eintrag statusLine aus ~/.claude/settings.json. In Claude Desktop löschst du Waza unter Customize > Skills. Bei Codex-Regelinstallationen entfernst du die markierten Waza-Blöcke aus ~/.codex/AGENTS.md. Bei Antigravity entfernst du die gewählte Regeldatei aus ~/.gemini/antigravity-cli/rules/. In anderen Tools entfernst du kopierte Regeln aus den benutzerdefinierten Anweisungen. Starte nach dem Entfernen einer Regel eine neue Sitzung.

Unterstützung

• Die direkteste Unterstützung ist der Kauf meiner Mac-Bereinigungs-App Mole for Mac
• Wenn dir Waza hilft, freue ich mich über einen Stern, eine Weiterempfehlung oder ein Issue bzw. einen PR, nachdem du SCOPE.md gelesen hast
• Du kannst auch meinen beiden Katzen TangYuan und Coke eine Dose Futter 🥩 spendieren

Diese lieben Menschen haben es schon getan 🐱

Lizenz

MIT License. Please feel free to use and contribute to the development.