Communitygithub.com

curiositech/windags-skills

Diseña agentes BDI al estilo AgentSpeak(L) con planes protegidos por contexto, funciones de selección y pilas de intenciones. Útil para autonomía interrumpible, políticas de agente y orquestación multi-agente en entornos dinámicos. NO para motores de reglas simples, planificadores estáticos o flujos de trabajo centralizados.

¿Qué es windags-skills?

Esta habilidad proporciona una arquitectura completa para diseñar agentes autónomos basados en el modelo BDI (Beliefs-Desires-Intentions) siguiendo el formalismo AgentSpeak(L). Está especialmente diseñada para sistemas que necesitan equilibrar la reactividad a eventos cambiantes con el compromiso de tareas de larga duración. Separa explícitamente las creencias (lo que el agente sabe del mundo), los deseos (resultados candidatos) y las intenciones (planes activos a los que se ha comprometido), permitiendo una toma de decisiones transparente y auditable. Las funciones de selección (evento, opción e intención) centralizan la política del agente, como urgencia o prioridad, mientras que los planes encapsulan el conocimiento del dominio con guardas de contexto. Es ideal para entornos multi-agente, asistentes de codificación con capacidad de interrupción, o sistemas de coordinación logística sin un despachador central. La habilidad incluye diagramas de decisión, modos de fallo típicos con sus soluciones, ejemplos prácticos y puertas de calidad para validar el diseño. Está pensada para plataformas como Claude Code, Cursor o Codex donde se necesite un modelo mental inspeccionable y políticas de agente flexibles.

Compatible con✓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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Arquitectura BDI al estilo AgentSpeak(L)

Usa esta habilidad cuando la parte difícil no sea escribir otro flujo de trabajo, sino decidir cómo un agente autónomo debe reaccionar, comprometerse, suspender el trabajo y explicar sus elecciones en condiciones cambiantes.

Cuándo Usarla

  • Un sistema debe reaccionar a nuevos eventos sin abandonar compromisos de larga duración.
  • Necesitas una biblioteca de planes con comportamientos reutilizables seleccionados por el contexto actual, en lugar de un controlador monolítico.
  • La política del agente debe mantenerse separada del conocimiento del dominio para que la urgencia, la equidad o la tolerancia al riesgo puedan cambiar sin reescribir planes.
  • Los fallos deben desencadenar comportamientos de recuperación y replanificación en lugar de colapsar todo el agente.
  • Necesitas un modelo mental inspeccionable para saber por qué un agente eligió una tarea o plan sobre otro.

NO para

  • Motores de reglas simples donde no se necesitan compromisos persistentes ni pilas de intenciones.
  • Problemas de planificación estática donde el entorno no interrumpe la ejecución.
  • Sistemas de flujo de trabajo centralizados donde un solo planificador ya dicta cada paso.
  • Bucles de agente basados únicamente en indicaciones que nunca representan creencias, planes o políticas por separado.

Modelos Mentales Centrales

Creencias, Deseos e Intenciones Son Objetos Diferentes

Las creencias modelan el mundo actual, los deseos definen resultados candidatos y las intenciones son las pilas de planes comprometidas que actualmente consumen el presupuesto de ejecución. Si todo se colapsa en un solo elemento, el agente deja de ser interpretable.

Los Planes Son Conocimiento Situado

Los planes de AgentSpeak no son procedimientos genéricos. Son recetas activadas por eventos con guardas de contexto, de modo que el mismo objetivo puede invocar diferentes comportamientos dependiendo de lo que el agente crea actualmente.

Las Funciones de Selección Contienen la Política

El selector de eventos, el selector de opciones y el selector de intenciones son el lugar donde residen la urgencia, la equidad y la tolerancia al riesgo. Los planes deben codificar el saber hacer; las funciones de selección deben codificar la estrategia.

La Interrumpibilidad Es una Característica, No un Error

Las intenciones son pilas parcialmente ejecutadas que pueden ser intercaladas, suspendidas y reanudadas. Eso es lo que permite que los agentes receptivos manejen interrupciones sin tener que reiniciar cada tarea larga.

Formalizar desde el Sistema en Ejecución hacia Arriba

La lección práctica de AgentSpeak(L) es comenzar desde un ciclo de agente operativo y formalizar lo que realmente hace. No escribas una teoría abstracta elegante que luego deba ser aproximada al comportamiento en tiempo de ejecución.

Puntos de Decisión

flowchart TD
  A[¿Necesitas diseño de comportamiento autónomo?] --> B{¿Se requieren compromisos persistentes?}
  B -->|No| C[Usa reglas, máquinas de estado o un flujo de trabajo simple]
  B -->|Sí| D{¿El entorno interrumpe el trabajo activo?}
  D -->|No| E[Un planificador clásico puede ser suficiente]
  D -->|Sí| F{¿Necesitas política separada de los planes?}
  F -->|No| G[Bucle de agente personalizado, pero espera acoplamiento]
  F -->|Sí| H[Usa BDI al estilo AgentSpeak]
  H --> I{Problema actual}
  I -->|Tarea incorrecta elegida| J[Revisa SI o SE]
  I -->|Plan incorrecto elegido| K[Revisa SO o guardas de contexto]
  I -->|Fallo mata la ejecución| L[Añade eventos de fallo y planes de recuperación]
  I -->|Difícil de auditar| M[Expón la pila de intenciones y los rastros de selección]
  • Usa el modelado al estilo AgentSpeak cuando el sistema deba equilibrar la reactividad con el compromiso, en lugar de elegir uno.
  • Pon las suposiciones del mundo en consultas de creencias y guardas de plan, no como condicionales enterradas dentro de acciones.
  • Si la estrategia cambia pero el conocimiento del dominio no, cambia las funciones de selección antes de reescribir los planes.
  • Descompón las tareas largas en subobjetivos para que las pilas de intenciones sigan siendo inspeccionables e interrumpibles.

Modos de Fallo

Colapso Objetivo-Intención

Indicio: el diseño dice que el agente "tiene un objetivo" pero no puede mostrar si realmente ha comprometido recursos con él.

Solución: representa los objetivos candidatos por separado de las pilas de intenciones activas.

Política Oculta en los Planes

Indicio: cada cuerpo de plan contiene ramificaciones de prioridad, equidad o urgencia.

Solución: mueve esas decisiones a las funciones de selección de eventos, opciones o intenciones.

Planes Monolíticos

Indicio: los planes son tan largos que cualquier interrupción obliga a reiniciar mentalmente toda la secuencia.

Solución: divide los comportamientos largos en planes más cortos con límites explícitos de subobjetivos.

Fallo como Bloqueo, No como Evento

Indicio: un subobjetivo fallido aborta todo el agente o desaparece silenciosamente.

Solución: modela el fallo como un evento que puede desencadenar planes de recuperación, reintento o abandono.

Guardas de Contexto Sin Fundamentación

Indicio: los planes coinciden con suposiciones vagas del mundo que nunca están vinculadas a creencias u observaciones reales.

Solución: haz explícitas las rutas de actualización de creencias y mantén las guardas consultables contra el estado de creencias actual.

Ejemplos Prácticos

Agente LLM que Usa Herramientas con Interrupciones Urgentes

Un agente de codificación está trabajando en una refactorización larga cuando llega una alerta de producción de alta gravedad. Modela la refactorización como una pila de intenciones y la alerta como un nuevo evento. Deja que las funciones de selección adelanten la refactorización y luego la reanuden más tarde sin perder el estado.

Coordinación de Almacén Sin un Despachador Central

Varios agentes móviles comparten una base de creencias sobre la congestión de pasillos y el estado del inventario. Su conocimiento del dominio permanece en los planes, mientras que las funciones de selección codifican qué trabajos de recogida urgentes superan al trabajo de reposición en condiciones de congestión.

Puertas de Calidad

  • Las creencias, los deseos y las intenciones se representan por separado.
  • Cada evento desencadenante importante tiene al menos un plan con una guarda de contexto explícita.
  • El diseño nombra dónde reside la política de SE, SO y SI.
  • Las rutas de fallo crean eventos o planes de recuperación en lugar de un colapso silencioso.
  • Un revisor puede inspeccionar las intenciones activas y explicar por qué se seleccionó un plan sobre otro.

Shibboleths

  • Si alguien no puede explicar la diferencia entre un objetivo que el agente quiere y una intención a la que se ha comprometido, no ha internalizado el modelo.
  • Si la "estrategia" cambia y requiere reescribir cuerpos de planes, la política y el conocimiento nunca estuvieron separados.
  • Si el agente no puede decir qué lo interrumpió y qué reanudará a continuación, no está usando realmente pilas de intenciones.

Referencias para Consulta

  • references/bdi-architecture-for-agent-orchestration.md: cárgalo para el ciclo completo del agente y la interacción B/D/I.
  • references/context-sensitive-plans-as-agent-knowledge.md: cárgalo cuando la estructura del plan y el diseño de guardas sean el problema principal.
  • references/selection-functions-as-agent-policy.md: cárgalo cuando la prioridad, la equidad o la tolerancia al riesgo necesiten un tratamiento explícito de políticas.
  • references/intention-management-and-goal-decomposition.md: cárgalo cuando la suspensión/reanudación, los subobjetivos o la auditabilidad de intenciones sean centrales.
  • references/failure-modes-in-bdi-systems.md: cárgalo cuando el diseño actual ya exista y estés depurando fallos.

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.

Skills relacionados