Communitygithub.com

curiositech/windags-skills

>- Apply cognitive task analysis to expert work that depends on perceptual cues, branching judgment, and recurring monitoring loops. Use when decomposing expert capability into agent structure, simulation design, or validation interviews. NOT for ordinary step-by-step SOP capture or simple pipelines with no tacit cue layer.

Qu'est-ce que windags-skills ?

windags-skills is a Claude Code agent skill that >- Apply cognitive task analysis to expert work that depends on perceptual cues, branching judgment, and recurring monitoring loops. Use when decomposing expert capability into agent structure, simulation design, or validation interviews. NOT for ordinary step-by-step SOP capture or simple pipelines with no tacit cue layer.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Expert Task Analysis And Capability Design

Use this skill when a task model seems procedurally complete but still misses the perceptual triggers, monitoring loops, and tool-use habits that separate expert performance from a checklist.

When to Use

  • You need to turn expert performance into an agent architecture, simulator, or training environment.
  • A written SOP explains the steps but not how experts know which branch to take.
  • The system works on normal cases and fails on edge cases that hinge on situational judgment.
  • You are interviewing subject-matter experts and need a method for extracting tacit knowledge rather than just narrated procedure.
  • A DAG or orchestration tree needs recurring monitoring loops instead of only one-shot sequential nodes.

NOT for Boundaries

This skill is not the right primary tool for:

  • Simple, deterministic workflows where explicit procedures already capture the whole task.
  • Low-stakes automation that does not depend on perceptual pattern recognition.
  • Post-hoc documentation exercises that do not need validation against real expert performance.
  • Simulations where visual realism matters more than cue fidelity for decision making.

Core Mental Models

Science Layer vs. Art Layer

Expert performance has a declarative layer that experts can usually explain and a perceptual layer that often shows up only when they are pushed on branch points. GOMS captures the former. Critical Cue Inventories and Critical Decision Method interviews are how you recover the latter.

Cues Are Load-Bearing

Wake patterns, line tension, a sound change, or a subtle positional relationship are not decorative details. They are the actual inputs to expert choice. If the system cannot see the cues, it cannot reproduce the expert decision function.

Hierarchy With Selection Rules

Expert work is a nested goal hierarchy with local branch conditions, not a flat list of steps. The important structure is not only what gets done, but what conditions select method A rather than method B.

Recurring Monitoring Loops

Many expert tasks depend on continual assessment goals that run alongside sequential action. A workflow that only models one-shot nodes loses anticipation and turns expertise into reaction.

Validation Gap

Single-expert task models are predictably incomplete because routine tools and setup behaviors vanish from conscious awareness. Validation is not an optional polish pass; it is how the missing task structure becomes visible.

Decision Points

See the modeling flow in diagrams/01_flowchart_decision-points.md.

flowchart TD
  A[Need expert capability model] --> B[Decompose goals and methods]
  B --> C{Branch point explained procedurally?}
  C -->|Yes| D[Record explicit selection rule]
  C -->|No| E[Probe for perceptual cues]
  D --> F{Recurring monitoring required?}
  E --> F
  F -->|Yes| G[Model monitoring loop and redundant sensing]
  F -->|No| H[Keep sequential subgoal]
  G --> I[Validate with more experts or traces]
  H --> I

1. Decide the Right Grain of Decomposition

  • Stop at the level where a meaningful method choice first appears.
  • If a branch condition is still hidden, decompose deeper and probe the cue that selects the branch.
  • If no branch points remain, you are now documenting execution rather than task architecture.

2. Decide What Knowledge-Elicitation Method to Use

  • Use structured decomposition for explicit procedures and tool sequencing.
  • Use Critical Decision Method probes when the expert says "I just know" or "it depends."
  • Use multi-expert validation whenever the first model seems strangely clean or tool-free.

3. Decide What to Simulate

  • Simulate cues that actually trigger branch decisions.
  • Add redundant sensing where experts rely on more than one channel.
  • Omit cosmetic detail that does not change cue recognition or choice quality.

Failure Modes

1. Flat Checklist Capture

Symptoms: the task model reads smoothly but fails as soon as the environment deviates.
Detection rule: branch conditions are missing or hidden inside prose instead of explicit selection rules.
Recovery: convert the checklist into a goal hierarchy with cue-linked branch points.

2. Cue-Free Simulation

Symptoms: trainees or agents succeed in the simulator but fail in deployment.
Detection rule: the simulation reproduces procedures but not the signals experts use to choose between them.
Recovery: build a Critical Cue Inventory and redesign the environment around cue fidelity.

3. Single-Channel Fragility

Symptoms: one noisy or missing input collapses the whole decision process.
Detection rule: a critical judgment depends on exactly one source.
Recovery: add redundant channels and explicit cross-check behavior.

4. One-Expert Blind Spot

Symptoms: essential tools or context-setting actions never appear in the first model.
Detection rule: validation experts immediately mention omitted equipment, routines, or monitoring behavior.
Recovery: treat disagreement as evidence of missing structure, not as noise.

5. Sequential-Only Architecture

Symptoms: the system can react to events but cannot sustain ongoing assessment.
Detection rule: all nodes are one-shot tasks and none represent recurring monitoring goals.
Recovery: add explicit monitoring loops with predict-observe-compare-adjust behavior.

Worked Examples

Example 1: Turning Expert Judgment Into an Agent Tree

A shipping-domain expert gives a procedural narrative for docking. The first draft decomposes cleanly into steps but still fails when current, tug availability, and line behavior shift together. The skill adds selection rules at the relevant branch points, records the cue inventory that drives those choices, and introduces recurring monitoring loops instead of only sequential nodes.

Example 2: Simulation Fidelity Triage

A training simulator renders water, vessels, and pier geometry beautifully, yet trainees still overrun the stop point. CTA reveals that experts rely on relative motion against fixed shore references and line-tension cues that the simulator never emphasizes. The skill routes design effort toward those cues instead of more visual polish.

Quality Gates

  • The task model distinguishes explicit procedure from perceptual cue knowledge.
  • Branch points include the cues or conditions that select each method.
  • Recurring monitoring goals are modeled separately from one-shot sequential goals.
  • Critical decisions have redundant information channels where experts rely on them.
  • At least one validation pass challenges the model with additional experts or traces.

Reference Files

FileLoad when
references/goms-task-decomposition-for-agent-systems.mdBuilding a goal hierarchy or deciding decomposition depth
references/critical-cue-inventories-for-agent-perception.mdRecovering perceptual triggers at decision points
references/knowledge-elicitation-methodology-for-agent-capability-building.mdRunning CTA or Critical Decision Method interviews
references/validation-gap-what-experts-dont-know-they-know.mdStress-testing a first-draft task model
references/redundant-sensing-in-multi-channel-environments.mdDesigning robust multi-channel perception
references/the-art-science-gap-transfer-to-simulation.mdDeciding what simulation detail materially affects skill transfer
references/situation-awareness-and-the-conning-officers-mental-model.mdModeling monitoring loops and divergence detection

Anti-Patterns

  • Treating "tacit knowledge" as a label that ends inquiry instead of a signal to probe harder.
  • Capturing only procedures and calling the result an expert model.
  • Designing simulations for realism aesthetics instead of cue fidelity.
  • Assuming single-expert completeness in a domain where automaticity hides the most important structure.

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 associés