skills/applied-cognitive-task-analysis-acta-met/SKILL.md
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.
npx skillsauth add curiositech/windags-skills applied-cognitive-task-analysis-acta-metInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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.
| Expert Response Type | Detection Signal | Next 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?" |
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?"
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
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.
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?"
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.
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.
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?"
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 Element | Why Difficult | Cues/Strategies | |------------------|---------------|-----------------| | Detecting compensated respiratory distress | Vitals appear normal due to physiological compensation | Forward-leaning posture, pursed lips, skin color changes, accessory muscle use | | Recognizing atypical cardiac presentations | Standard symptom descriptions don't match textbook | Male minimization patterns, "heartburn" descriptions with diaphoresis, jaw/arm radiation |
Agent Capability Mapping:
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.
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 Element | Why Difficult | Cues/Strategies | |------------------|---------------|-----------------| | Detecting equipment degradation before sensor alerts | Requires learned baselines for normal operation patterns | Vibration frequency changes, sound pattern shifts, subtle performance variations | | Identifying containment failures through sensory cues | Chemical detection systems have lag time and blind spots | Odor tracing, airflow pattern assessment, correlation with environmental conditions |
Agent Capability Mapping:
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.
Cognitive Demands Table Completion:
Interview Quality Assessment:
Practical Usability Validation:
Do NOT use ACTA for:
Delegate instead to:
ACTA specifically addresses: Extracting cognitive expertise that enables superior pattern recognition, situation assessment, and adaptive problem-solving for training design and agent specification purposes.
data-ai
license: Apache-2.0 NOT for unrelated tasks outside this domain.
development
Use when designing caching strategies (cache-aside, write-through, write-behind), implementing distributed locks, building rate limiters, leaderboards, real-time streams (XADD/consumer groups), pub/sub, or tuning eviction policies. Triggers: thundering-herd on cache miss, dogpile on key expiry, Redlock vs SET-NX-PX choice, sliding-window rate limiter, hot-key on a single cluster slot, big-key blowup, MULTI/EXEC across slots, KEYS in production. NOT for Redis Cluster operations/admin (different domain), embedded KV (SQLite, leveldb), in-process LRU caches, or Memcached.
tools
Drawing the `'use client'` boundary correctly in React Server Components apps (Next.js App Router, RSC frameworks) — leaf-pushing, slot composition, serialization rules, and environment poisoning prevention. Grounded in react.dev and Next.js 16 docs.
development
Use when designing rate limiting for an API, choosing between token bucket / sliding window / leaky bucket / fixed window, implementing it in Redis, deciding edge (Cloudflare/Upstash) vs origin enforcement, sizing per-user vs per-IP vs per-endpoint quotas, returning the right 429 response with Retry-After, or fixing the boundary-burst bug in fixed-window limiters. Triggers: 429 too many requests, INCR + EXPIRE, ZADD + ZREMRANGEBYSCORE + ZCARD, X-RateLimit-Remaining header, Cloudflare WAF rate limiting rules, Upstash @upstash/ratelimit, leaky bucket shaping vs policing, distributed rate limiter consistency. NOT for DDoS mitigation specifically (different scale), CAPTCHA / bot management, full WAF design, or per-user quota billing.