skills/heuristics-and-checklists/SKILL.md
Provides practical frameworks for fast decision-making through mental shortcuts (heuristics) and systematic error prevention through structured checklists. Guides through designing effective heuristics, creating checklists for complex procedures, and recognizing when shortcuts lead to biases. Use when making decisions under time pressure or uncertainty, preventing errors in complex procedures, designing decision rules or checklists, simplifying complex choices, or when user mentions heuristics, rules of thumb, mental models, checklists, error prevention, cognitive biases, satisficing, or standard operating procedures.
npx skillsauth add lyndonkl/claude heuristics-and-checklistsInstall 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.
Copy this checklist and track your progress:
Heuristics & Checklists Progress:
- [ ] Step 1: Identify decision or procedure
- [ ] Step 2: Choose approach (heuristic vs. checklist)
- [ ] Step 3: Design heuristic or checklist
- [ ] Step 4: Test and validate
- [ ] Step 5: Apply and monitor
- [ ] Step 6: Refine based on outcomes
Step 1: Identify decision or procedure
What decision or procedure needs simplification? Is it repetitive? Time-sensitive? Error-prone? See resources/template.md.
Step 2: Choose approach (heuristic vs. checklist)
Heuristic for decisions (choose option). Checklist for procedures (sequence of steps). See resources/methodology.md.
Step 3: Design heuristic or checklist
Heuristic: Define simple rule (recognition, take-the-best, satisficing threshold). Checklist: List critical steps, add READ-DO or DO-CONFIRM format. See resources/template.md and resources/template.md.
Step 4: Test and validate
Pilot test with sample cases. Check: Does heuristic produce good enough decisions? Does checklist catch errors? See resources/methodology.md.
Step 5: Apply and monitor
Use in real scenarios. Track outcomes: decision quality, error rate, time saved. See resources/template.md.
Step 6: Refine based on outcomes
Adjust rules based on data. If heuristic fails in specific contexts, add exception. If checklist too long, prioritize critical items. See resources/methodology.md.
Validate using resources/evaluators/rubric_heuristics_and_checklists.json. Minimum standard: Average score ≥ 3.5.
Pattern 1: Recognition Heuristic
Pattern 2: Take-the-Best Heuristic
Pattern 3: Satisficing (Good Enough Threshold)
Pattern 4: Aviation Checklist (DO-CONFIRM)
Pattern 5: Surgical Checklist (READ-DO)
Pattern 6: Fast & Frugal Decision Tree
Key requirements:
Know when heuristics work vs. fail: Heuristics excel in stable, familiar environments with time pressure. They fail in novel, deceptive contexts (adversarial, misleading information). Don't use recognition heuristic when advertising creates false signals.
Satisficing ≠ low standards: "Good enough" threshold must be calibrated. Set based on cost of continued search vs. value of better option. Too low → poor decisions. Too high → analysis paralysis.
Checklists for critical steps only: Don't list every trivial action. Focus on steps that (1) are skipped often, (2) have serious consequences if missed, (3) not immediately obvious. Short checklists used > long checklists ignored.
READ-DO for novices, DO-CONFIRM for experts: Match format to user expertise. Forcing experts into READ-DO creates resistance and abandonment. Let experts flow, confirm after.
Test heuristics empirically: Don't assume rule works. Test on historical cases. Compare heuristic decisions to optimal decisions. If accuracy <80%, refine or abandon.
Bias awareness is not bias elimination: Knowing availability bias exists doesn't prevent it. Heuristics are unconscious. Need external checks (checklists, peer review, base rates) to counteract biases.
Update heuristics when environment changes: Rules optimized for past may fail in new context. Market shifts, technology changes, competitor strategies evolve. Re-validate quarterly.
Forcing functions beat reminders: "Don't forget X" fails. "Can't proceed until X done" works. Build constraints (e.g., deployment script requires all tests pass) rather than relying on memory.
Common pitfalls:
Common heuristics:
| Heuristic | Rule | Example | Best For | |-----------|------|---------|----------| | Recognition | Choose what you recognize | Detroit > Milwaukee (size) | Stable correlations between recognition and quality | | Take-the-best | Use single most important criterion | Hire based on track record alone | One dominant factor predicts outcome | | Satisficing | First option meeting threshold | Candidate meets 80% requirements → hire | Time pressure, search costs high | | Availability | Judge frequency by ease of recall | Plane crashes seem common (vivid) | Recent, vivid events (WARNING: bias) | | Representativeness | Judge by similarity to prototype | "Looks like successful startup founder" | Stereotypes exist (WARNING: bias) | | Anchoring | Adjust from initial value | First price shapes negotiation | Numerical estimates (WARNING: bias) |
Checklist formats:
| Format | When to Use | Process | Example | |--------|-------------|---------|---------| | READ-DO | Novices, unfamiliar, high-stakes | Read step → Do step → Repeat | Surgery (WHO checklist) | | DO-CONFIRM | Experts, routine, familiar | Do from memory → Confirm with checklist | Aviation pre-flight | | Challenge-Response | Two-person verification | One reads, other confirms | Nuclear launch procedures |
Checklist design principles:
When to use heuristics vs. checklists:
| Decision Type | Use Heuristic | Use Checklist | |---------------|---------------|---------------| | Choose between options | ✓ Recognition, take-the-best, satisficing | ✗ Not applicable | | Sequential procedure | ✗ Not applicable | ✓ Pre-flight, deployment, surgery | | Complex multi-step | ✗ Too simplified | ✓ Ensures nothing skipped | | Routine decision | ✓ Fast rule (satisficing) | ✗ Overkill | | Error-prone procedure | ✗ Doesn't prevent errors | ✓ Catches mistakes |
Cognitive biases (when heuristics fail):
| Bias | Heuristic | Failure Mode | Mitigation | |------|-----------|--------------|------------| | Availability | Recent/vivid events judged as frequent | Overestimate plane crashes (vivid), underestimate heart disease | Use base rates, statistical data | | Representativeness | Judge by stereotype similarity | "Looks like successful founder" ignores base rate of success | Check against actual base rates | | Anchoring | First number shapes estimate | Initial salary offer anchors negotiation | Set own anchor first, adjust deliberately | | Confirmation | Seek supporting evidence | Only notice confirming data | Actively seek disconfirming evidence | | Sunk cost | Continue due to past investment | "Already spent $100k, can't stop now" | Evaluate based on future value only |
Inputs required:
Outputs produced:
heuristic-rule.md: Defined heuristic with conditions and exceptionschecklist.md: Structured checklist with critical stepsvalidation-results.md: Test results on historical casesrefinement-log.md: Iterations based on real-world performancetesting
Cluster a conference's event records into a small set of coarse themes with finer sub-clusters, an explicit outlier bucket, and soft (multi-membership) affinities — using the hybrid embed-then-label pipeline (embed abstracts, reduce, density-cluster, then LLM-label the clusters) when embedding libraries are available, and an LLM-reasoned hierarchical fallback when they are not. Embeddings do the grouping; the LLM only names the groups. Conference-agnostic. Use when turning structured event records into a navigable theme map for preference elicitation and scheduling, when you need 6-8 reasonable themes rather than 20 muddy ones, or when overlapping talks must belong to more than one theme. Trigger keywords - theme clustering, cluster talks, embed then label, soft membership, outlier talks, conference themes, topic map.
development
Build a personal conference schedule as a constraint-optimization problem — hard constraints (no time overlap, room-to-room travel time, capacity/registration, the attendee's own must-attends and blackouts) plus a user-owned weighted objective trading interest against breadth, pacing (maximize contiguous free time), and serendipity. Surfaces unbreakable conflicts (two high-value overlapping talks the model cannot rank) as decisions for the human rather than silently picking, and reports what each choice traded away. Conference-agnostic. Use to turn a preference profile plus a theme map into a day-by-day plan, to resolve overlapping sessions, or to balance a packed vs paced schedule. Trigger keywords - schedule optimization, conference schedule, constraint optimization, overlapping talks, contiguous free time, conflict surfacing, packed vs paced.
development
Parse a heterogeneous conference program (markdown, HTML, PDF-derived text, or JSON) into normalized event records with per-field confidence scores and independent classification axes (topic, depth, format, prerequisites, recorded, capacity). Detects the program's format before extracting, treats every inferred field as uncertain (present vs inferred vs missing), and flags thin or missing abstracts so downstream enrichment can target them. Conference-agnostic. Use when ingesting a conference or event schedule into a structured store, normalizing a talk/session list, or extracting per-session metadata with calibrated confidence. Trigger keywords - program ingestion, parse schedule, session extraction, event records, conference program, talk metadata, per-field confidence.
development
Build a personalized preference profile from a small number of well-chosen, cluster-grounded questions instead of a long survey. Represents the person's interests as an uncertainty region over the theme map, picks the single highest-information-gain choice-based question (contrasting real talks from different clusters), balances exploiting known interests against exploring uncertain ones, deliberately injects outlier probes to fight selection bias, and stops as soon as the schedule would be stable. Also elicits the user-owned objective weights and hard constraints. Interactive — runs where it can actually ask the person. Conference-agnostic. Use to turn a theme map into a preference profile, to decide what to ask a conference attendee, or to elicit scheduling priorities. Trigger keywords - preference elicitation, ask few questions, information gain, choice-based questions, selection bias probe, objective weights, attendee preferences.