Communitygithub.com

curiositech/windags-skills

Entwickle BDI-Agenten im AgentSpeak(L)-Stil mit kontextbewachten Plänen, Auswahlfunktionen und Intention-Stacks. Ideal für unterbrechbare Autonomie, Agenten-Policy und Multi-Agenten-Orchestrierung in dynamischen Umgebungen – nicht geeignet für einfache Regelwerke, statische Planer oder zentralisierte Workflows.

Was ist windags-skills?

Diese Skill bietet eine vollständige Architektur für die Entwicklung autonomer Agenten nach dem BDI-Modell (Beliefs-Desires-Intentions), inspiriert von der formalen Sprache AgentSpeak(L). Sie ermöglicht es Agenten, auf Ereignisse zu reagieren, langfristige Verpflichtungen einzuhalten und dabei strategische Entscheidungen über eine sauber getrennte Policy-Schicht zu treffen. Der Kern liegt in der expliziten Unterscheidung zwischen Überzeugungen (Was weiß der Agent?), Wünschen (Welche Ziele sind möglich?) und Intentionen (Worauf hat sich der Agent tatsächlich festgelegt?). Pläne werden als ereignisgesteuerte, kontextbewachte Rezepte modelliert, während Auswahlfunktionen (für Ereignisse, Optionen und Intentionen) die Strategie abbilden. Dies erlaubt Unterbrechbarkeit: Teilausgeführte Intention-Stacks können pausiert, verschoben und wieder aufgenommen werden. Die Skill unterstützt alle gängigen KI-Agenten-Frameworks wie Claude Code, Cursor, Codex, Copilot und ähnliche, indem sie eine referenzierbare, architektonische Blaupause liefert. Sie enthält detaillierte Entscheidungsbäume, Fehlermodi und Qualitätskriterien sowie praktische Beispiele für Tool-nutzende LLM-Agenten und Lagerkoordination ohne zentrale Steuerung. Sie ist besonders nützlich, wenn die Herausforderung nicht im Schreiben eines weiteren Workflows besteht, sondern darin zu entscheiden, wie ein autonomer Agent unter sich ändernden Bedingungen reagieren, sich festlegen, Arbeit aussetzen und seine Wahl erklären soll.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/curiositech/windags-skills/tree/HEAD/skills/agentspeak-l-bdi-agents-speak-out-in-a-logical-computable

In Ihrer bevorzugten KI fragen

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

Dokumentation

AgentSpeak(L) BDI-Architektur

Nutze diese Skill, wenn das Schwierige nicht darin besteht, einen weiteren Workflow zu schreiben, sondern zu entscheiden, wie ein autonomer Agent unter sich ändernden Bedingungen reagieren, sich festlegen, Arbeit aussetzen und seine Wahl erklären soll.

Wann verwenden

  • Ein System muss auf neue Ereignisse reagieren, ohne laufende, längerfristige Verpflichtungen aufzugeben.
  • Du brauchst eine Planbibliothek mit wiederverwendbaren Verhaltensweisen, die durch den aktuellen Kontext ausgewählt werden, anstatt einen monolithischen Controller zu verwenden.
  • Agenten-Policy muss vom Domänenwissen getrennt bleiben, damit Dringlichkeit, Fairness oder Risikotoleranz geändert werden können, ohne Pläne neu zu schreiben.
  • Fehler sollen Wiederherstellungsverhalten und Neuplanung auslösen, anstatt den gesamten Agenten zum Absturz zu bringen.
  • Du benötigst ein überprüfbares mentales Modell dafür, warum ein Agent eine bestimmte Aufgabe oder einen bestimmten Plan einem anderen vorgezogen hat.

Nicht geeignet für

  • Einfache Regelwerke, bei denen keine dauerhaften Verpflichtungen oder Intention-Stacks benötigt werden.
  • Statische Planungsprobleme, bei denen die Umgebung die Ausführung nicht unterbricht.
  • Zentralisierte Workflow-Systeme, bei denen ein einzelner Scheduler bereits jeden Schritt vorgibt.
  • Prompt-basierte Agenten-Schleifen, die Überzeugungen, Pläne oder Policy nie getrennt repräsentieren.

Kernkonzepte

Überzeugungen, Wünsche und Intentionen sind unterschiedliche Objekte

Überzeugungen modellieren die aktuelle Welt, Wünsche definieren mögliche Ergebnisse, und Intentionen sind die spezifischen festgelegten Plan-Stacks, die aktuell das Ausführungsbudget verbrauchen. Wenn diese in einem einzigen Klumpen zusammenfallen, hört der Agent auf, interpretierbar zu sein.

Pläne sind situiertes Wissen

AgentSpeak-Pläne sind keine generischen Prozeduren. Sie sind ereignisgesteuerte Rezepte mit Kontextwachen, sodass dasselbe Ziel unterschiedliche Verhaltensweisen aufrufen kann, je nachdem, was der Agent gerade glaubt.

Auswahlfunktionen beinhalten die Policy

Der Ereignis-Selektor, Options-Selektor und Intention-Selektor sind die Orte, an denen Dringlichkeit, Fairness und Risikotoleranz hingehören. Pläne sollten Know-how kodieren; Auswahlfunktionen sollten Strategie kodieren.

Unterbrechbarkeit ist ein Feature, kein Bug

Intentionen sind teilweise ausgeführte Stacks, die verschränkt, pausiert und fortgesetzt werden können. Genau das ermöglicht es reaktionsfähigen Agenten, Unterbrechungen zu behandeln, ohne jede lange Aufgabe in einen Neustart zu verwandeln.

Vom laufenden System aus formalisieren

Die praktische Lektion von AgentSpeak(L) ist, von einem operativen Agentenzyklus auszugehen und zu formalisieren, was er tatsächlich tut. Schreibe keine elegante abstrakte Theorie, die später approximativ in Laufzeitverhalten übersetzt werden muss.

Entscheidungspunkte

flowchart TD
  A[Benötige autonomes Verhaltensdesign] --> B{Dauerhafte Verpflichtungen erforderlich?}
  B -->|Nein| C[Nutze Regeln, Zustandsmaschinen oder einen einfachen Workflow]
  B -->|Ja| D{Unterbricht die Umgebung aktive Arbeit?}
  D -->|Nein| E[Klassischer Planer kann ausreichen]
  D -->|Ja| F{Policy von Plänen getrennt erforderlich?}
  F -->|Nein| G[Benutzerdefinierte Agentenschleife, aber Kopplung erwarten]
  F -->|Ja| H[Verwende AgentSpeak-artiges BDI]
  H --> I{Aktuelles Problem}
  I -->|Falsche Aufgabe gewählt| J[Überprüfe SI oder SE]
  I -->|Falscher Plan gewählt| K[Überprüfe SO oder Kontextwachen]
  I -->|Fehler tötet Ausführung| L[Füge Fehlerereignisse und Wiederherstellungspläne hinzu]
  I -->|Schwer zu auditieren| M[Lege Intention-Stack und Auswahlspuren offen]
  • Verwende das AgentSpeak-artige Modell, wenn das System Reaktionsfähigkeit mit Verpflichtung abwägen muss, anstatt sich für eines zu entscheiden.
  • Platziere Weltannahmen in Glaubensabfragen und Planwachen, nicht als Bedingungen, die tief in Aktionen vergraben sind.
  • Wenn sich die Strategie ändert, das Domänenwissen jedoch nicht, ändere Auswahlfunktionen, bevor du Pläne neu schreibst.
  • Zerlege lange Aufgaben in Unterziele, damit Intention-Stacks überprüfbar und unterbrechbar bleiben.

Fehlermodi

Ziel-Intention-Kollaps

Hinweis: Das Design sagt, der Agent „hat ein Ziel", kann aber nicht zeigen, ob er tatsächlich Ressourcen dafür gebunden hat.

Korrektur: Repräsentiere Kandidatenziele getrennt von aktuell aktiven Intention-Stacks.

Policy in Plänen versteckt

Hinweis: Jeder Plankörper enthält Verzweigungen für Priorität, Fairness oder Dringlichkeit.

Korrektur: Verschiebe diese Entscheidungen in Ereignis-, Options- oder Intention-Auswahlfunktionen.

Monolithische Pläne

Hinweis: Pläne sind so lang, dass jede Unterbrechung gedanklich einen Neustart der gesamten Sequenz erzwingt.

Korrektur: Teile lange Verhaltensweisen in kürzere Pläne mit expliziten Unterzielgrenzen auf.

Fehler als Absturz, nicht als Ereignis

Hinweis: Ein fehlgeschlagenes Unterziel bringt den gesamten Agenten zum Absturz oder verschwindet lautlos.

Korrektur: Modelliere Fehler als Ereignis, das Wiederherstellungs-, Wiederholungs- oder Abbruchpläne auslösen kann.

Unbegründete Kontextwachen

Hinweis: Pläne passen auf vage Weltannahmen, die nie an reale Überzeugungen oder Beobachtungen gebunden sind.

Korrektur: Mache Glaubensaktualisierungspfade explizit und halte Wachen gegen den aktuellen Glaubenszustand abfragbar.

Ausgearbeitete Beispiele

Tool-nutzender LLM-Agent mit dringenden Unterbrechungen

Ein Codierungsagent arbeitet an einem großen Refactoring, als eine hochkritische Produktionswarnung eintrifft. Modelliere das Refactoring als einen Intention-Stack und die Warnung als ein neues Ereignis. Lasse Auswahlfunktionen das Refactoring unterbrechen und später fortsetzen, ohne den Zustand zu verlieren.

Lagerkoordination ohne zentrale Steuerung

Mehrere mobile Agenten teilen eine Glaubensbasis über Gangstaus und Lagerbestand. Ihr Domänenwissen bleibt in Plänen, während Auswahlfunktionen kodieren, welche dringenden Kommissionieraufträge unter Staus Nachschubarbeit überstimmen.

Qualitätskriterien

  • Überzeugungen, Wünsche und Intentionen werden getrennt repräsentiert.
  • Jedes wesentliche auslösende Ereignis hat mindestens einen Plan mit einer expliziten Kontextwache.
  • Das Design benennt, wo die SE-, SO- und SI-Policy lebt.
  • Fehlerpfade erzeugen Ereignisse oder Wiederherstellungspläne statt lautlosem Zusammenbruch.
  • Ein Prüfer kann aktive Intentionen inspizieren und erklären, warum ein Plan einem anderen vorgezogen wurde.

Erkennungsmerkmale

  • Wenn jemand nicht erklären kann, was der Unterschied zwischen einem Ziel, das ein Agent möchte, und einer Intention, auf die er sich festgelegt hat, ist, dann hat er das Modell nicht verinnerlicht.
  • Wenn „Strategie"-Änderungen das Umschreiben von Plankörpern erfordern, waren Policy und Wissen nie getrennt.
  • Wenn der Agent nicht sagen kann, was ihn unterbrochen hat und was er als nächstes fortsetzen wird, verwendet er nicht wirklich Intention-Stacks.

Referenzweiterleitung

  • references/bdi-architecture-for-agent-orchestration.md: lade, um den vollständigen Agentenzyklus und das Zusammenspiel von B/D/I zu verstehen.
  • references/context-sensitive-plans-as-agent-knowledge.md: lade, wenn Planstruktur und Wachendesign das Hauptproblem sind.
  • references/selection-functions-as-agent-policy.md: lade, wenn Priorität, Fairness oder Risikotoleranz eine explizite Policy-Behandlung benötigen.
  • references/intention-management-and-goal-decomposition.md: lade, wenn Suspend/Resume, Unterziele oder Intention-Überprüfbarkeit im Mittelpunkt stehen.
  • references/failure-modes-in-bdi-systems.md: lade, wenn das aktuelle Design bereits existiert und du Zusammenbrüche debuggen musst.

Individual skills in this repo

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

curiositech/windags-skills

Expert in 2000s-era music visualization (Milkdrop, AVS, Geiss) and modern WebGL implementations. Specializes in Butterchurn integration, Web Audio API AnalyserNode FFT data, GLSL shaders for audio-reactive visuals, and psychedelic generative art. Activate on "Milkdrop", "music visualization", "WebGL visualizer", "Butterchurn", "audio reactive", "FFT visualization", "spectrum analyzer". NOT for simple bar charts/waveforms (use basic canvas), video editing, or non-audio visuals.

curiositech/windags-skills

Expert legal research agent for finding and scraping expungement data state by state. Knows authoritative sources, URL patterns, Firecrawl configuration, and 2026 legal landscape.

curiositech/windags-skills

Expert in 3D computer vision labeling tools, workflows, and AI-assisted annotation for LiDAR, point clouds, and sensor fusion. Covers SAM4D/Point-SAM, human-in-the-loop architectures, and vertical-specific training strategies. Activate on '3D labeling', 'point cloud annotation', 'LiDAR labeling', 'SAM 3D', 'SAM4D', 'sensor fusion annotation', '3D bounding box', 'semantic segmentation point cloud'. NOT for 2D image labeling (use clip-aware-embeddings), general ML training (use ml-engineer), video annotation without 3D (use computer-vision-pipeline), or VLM prompt engineering (use prompt-engineer).

curiositech/windags-skills

Implement WCAG 2.2 AA/AAA compliance with automated testing, keyboard navigation, screen reader support, and focus management. Activate on: accessibility audit, WCAG compliance, keyboard navigation, screen reader, aria attributes, axe-core, focus trap. NOT for: design-level accessibility review (use design-accessibility-auditor), color contrast only (use css-in-js-architect).

curiositech/windags-skills

Time-blind friendly planning, executive function support, and daily structure for ADHD brains. Specializes in realistic time estimation, dopamine-aware task design, and building systems that actually work for neurodivergent minds.

curiositech/windags-skills

Designs digital experiences for ADHD brains using neuroscience research and UX principles. Expert in reducing cognitive load, time blindness solutions, dopamine-driven engagement, and compassionate design patterns. Activate on 'ADHD design', 'cognitive load', 'accessibility', 'neurodivergent UX', 'time blindness', 'dopamine-driven', 'executive function'. NOT for general accessibility (WCAG only), neurotypical UX design, or simple UI styling without ADHD context.

curiositech/windags-skills

>- Apply crisis decision-making research to agent routing, uncertainty triage, and coordination failure analysis in time-pressured systems. Use when diagnosing handoff failures, analytical paralysis, or expert judgment under incomplete information. NOT for routine coding, simple CRUD design, or static single-agent tasks with complete information.

curiositech/windags-skills

Extend and modify the admin dashboard, developer portal, and operations console. Use when adding new admin tabs, metrics, monitoring features, or internal tools. Activates for dashboard development, analytics, user management, and internal tooling.

curiositech/windags-skills

Conversation patterns and interaction protocols for multi-agent systems. Covers request/response, pub/sub, blackboard, delegation chains, debate, critique, consensus, fan-out/fan-in, supervisor-worker, and peer negotiation. Deep analysis of AutoGen conversation patterns, CrewAI delegation, LangGraph state passing, and FIPA-ACL performatives. Teaches how to design what agents say to each other and in what order. Activate on: "agent conversation", "agent protocol", "multi-agent debate", "agent delegation", "supervisor worker pattern", "agent voting", "consensus protocol", "fan-out fan-in", "agent negotiation", "blackboard pattern", "agent dialogue", "conversation topology", "agent handoff". NOT for: wire format or serialization (use agent-interchange-formats), orchestration infrastructure (use agentic-infrastructure-2026), single agent behavior (use agentic-patterns).

curiositech/windags-skills

Meta-agent for creating new custom agents, skills, and MCP integrations. Expert in agent design, MCP development, skill architecture, and rapid prototyping. Activate on 'create agent', 'new skill', 'MCP server', 'custom tool', 'agent design'. NOT for using existing agents (invoke them directly), general coding (use language-specific skills), or infrastructure setup (use deployment-engineer).

curiositech/windags-skills

AI-powered calendar management and agent-based scheduling coordination. Covers calendar APIs (Google Calendar, CalDAV/iCal), AI scheduling assistants (Reclaim, Clockwise, Motion, Cal.com), building custom calendar agents with MCP, multi-calendar merging, timezone management, focus block protection, meeting fatigue detection, and agent-to-agent meeting negotiation protocols. Activate on: "calendar agent", "AI scheduling", "calendar coordination", "meeting scheduling", "calendar API", "focus time protection", "calendar optimization", "Google Calendar MCP", "Reclaim", "Clockwise", "Motion", "Cal.com", "smart scheduling", "calendar-aware agent", "timezone scheduling", "agent negotiation meetings". NOT for: manual calendar UI component design (use form-validation-architect), project management scheduling or Gantt charts (use project-management-guru-adhd), general time-tracking or pomodoro apps (use adhd-daily-planner for time-awareness), building the agent itself from scratch (use agent-creator).

curiositech/windags-skills

Build and adopt production AI agent infrastructure in 2026. Covers framework selection (LangGraph, CrewAI, AutoGen, MCP), orchestration patterns, evaluation, observability, memory systems, and tool use. Also covers the SOCIAL dimension: how to sell agent infrastructure internally, change management, measuring ROI, building trust in autonomous systems, and scaling adoption across teams. Activate on: "agent infrastructure", "agent framework comparison", "which agent framework", "sell AI tools internally", "agent adoption", "agent observability", "agent evaluation", "MCP architecture", "agentic mesh", "enterprise AI agents", "AI change management", "agent ROI". NOT for: building specific agents (use ai-engineer), designing agent behavior patterns (use agentic-patterns), prompt tuning (use prompt-engineer).

curiositech/windags-skills

Fundamental patterns for effective agentic behavior. Teaches decomposition, tool orchestration, error recovery, context management, quality self-assessment, and knowing when to stop. Model-agnostic principles that make any agent more effective regardless of domain. Activate on: "how should I structure this agent", "agentic workflow", "agent patterns", "multi-step task", "tool orchestration", "/agentic-patterns", "decompose this", "agent best practices", "chain of actions", "when should the agent stop", "agent loop design". NOT for: creating agent infrastructure (use agent-creator), building DAGs (use windags-architect), specific tool implementation.

curiositech/windags-skills

Automated discovery and matching of agent skills for dynamic task routing and capability assessment

curiositech/windags-skills

Cryptographic security for agentic systems — zero-trust agent networking, signed message envelopes (JWS/JWE), capability-based security (ocaps), Merkle tree audit trails, WASM sandboxing, and formal verification. Covers CLI dev tool security, mTLS between agents, permission boundaries (least privilege for AI agents), and supply chain security for skills/plugins. Activate on: "agent security", "zero trust agents", "secure agent communication", "capability-based security", "ocap", "signed messages between agents", "agent audit trail", "sandbox agent execution", "agent permissions", "mTLS agents", "cryptographic verification", "agent supply chain", "OWASP agentic", "prove agent did X", "tamper-proof agent logs". NOT for: application-level SAST scanning (use security-auditor), network firewall rules (use infrastructure), SOC2/HIPAA compliance (organizational), or prompt injection defense (use prompt-engineer).

curiositech/windags-skills

Data structures and serialization formats for agent-to-agent communication. Covers message envelopes, structured output schemas, capability declarations, task handoff payloads, error/retry signaling, and context windows as data structures. Deep comparison of A2A protocol, MCP, OpenAI function calling, and LangChain message types. Teaches when to use rigid schemas vs free-form with validation, typed vs untyped, streaming vs batch. Activate on: "agent message format", "agent communication schema", "agent-to-agent protocol", "A2A protocol", "MCP message format", "structured output for agents", "agent interop", "interchange format", "agent serialization", "task handoff format", "capability declaration". NOT for: what agents say to each other (use agent-conversation-protocols), orchestration topology (use multi-agent-coordination), building agent infrastructure (use agentic-infrastructure-2026).

curiositech/windags-skills

Logic-based agent programming language implementing BDI architecture for practical autonomous agent development

curiositech/windags-skills

Foundational concurrent computation model where actors communicate exclusively through asynchronous message passing

curiositech/windags-skills

Build production-ready LLM applications, advanced RAG systems, and intelligent agents. Implements vector search, multimodal AI, agent orchestration, and enterprise AI integrations. Use PROACTIVELY for LLM features, chatbots, AI agents, or AI-powered applications.

curiositech/windags-skills

license: Apache-2.0 NOT for unrelated tasks outside this domain.

Verwandte Skills