Communitygithub.com

Análisis de Tareas Expertas y Diseño de Capacidades

Aplica análisis cognitivo de tareas al trabajo experto que depende de señales perceptivas, juicio ramificado y bucles de monitoreo recurrentes. Úselo al descomponer la capacidad experta en estructura de agente, diseño de simulación o entrevistas de validación. NO es para la captura ordinaria de procedimientos paso a paso o tuberías simples sin una capa tácita de señales.

¿Qué es Análisis de Tareas Expertas y Diseño de Capacidades?

Esta skill permite a desarrolladores de agentes de IA descomponer el conocimiento experto que depende de señales perceptivas y bucles de monitoreo recurrentes, más allá de simples procedimientos paso a paso. Es útil para diseñar arquitecturas de agentes, simuladores o entornos de entrenamiento que capturen la verdadera base del juicio experto. Soporta plataformas como Claude Code, Cursor y Codex, y se basa en métodos como el Análisis de Tareas Cognitivas (CTA) y el Método de Decisión Crítica (CDM) para extraer capas tácitas de conocimiento. Funciona mediante la identificación de puntos de ramificación y bucles de monitoreo, y validando modelos con múltiples expertos para evitar puntos ciegos.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/curiositech/windags-skills/tree/HEAD/skills/a-task-analysis-of-pier-side-ship-handli

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Análisis de Tareas Expertas y Diseño de Capacidades?

Use esta skill cuando un modelo de tarea parece completo desde el punto de vista procedimental pero aún así omite los desencadenantes perceptivos, los bucles de monitoreo y los hábitos de uso de herramientas que separan el rendimiento experto de una simple lista de verificación.

Cuándo Usarla

  • Necesita convertir el rendimiento experto en una arquitectura de agente, simulador o entorno de entrenamiento.
  • Un SOP escrito explica los pasos pero no cómo los expertos saben qué rama tomar.
  • El sistema funciona en casos normales y falla en casos límite que dependen del juicio situacional.
  • Está entrevistando a expertos en la materia y necesita un método para extraer conocimiento tácito en lugar de solo un procedimiento narrado.
  • Un DAG o árbol de orquestación necesita bucles de monitoreo recurrentes en lugar de solo nodos secuenciales únicos.

NO es para Límites

Esta skill no es la herramienta principal adecuada para:

  • Flujos de trabajo simples y deterministas donde los procedimientos explícitos ya capturan toda la tarea.
  • Automatización de bajo riesgo que no depende del reconocimiento de patrones perceptivos.
  • Ejercicios de documentación a posteriori que no necesitan validación contra el rendimiento experto real.
  • Simulaciones donde el realismo visual importa más que la fidelidad de las señales para la toma de decisiones.

Modelos Mentales Centrales

Capa de Ciencia vs. Capa de Arte

El rendimiento experto tiene una capa declarativa que los expertos generalmente pueden explicar y una capa perceptiva que a menudo solo aparece cuando se les presiona sobre los puntos de ramificación. GOMS captura la primera. Los Inventarios de Señales Críticas y las entrevistas del Método de Decisión Crítica son la forma de recuperar la segunda.

Las Señales Son Críticas

Patrones de estela, tensión de línea, un cambio de sonido o una relación posicional sutil no son detalles decorativos. Son las entradas reales para la elección del experto. Si el sistema no puede ver las señales, no puede reproducir la función de decisión del experto.

Jerarquía con Reglas de Selección

El trabajo experto es una jerarquía de objetivos anidados con condiciones de ramificación locales, no una lista plana de pasos. La estructura importante no es solo lo que se hace, sino qué condiciones seleccionan el método A en lugar del método B.

Bucles de Monitoreo Recurrentes

Muchas tareas expertas dependen de objetivos de evaluación continua que se ejecutan junto con la acción secuencial. Un flujo de trabajo que solo modela nodos únicos pierde la anticipación y convierte la experiencia en reacción.

Brecha de Validación

Los modelos de tareas de un solo experto son predeciblemente incompletos porque las herramientas rutinarias y los comportamientos de configuración desaparecen de la conciencia consciente. La validación no es un pulido opcional; es cómo la estructura de tarea faltante se vuelve visible.

Puntos de Decisión

Vea el flujo de modelado en diagrams/01_flowchart_decision-points.md.

flowchart TD
  A[Necesito modelo de capacidad experta] --> B[Descomponer objetivos y métodos]
  B --> C{Punto de ramificación explicado procedimentalmente?}
  C -->|Sí| D[Registrar regla de selección explícita]
  C -->|No| E[Indagar por señales perceptivas]
  D --> F{Se requiere monitoreo recurrente?}
  E --> F
  F -->|Sí| G[Modelar bucle de monitoreo y detección redundante]
  F -->|No| H[Mantener subobjetivo secuencial]
  G --> I[Validar con más expertos o trazas]
  H --> I

1. Decidir el Grano Correcto de Descomposición

  • Deténgase en el nivel donde aparece por primera vez una elección de método significativa.
  • Si una condición de ramificación aún está oculta, descomponga más profundamente e indague sobre la señal que selecciona la rama.
  • Si no quedan puntos de ramificación, ahora está documentando la ejecución en lugar de la arquitectura de la tarea.

2. Decidir Qué Método de Obtención de Conocimiento Usar

  • Use la descomposición estructurada para procedimientos explícitos y secuencias de herramientas.
  • Use las sondas del Método de Decisión Crítica cuando el experto diga "solo lo sé" o "depende".
  • Use la validación multi-experto siempre que el primer modelo parezca extrañamente limpio o sin herramientas.

3. Decidir Qué Simular

  • Simule las señales que realmente desencadenan las decisiones de ramificación.
  • Agregue detección redundante donde los expertos confían en más de un canal.
  • Omita el detalle cosmético que no cambia el reconocimiento de señales o la calidad de la elección.

Modos de Falla

1. Captura de Lista de Verificación Plana

Síntomas: el modelo de tarea se lee sin problemas pero falla tan pronto como el entorno se desvía.
Regla de detección: las condiciones de ramificación faltan o están ocultas dentro de la prosa en lugar de reglas de selección explícitas.
Recuperación: convierta la lista de verificación en una jerarquía de objetivos con puntos de ramificación vinculados a señales.

2. Simulación Sin Señales

Síntomas: los aprendices o agentes tienen éxito en el simulador pero fallan en el despliegue.
Regla de detección: la simulación reproduce procedimientos pero no las señales que los expertos usan para elegir entre ellos.
Recuperación: construya un Inventario de Señales Críticas y rediseñe el entorno en torno a la fidelidad de las señales.

3. Fragilidad de Canal Único

Síntomas: una entrada ruidosa o faltante colapsa todo el proceso de decisión.
Regla de detección: un juicio crítico depende de exactamente una fuente.
Recuperación: agregue canales redundantes y comportamiento explícito de verificación cruzada.

4. Punto Ciego de un Solo Experto

Síntomas: herramientas esenciales o acciones de configuración de contexto nunca aparecen en el primer modelo.
Regla de detección: los expertos de validación mencionan inmediatamente equipos, rutinas o comportamientos de monitoreo omitidos.
Recuperación: trate el desacuerdo como evidencia de estructura faltante, no como ruido.

5. Arquitectura Solo Secuencial

Síntomas: el sistema puede reaccionar a eventos pero no puede mantener una evaluación continua.
Regla de detección: todos los nodos son tareas únicas y ninguno representa objetivos de monitoreo recurrentes.
Recuperación: agregue bucles de monitoreo explícitos con comportamiento de predecir-observar-comparar-ajustar.

Ejemplos Practicados

Ejemplo 1: Convertir Juicio Experto en un Árbol de Agente

Un experto en el dominio del transporte marítimo da una narrativa procedimental para el atraque. El primer borrador se descompone limpiamente en pasos pero aún falla cuando la corriente, la disponibilidad de remolcadores y el comportamiento de las líneas cambian juntos. La skill agrega reglas de selección en los puntos de ramificación relevantes, registra el inventario de señales que impulsan esas elecciones e introduce bucles de monitoreo recurrentes en lugar de solo nodos secuenciales.

Ejemplo 2: Triaje de Fidelidad de Simulación

Un simulador de entrenamiento representa agua, embarcaciones y geometría de muelle de manera hermosa, pero los aprendices aún sobrepasan el punto de parada. El CTA revela que los expertos confían en el movimiento relativo contra referencias fijas en la costa y señales de tensión de línea que el simulador nunca enfatiza. La skill dirige el esfuerzo de diseño hacia esas señales en lugar de más pulido visual.

Puertas de Calidad

  • El modelo de tarea distingue el procedimiento explícito del conocimiento de señales perceptivas.
  • Los puntos de ramificación incluyen las señales o condiciones que seleccionan cada método.
  • Los objetivos de monitoreo recurrentes se modelan por separado de los objetivos secuenciales únicos.
  • Las decisiones críticas tienen canales de información redundantes donde los expertos confían en ellos.
  • Al menos una pasada de validación desafía el modelo con expertos o trazas adicionales.

Archivos de Referencia

ArchivoCargar cuando
references/goms-task-decomposition-for-agent-systems.mdConstruyendo una jerarquía de objetivos o decidiendo la profundidad de descomposición
references/critical-cue-inventories-for-agent-perception.mdRecuperando desencadenantes perceptivos en puntos de decisión
references/knowledge-elicitation-methodology-for-agent-capability-building.mdEjecutando entrevistas CTA o del Método de Decisión Crítica
references/validation-gap-what-experts-dont-know-they-know.mdProbando bajo estrés un modelo de tarea de primer borrador
references/redundant-sensing-in-multi-channel-environments.mdDiseñando percepción robusta multicanal
references/the-art-science-gap-transfer-to-simulation.mdDecidiendo qué detalle de simulación afecta materialmente la transferencia de habilidades
references/situation-awareness-and-the-conning-officers-mental-model.mdModelando bucles de monitoreo y detección de divergencias

Antipatrones

  • Tratar el "conocimiento tácito" como una etiqueta que termina la investigación en lugar de una señal para indagar más a fondo.
  • Capturar solo procedimientos y llamar al resultado un modelo experto.
  • Diseñar simulaciones para la estética del realismo en lugar de la fidelidad de las señales.
  • Asumir la completitud de un solo experto en un dominio donde la automaticidad oculta la estructura más importante.

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

>- 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

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

Skills relacionados