skills/cognitive-task-analysis/SKILL.md
Methodology for eliciting expert knowledge about cognitive processes, decisions, and mental models in complex tasks
npx skillsauth add curiositech/windags-skills cognitive-task-analysisInstall 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.
Expert knowledge elicitation methodology focused on capturing procedural knowledge, identifying automation gaps, and matching elicitation methods to knowledge architectures.
Is expert performance significantly better than agent performance on this task?
├─ YES: Automation gap likely
│ ├─ Agent has correct facts but wrong execution → Declarative/procedural mismatch
│ │ └─ Action: Use observational methods + process tracing
│ └─ Agent lacks pattern recognition skills → Missing classification procedures
│ └─ Action: Use think-aloud with expert cases + critical decision method
└─ NO: Knowledge completeness issue
├─ Agent fails on edge cases → Incomplete coverage
│ └─ Action: Expand expert pool + use multiple elicitation methods
└─ Agent inconsistent on similar cases → Representation format mismatch
└─ Action: Audit method-to-format coupling + redesign knowledge base
What type of knowledge does this task primarily require?
├─ Declarative ("knowing that" - facts, concepts, relationships)
│ └─ Use: Concept mapping, structured interviews, card sorting
├─ Procedural-Classification ("knowing which" - pattern recognition)
│ └─ Use: Think-aloud with cases, critical decision method, paired comparisons
└─ Procedural-Execution ("knowing how" - step sequences)
├─ Expert can explain steps → Use: Process tracing, task decomposition
└─ Expert cannot explain → Use: Observational shadowing + protocol analysis
How was this knowledge captured?
├─ Single method used → High risk of knowledge gaps
│ ├─ Interview/self-report only → Missing automated procedures
│ └─ Observation only → Missing conceptual frameworks
├─ Multiple methods used → Check method-knowledge type alignment
│ └─ Methods match knowledge types → Proceed to validation
└─ Unknown/undocumented → Assume incomplete capture
└─ Action: Re-elicit with method triangulation
Detection: Agent performs poorly on tasks experts handle effortlessly, despite having "complete" knowledge base built from expert interviews Root Cause: Automated expert knowledge is inaccessible to self-report; interview methods only capture conscious, declarative layer Fix: Add observational methods (shadowing, process tracing) and think-aloud protocols during actual task performance
Detection: Knowledge base structure suspiciously mirrors intended output format (e.g., all knowledge fits cleanly into IF-THEN rules) Root Cause: Output format drove method selection instead of knowledge type driving method selection Fix: Re-elicit using methods matched to knowledge architecture, then adapt representation format to captured knowledge
Detection: All domain knowledge captured using one elicitation technique; gaps appear in specific contexts Root Cause: Belief that one method can capture all knowledge types; ignores differential access hypothesis Fix: Map knowledge types required by task, select complementary methods for each type, triangulate results
Detection: Expert explanations are overly logical/linear; agent follows explanations but fails on expert-level cases Root Cause: Experts construct plausible post-hoc narratives rather than reporting actual cognitive process Fix: Use concurrent protocols (think-aloud during task) rather than retrospective explanations
Detection: Skill library grows continuously without consolidation; routing failures increase with library size Root Cause: Skills organized by surface features rather than knowledge architecture; lacks theoretical organizing principle Fix: Classify skills by knowledge type produced/consumed; consolidate using Hempel's reduction criterion
Scenario: Radiologist expert can spot lung nodules in chest X-rays with 95% accuracy in 3 seconds. AI agent trained on same images achieves 78% accuracy with 30-second processing.
Expert Interview Attempt:
Initial Implementation: Rule-based system checking density thresholds, shape parameters, systematic scanning pattern. Performance: 65% accuracy.
CTA Method Application:
Outcome: Redesigned agent with pattern recognition model trained on expert gaze data + semantic features. Performance: 91% accuracy.
What Novice Missed: Assumed expert's verbal explanation captured actual recognition process What Expert Caught: Distinguished between post-hoc explanation and real-time cognitive process
Scenario: Expert trader makes profitable split-second decisions on market volatility. Initial agent built from trading strategy documents performs poorly.
Document Analysis Approach: Extracted rules from strategy documents: "When VIX > 25 and S&P drops > 2%, buy volatility protection..."
Performance: 23% of trades profitable (random chance ≈ 30%)
CTA Method Application:
Key Discovery: Expert's profitable decisions came from recognizing subtle momentum patterns in real-time price action, not from following documented strategies.
Redesign: Hybrid system combining formal strategies (for position direction) with pattern recognition model (for timing and sizing).
Performance: 67% profitable trades.
Scenario: Expert human router assigns customer inquiries to specialist teams with 94% first-contact resolution. Automated system achieves 71%.
Initial Approach: Keyword matching based on inquiry categories expert provided in interview.
CTA Application:
Critical Insight: Expert performed multi-dimensional classification, not single-category assignment. Keyword approach captured only one dimension.
Implementation: Multi-factor routing algorithm weighing content classification, sentiment analysis, customer history clustering, and real-time team capacity.
Result: 89% first-contact resolution.
Do NOT use CTA for:
Delegate instead:
This skill is specifically for capturing expert cognitive processes that are:
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.