Communitygithub.com

curiositech/windags-skills

Descubrimiento y coincidencia automatizados de habilidades de agentes para el enrutamiento dinámico de tareas y la evaluación de capacidades.

¿Qué es windags-skills?

Esta habilidad se centra en el descubrimiento autónomo de habilidades para sistemas de IA, abordando el problema de huevo y gallina de aprender qué constituye el éxito mientras se aprende cómo lograrlo. Proporciona arquitecturas para separar la propuesta y validación de habilidades, con un árbol de decisiones para seleccionar entre arquitecturas de modelo único (rápido, para tareas predeterminadas) o de doble proceso (Sistema 1/Sistema 2, para descubrimiento abierto). Incluye estrategias de validación (evaluación rápida con LLM y lenta con VLM), descomposición de tareas de arriba hacia abajo y encadenamiento de habilidades de abajo hacia arriba. La habilidad también detalla modos de fallo comunes como la evaluación de sello de goma, la parálisis por explosión de primitivas y la contaminación de la biblioteca, junto con sus síntomas, detección y soluciones. Los ejemplos trabajados ilustran la apertura robótica de cajones, la preparación de café y la destilación de conocimiento ambiental mediante RAG, destacando cómo los expertos evitan trampas que los novicios pasan por alto. Está diseñada para plataformas como Claude Code, Cursor y Codex, y proporciona puertas de calidad para garantizar una implementación robusta.

Compatible con~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/curiositech/windags-skills/tree/HEAD/skills/agentic-skill-discovery

Preguntar en tu IA favorita

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

Documentación

Descubrimiento Autónomo de Habilidades (Agentic Skill Discovery)

Versión: 1.0
Dominio: Sistemas de Aprendizaje Autónomo, Arquitectura de IA, Aprendizaje por Refuerzo

Concepto Central

El descubrimiento autónomo de habilidades resuelve el problema del huevo y la gallina: aprender qué constituye el éxito mientras se aprende cómo lograrlo. El sistema debe ser tanto estudiante como maestro, creando dependencias circulares que requieren una separación arquitectónica de la propuesta y la validación.

Puntos de Decisión

Árbol de Decisión para la Selección de Arquitectura

Si la tarea tiene criterios de éxito verdaderos (p. ej., navegación, manipulación con objetivos claros)
→ Usar Arquitectura de Modelo Único con evaluación rápida del LLM
→ Costo: Bajo | Precisión: ~75% | Caso de uso: Tareas predeterminadas

Si la tarea requiere descubrimiento abierto de habilidades (p. ej., tareas creativas, exploración)
→ Usar Arquitectura de Doble Proceso (Sistema 1/Sistema 2)
→ Sistema 1: Evaluación rápida del LLM para bucles de entrenamiento
→ Sistema 2: Validación independiente con VLM para admisión en biblioteca
→ Costo: Alto | Precisión: ~76% | Caso de uso: Aprendizaje autónomo

Si se desea un comportamiento complejo de múltiples pasos
→ Descomposición de Misiones de Arriba hacia Abajo
→ Comenzar con una tarea compleja fallida → descomponer en subtareas → aprender requisitos previos faltantes
→ Tasa de éxito: 43.75% frente al 12.50% del encadenamiento de abajo hacia arriba

Si se construye una biblioteca de habilidades desde primitivas
→ Encadenamiento de Habilidades de Abajo hacia Arriba solo si las primitivas están bien alineadas con los objetivos finales
→ Riesgo: Explosión combinatoria y falta de "habilidades intermedias"
→ Alternativa: Cambiar a descomposición de arriba hacia abajo cuando la composición falla

Si el rendimiento se estanca con el enfoque actual
→ Verificar dependencias circulares (mismo modelo que propone y evalúa)
→ Si se detectan: Implementar separación arquitectónica
→ Si no se detectan: Agregar RAG con patrones de habilidades exitosas para destilación de conocimiento ambiental

Tabla de Decisión de Estrategia de Validación

EscenarioEvaluación Rápida (Sistema 1)Evaluación Lenta (Sistema 2)Regla de Admisión en Biblioteca
Bucles de entrenamientoFunciones de éxito generadas por LLMNingunaNo aplica
Validación de habilidadesEvaluación LLMVerificación VLMRequerir que ambas pasen
Riesgo de contaminación de bibliotecaAlta toleranciaTolerancia ceroAnulación del Sistema 2 requerida
Restricciones de costoOptimizar por velocidadOptimizar por precisiónAceptación de costos asimétrica

Modos de Falla

1. Evaluación de Sello de Goma

Síntomas: Altas tasas de éxito reportadas pero baja finalización de tareas, biblioteca creciendo rápidamente
Regla de Detección: Si el mismo modelo genera recompensas Y evalúa el éxito, hay dependencia circular
Causa Raíz: El LLM actuando como jugador y árbitro crea sesgo en la evaluación
Solución: Implementar separación arquitectónica con un validador independiente (p. ej., VLM para tareas visuales)

2. Parálisis por Explosión de Primitivas

Síntomas: Biblioteca grande de habilidades pero incapacidad para resolver tareas complejas, las habilidades no se componen efectivamente
Regla de Detección: Si el número de habilidades crece pero la tasa de éxito en tareas complejas se mantiene plana, hay un problema de "habilidades intermedias"
Causa Raíz: El encadenamiento de abajo hacia arriba no puede descubrir habilidades intermedias entre primitivas y objetivos complejos
Solución: Cambiar a descomposición de misiones de arriba hacia abajo desde comportamientos complejos deseados

3. Desperdicio de RAG sin Contexto

Síntomas: La recuperación de RAG ocurre pero no hay mejora en el rendimiento, tratando la recuperación como ejemplos genéricos
Regla de Detección: Si RAG no mejora el aprendizaje de restricciones (p. ej., comprensión física), es solo un prompting costoso
Causa Raíz: Falta el mecanismo de destilación de conocimiento ambiental
Solución: Estructurar la biblioteca de habilidades como un modelo progresivo de affordances ambientales, no solo como una colección de ejemplos

4. Cascada de Contaminación de Biblioteca

Síntomas: El rendimiento se degrada con el tiempo a medida que la biblioteca crece, los falsos positivos se acumulan
Regla de Detección: Si la admisión en biblioteca usa la misma evaluación que los bucles de entrenamiento, la contaminación se volverá en cascada
Causa Raíz: Las malas habilidades habilitan malas composiciones; los errores de la biblioteca se acumulan de manera diferente al ruido de entrenamiento
Solución: Usar validación independiente costosa para la admisión en biblioteca, evaluación barata solo para entrenamiento

5. Anulación Manual de la Granularidad

Síntomas: Las habilidades se sienten desconectadas de los límites semánticos naturales, niveles de abstracción forzados
Regla de Detección: Si especificar manualmente la granularidad de la habilidad contradice las propuestas del LLM, verificar la alineación del dominio
Causa Raíz: Los LLM codifican límites semánticos de tareas a partir de datos de entrenamiento
Solución: Dejar que el sistema proponga habilidades libremente, observar la granularidad descubierta, ajustar solo para necesidades específicas del dominio

Ejemplos Trabajados

Ejemplo 1: Apertura Robótica de Cajones con Validación de Doble Proceso

Escenario: Un agente debe aprender a abrir varios tipos de cajones sin criterios de éxito predefinidos.

Proceso del Sistema 1 (Rápido):

  1. El LLM genera una propuesta de habilidad: "agarrar_manija_cajón"
  2. El LLM crea una función de éxito: manija_cajón_agarrada = distancia_pinza < 0.02
  3. El entrenamiento de RL usa esta función durante 100 episodios
  4. El LLM evalúa: "¡Éxito! La pinza alcanza consistentemente la manija"
  5. Punto de decisión: ¿Admitir en biblioteca? NO - requiere Sistema 2

Proceso del Sistema 2 (Lento):

  1. El VLM analiza los fotogramas finales de video de los 10 mejores episodios
  2. Veredicto del VLM: "La pinza toca la manija pero no mantiene el agarre - los dedos no se cierran"
  3. Detección: Falso positivo del Sistema 1 detectado
  4. Acción: Rechazar admisión en biblioteca, refinar la función de éxito
  5. Iteración: Agregar requisito de presión de agarre a la función de éxito

Experto vs Principiante:

  • El principiante pasa por alto: Confía en la autoevaluación del LLM, admite una habilidad mal aprendida
  • El experto detecta: El mismo modelo no puede evaluar lo que propuso; necesita validación independiente

Resultado: La biblioteca mantiene una precisión del 76% frente al 46% sin el Sistema 2

Ejemplo 2: Descomposición de Misiones de Arriba hacia Abajo para Tareas de Múltiples Pasos

Escenario: "Preparar café" falla con el encadenamiento de abajo hacia arriba a pesar de tener primitivas como "agarrar_taza", "verter_líquido"

Análisis de Falla de Abajo hacia Arriba:

  • Habilidades disponibles: agarrar_taza, verter_líquido, mover_brazo, detectar_objeto
  • Intentos de composición: Se probaron las 16 cadenas posibles de 2 habilidades
  • Habilidades intermedias faltantes: "alinear_taza_con_pico", "detectar_nivel_líquido", "coordinar_vertido_bimanual"
  • Punto de decisión: El enfoque de abajo hacia arriba no puede descubrir estas - no son composiciones de primitivas

Descomposición de Arriba hacia Abajo:

  1. Tarea fallida: "preparar_café"
  2. Descomponer en: [calentar_agua] → [moler_granos] → [alinear_taza] → [verter_agua] → [agregar_granos]
  3. Análisis de brechas: "alinear_taza" falta en la biblioteca
  4. Aprendizaje bajo demanda: Aprender "alinear_taza" con estado inicial = estado final de "moler_granos"
  5. Encadenamiento: El estado de éxito de cada subtarea se convierte en la condición inicial de la siguiente tarea

Análisis de Compensaciones:

  • Abajo hacia arriba: 12.50% de tasa de éxito, explora combinaciones de habilidades innecesarias
  • Arriba hacia abajo: 43.75% de tasa de éxito, aprende solo los requisitos previos necesarios
  • Costo: Arriba hacia abajo requiere capacidad de descomposición de tareas, abajo hacia arriba requiere exploración exhaustiva

Cuándo Falla el Enfoque de Arriba hacia Abajo:

  • Si la descomposición de la tarea es incorrecta, aprende habilidades para subtareas incorrectas
  • Si los estados iniciales no se pueden establecer de manera confiable, el encadenamiento se rompe
  • Mitigación: Validar la descomposición antes del aprendizaje de habilidades, implementar verificación de configuración de estado

Ejemplo 3: Destilación de Conocimiento Ambiental con RAG

Escenario: Un agente debe aprender habilidades de manipulación en un nuevo entorno sin restricciones físicas explícitas

Sin RAG (25% de tasa de éxito):

  1. El LLM genera una recompensa: recompensa = distancia_al_objetivo
  2. El agente aprende a acercarse pero no considera los límites de colisión
  3. Falla: Sin conocimiento de que la pinza debe estar a 5 cm de la superficie antes de agarrar

Con RAG (46% de tasa de éxito):

  1. Recuperar éxito anterior: función de recompensa "alcanzar_cubo_A"
  2. Patrón detectado: Todos los alcances exitosos incluyen la restricción altura_pinza > 0.05
  3. El LLM incorpora: recompensa = distancia_al_objetivo si altura_pinza > 0.05 de lo contrario -10
  4. Conocimiento destilado: Affordance ambiental aprendida implícitamente

Experto vs Principiante:

  • El principiante pasa por alto: Trata RAG como provisión de ejemplos, no reconoce el aprendizaje de restricciones
  • El experto detecta: RAG permite la destilación de conocimiento ambiental a través del reconocimiento de patrones

Cuándo Falla RAG:

  • Si los patrones recuperados son de entornos diferentes, se aprenden restricciones incorrectas
  • Si los ejemplos exitosos son demasiado escasos, los patrones no son estadísticamente significativos
  • Mitigación: Filtrar la recuperación por similitud de entorno, requerir un tamaño de muestra mínimo para la extracción de patrones

Puertas de Calidad

  • La propuesta y la validación utilizan diferentes capacidades del modelo (p. ej., LLM propone, VLM valida)
  • Precisión de evaluación rápida >45% y precisión de evaluación lenta >75% medidas en un conjunto de prueba reservado
  • La admisión en biblioteca requiere validación independiente, no solo éxito en el bucle de entrenamiento
  • La descomposición de tareas complejas genera 3-7 subtareas significativas con un orden de dependencia claro
  • La recuperación RAG mejora el aprendizaje de restricciones en >15% sobre la línea base sin RAG
  • El análisis de granularidad de habilidades muestra agrupación semántica, no enumeración paramétrica
  • El sistema puede detectar y recuperarse de modos de falla de dependencia circular
  • Tasa de contaminación de biblioteca <25% verificada mediante evaluación independiente
  • La descomposición de arriba hacia abajo supera al encadenamiento de abajo hacia arriba por >2x en tareas complejas
  • La destilación de conocimiento ambiental demuestra aprendizaje de restricciones a partir de patrones de éxito

Límites de NO-APLICACIÓN

NO use esta habilidad para:

  • Tareas predeterminadas con criterios de éxito conocidos → Use RL estándar con recompensas diseñadas a mano en su lugar
  • Tareas de manipulación de un solo paso → Use aprendizaje supervisado con datos de demostración en su lugar
  • Tareas que requieren rendimiento en tiempo real → La validación de doble proceso es demasiado lenta; use una biblioteca de habilidades en caché en su lugar
  • Dominios sin retroalimentación visual → La validación con VLM no está disponible; diseñe validadores independientes específicos del dominio en su lugar
  • Entornos con recursos limitados → La validación del Sistema 2 es costosa; acepte menor precisión o use validación jerárquica

Delegue a estas habilidades en su lugar:

  • Ingeniería de recompensas estándar → Para tareas con métricas de éxito claras
  • Aprendizaje por imitación → Para tareas con datos de demostración abundantes
  • RL jerárquico → Para tareas con descomposición de habilidades conocida
  • Meta-aprendizaje → Para adaptación rápida a nuevas distribuciones de tareas
  • IA constitucional → Para tareas que requieren alineación de valores y restricciones de seguridad

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

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

>- Design AgentSpeak(L)-style BDI agents with context-guarded plans, selection functions, and intention stacks. Use for interruptible autonomy, agent policy, and multi-agent orchestration in dynamic environments. NOT for simple rule engines, static planners, or centralized workflows.

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