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.
tools
Building resilient distributed systems with circuit breakers, retries with full-jitter exponential backoff, retry budgets (per-request 3-attempt + per-client 10% ratio per Google SRE), deadline propagation, and the cascading-failure math (4 layers × 3 retries = 64x amplification). Grounded in Resilience4j, Microsoft Cloud Patterns, AWS Architecture Blog (Marc Brooker), and Google SRE Book.
testing
Designing HTTP cache headers that work correctly across browsers, CDNs, and shared proxies — `Cache-Control` directives per RFC 9111, `stale-while-revalidate` and `stale-if-error` per RFC 5861, the Vary header for varying responses, and surrogate keys for tag-based purging. Grounded in IETF RFCs and Cloudflare/Fastly docs.
development
Use when designing or fixing a Content Security Policy on a real site, choosing between nonce-based and hash-based CSP, adding strict-dynamic, debugging "Refused to execute inline script" errors, deploying CSP in report-only mode first, configuring report-to / report-uri, or auditing an existing policy for unsafe-inline / unsafe-eval / wildcards. Triggers: "CSP blocks legitimate inline script", strict-dynamic, nonce-{RANDOM}, sha256-{HASH}, object-src none, base-uri none, frame-ancestors, Trusted Types, X-Content-Security-Policy obsolete, report-only vs enforced. NOT for general HTTP security headers (HSTS, COOP/COEP), Trusted Types deep dive, CORS configuration, or building a WAF.
tools
Choosing and operating an HTTP API versioning strategy that doesn't break clients — Stripe's date-based pinned versions, the Deprecation/Sunset header pair (RFC 9745 + RFC 8594), URI vs header vs media-type approaches, and the version-transformer pattern. Grounded in Stripe's published architecture and IETF RFCs.