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:
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.