Communitygithub.com

curiositech/windags-skills

Systematic methodology for eliciting, representing, and operationalizing expert cognitive skills—pattern recognition, situation assessment, mental simulation—from practitioners without requiring research training. Bridges academic rigor and practical usability.

windags-skills とは?

windags-skills is a Claude Code agent skill that systematic methodology for eliciting, representing, and operationalizing expert cognitive skills—pattern recognition, situation assessment, mental simulation—from practitioners without requiring research training. Bridges academic rigor and practical usability.

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/curiositech/windags-skills/tree/HEAD/skills/applied-cognitive-task-analysis-acta-met

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

SKILL: Applied Cognitive Task Analysis (ACTA) Methodology

Name: ACTA — Extracting and Applying Expert Cognitive Knowledge Description: Systematic methodology for eliciting, representing, and operationalizing expert cognitive skills—pattern recognition, situation assessment, mental simulation—from practitioners without requiring research training. Bridges academic rigor and practical usability.

DECISION POINTS

Expert Response Pattern → Interview Pivot Strategy

Expert Response TypeDetection SignalNext Probe Action
Vague Generalization"You develop a feel for it" / "Experience teaches you"→ Incident Grounding: "Walk me through the last time you..."
Procedural Recitation"First I do X, then Y, then Z..."→ Cognitive Dimension Probe: "What tells you it's time for the next step?"
Abstract Principles"Always prioritize safety" / "Focus on the customer"→ Contrastive Example: "Show me two cases—one where that applies, one where it doesn't"
Contradicts Other Expert"Never do X" (when Expert 2 said "Always X")→ Conditional Exploration: "Under what circumstances is X appropriate?"
Describes Outcomes"Then the system works better" / "Quality improves"→ Cue Detection: "What do you notice that tells you it's working?"

Knowledge Audit Dimension Selection

IF expert mentions "seeing patterns" or "noticing things"
  THEN probe Perceptual Skills
    → "Show me two X's—one normal, one problematic. What differs?"

IF expert mentions "figuring out what happened" or "predicting outcomes"  
  THEN probe Mental Simulation
    → "What must have happened for..." / "If you did X, what would result?"

IF expert mentions "keeping track of multiple factors" or "big picture"
  THEN probe Situational Awareness
    → "What relationships do you monitor?" / "What trends matter?"

IF expert mentions "when standard procedures don't work"
  THEN probe Improvisation
    → "Tell me about a time the SOP failed" / "How do you adapt?"

IF expert mentions "knowing when you're wrong" or "second-guessing"
  THEN probe Metacognition
    → "How do you catch your own mistakes?" / "When do you seek help?"

Cognitive Demands Table Population Strategy

Difficult Element Identification:
  IF multiple experts struggle to articulate the same aspect
    THEN high cognitive demand
  IF novices consistently fail here despite training
    THEN expertise-dependent element
  IF standard procedures break down in this area
    THEN cognitive skill required

Why Difficult Analysis:
  IF novices miss perceptual cues → "Lacks pattern recognition for..."
  IF novices apply wrong strategy → "Cannot distinguish situation types..."  
  IF novices tunnel vision → "Focuses on single factor instead of..."
  IF novices freeze up → "No mental model for..."

Cues/Strategies Extraction:
  IF expert says "I just know" → probe for specific observable indicators
  IF expert gives multiple approaches → identify situational triggers
  IF expert mentions "experience" → extract pattern exemplars

FAILURE MODES

Rubber Stamp Elicitation

Detection: Expert interviews produce only procedural descriptions or textbook answers. No cognitive insights emerge. Symptoms: Transcripts read like SOPs. Experts say "just follow the process." No mention of judgment, adaptation, or situational factors. Root Cause: Abstract questioning triggers rationalized responses, not actual expert reasoning. Fix: Switch to incident-based probing. "Walk me through the last time you encountered..." Ground all questions in specific scenarios.

Single Expert Oracle

Detection: Design decisions based on one expert's approach treated as universal truth. Symptoms: "The expert says always do X" without conditional reasoning. No variation documented across experts. Root Cause: Treating individual expertise as domain expertise. Missing situational dependencies. Fix: Interview 3-5 experts. When approaches conflict, probe conditionals: "Under what circumstances would you do it differently?"

Transcript Worship

Detection: Raw interview notes treated as final deliverable. No transformation to actionable representation. Symptoms: Hours of interview audio with no structured output. Analysis stops at "we captured their knowledge." Root Cause: Confusing data collection with knowledge extraction. Fix: Force transformation through Cognitive Demands Table. Cannot complete without identifying difficult aspects, explaining why difficult, extracting cues/strategies.

Comprehensiveness Paralysis

Detection: Project stalled waiting for "complete" expertise capture before building anything. Symptoms: Endless additional interviews. "We need to understand everything first." No deployment timeline. Root Cause: Perfectionism prevents pragmatic deployment. Academic standards applied to practical problems. Fix: Extract sufficient expertise for initial capabilities. Deploy with monitoring and iteration cycles. 70% coverage enables valuable applications.

Proceduralization Fantasy

Detection: Attempts to convert expert judgment into decision trees or rule sets. Symptoms: Complex branching logic that doesn't capture actual expert reasoning. Rules that break in novel situations. Root Cause: Treating expertise as refined procedure rather than pattern recognition. Fix: Build pattern classification and situation assessment capabilities. Focus on "What kind of situation is this?" not "What's the prescribed action?"

WORKED EXAMPLES

Example 1: Emergency Nurse Triage

Context: Hospital needs to improve triage accuracy. Nurses with 2+ years experience significantly outperform new graduates in patient priority assignment.

Task Diagram Phase: Initial interview reveals standard triage procedure: vital signs → protocol lookup → priority assignment. But experts mention "something doesn't look right" decisions that novices miss.

Knowledge Audit Phase: Probe: "Show me two patients with similar vital signs—one you'd fast-track, one you wouldn't." Expert Response: "This one [points to case] has normal BP and pulse, but look at the skin color and how she's positioning herself. See how she's leaning forward? That's respiratory distress compensation." Follow-up: "What would a new nurse miss?" Expert Response: "They'd see normal vitals and send her to regular queue. They don't recognize the positioning pattern or skin color changes."

Simulation Interview: Present scenario: 45-year-old male, chest pain, normal vitals, says "feels like heartburn." Expert Response: "I'd ask about radiation to jaw or left arm. Also look at diaphoresis—sweating pattern. Men often minimize cardiac symptoms. Even with normal vitals, the description pattern raises MI risk."

Cognitive Demands Table Output:

Difficult ElementWhy DifficultCues/Strategies
Detecting compensated respiratory distressVitals appear normal due to physiological compensationForward-leaning posture, pursed lips, skin color changes, accessory muscle use
Recognizing atypical cardiac presentationsStandard symptom descriptions don't match textbookMale minimization patterns, "heartburn" descriptions with diaphoresis, jaw/arm radiation

Agent Capability Mapping:

  • Pattern recognition system trained on posture/positioning data
  • Skin color analysis in combination with vital trends
  • Natural language processing for symptom description patterns
  • Risk stratification that weights behavioral cues alongside physiological measures

Trade-off Analysis: Visual pattern recognition requires camera systems vs. privacy concerns. Behavioral cue detection needs training data vs. patient consent. Expert pattern recognition operates on multi-modal inputs that are technically challenging but clinically critical.

Example 2: Manufacturing Safety Inspection

Context: Chemical plant needs to improve pre-startup safety checks. Experienced inspectors catch hazards that procedural checklists miss.

Task Diagram Phase: Standard inspection covers 47 checklist items across systems. But senior inspectors mention "intuitive" hazard detection that prevents incidents.

Knowledge Audit Phase: Probe: "Walk me through the last time you found something not on the checklist." Expert Response: "Pump was running within specs, pressure normal, but the vibration pattern felt different. Not louder—different frequency. Turned out bearing was starting to fail. Would've gone catastrophic during the run." Follow-up: "How do you know normal vibration patterns?" Expert Response: "After 15 years, you feel how each pump runs. This one usually has a smooth hum. That day it had a slight roughness underneath."

Simulation Interview: Present scenario: All checklist items pass, but unusual smell in Unit 3. Expert Response: "I'd trace the smell. Chemical odors shouldn't penetrate the building envelope. Either we have a leak that isn't registering on sensors, or ventilation system failure. Both are serious even if readings look normal."

Cognitive Demands Table Output:

Difficult ElementWhy DifficultCues/Strategies
Detecting equipment degradation before sensor alertsRequires learned baselines for normal operation patternsVibration frequency changes, sound pattern shifts, subtle performance variations
Identifying containment failures through sensory cuesChemical detection systems have lag time and blind spotsOdor tracing, airflow pattern assessment, correlation with environmental conditions

Agent Capability Mapping:

  • Vibration analysis with learned baselines for each equipment piece
  • Chemical sensor networks with pattern recognition for anomalous readings
  • Environmental monitoring that correlates multiple sensory inputs
  • Predictive maintenance algorithms that weight subtle degradation indicators

Trade-off Analysis: Sensor density vs. cost considerations. Learned baselines require operational history vs. new equipment deployment. Human sensory integration (smell, vibration, sound) difficult to replicate technically but critical for early hazard detection.

QUALITY GATES

Cognitive Demands Table Completion:

  • Each "Difficult Element" appears in multiple expert interviews (not individual quirks)
  • "Why Difficult" explanations are observable/testable (not circular reasoning like "requires experience")
  • "Cues/Strategies" are specific enough for training design (not vague like "pattern recognition")
  • Expert consensus reached on major cognitive demands (3+ experts validate core elements)
  • Agent can classify novel scenarios using identified cues (testable discrimination)
  • Novice failure modes mapped to specific cognitive gaps (not just "lack of training")

Interview Quality Assessment:

  • Expert provided specific incidents, not just general principles
  • Cognitive dimensions probed systematically (perception, simulation, awareness, etc.)
  • Conflicting expert responses resolved through conditional exploration
  • Context-dependent reasoning captured (when to use different strategies)
  • Tacit knowledge made explicit through structured probes

Practical Usability Validation:

  • Non-experts can use table for training design without attending interviews
  • Agent specifications derivable from cue/strategy descriptions
  • Failure modes predictable from "why difficult" analysis
  • Knowledge portable across similar domains/applications

NOT-FOR BOUNDARIES

Do NOT use ACTA for:

  • Simple procedural tasks: If experts just follow procedures faster, use process improvement methods instead
  • Well-documented domains: If expertise is already captured in accessible form, focus on transfer/training optimization
  • Individual skill coaching: For developing one person's expertise, use mentoring or deliberate practice approaches
  • Academic research requirements: If you need publication-quality rigor, use full Cognitive Task Analysis methods
  • Real-time performance support: For in-the-moment assistance, use job aids or decision support systems

Delegate instead to:

  • Process mapping → for procedural optimization
  • Training design specialists → for curriculum development from ACTA outputs
  • Domain modeling → for comprehensive knowledge representation
  • Ethnographic methods → for cultural/organizational expertise factors
  • Psychometric assessment → for individual aptitude measurement

ACTA specifically addresses: Extracting cognitive expertise that enables superior pattern recognition, situation assessment, and adaptive problem-solving for training design and agent specification purposes.

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.

関連スキル