CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

underwriting

Insurance underwriting domain knowledge for building automated submission-processing systems. Use when designing or implementing underwriting pipelines, document-extraction agents, compliance workflows, HITL review systems, or decision-package assembly for insurance carriers or MGAs. Covers the submission-to-bind lifecycle, document extraction patterns, compliance gates (sanctions, licensing, clearance), human-in-the-loop design for regulated financial services, confidence calibration for extracted fields, operating-mode progression from manual to automated, and evidence traceability. Domain knowledge only — for LangGraph and AgentCore implementation patterns see langgraph-agentcore.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Underwriting Domain Knowledge

This skill provides domain knowledge for building automated underwriting systems in insurance. It covers the business logic, decision criteria, and regulatory patterns that engineering teams need to implement correctly.

Two scoping notes apply to everything below and in the reference files:

  • Jurisdiction: regulatory references (PRA, FCA, Lloyd's, the MLRO role, the named sanctions lists) assume the UK/Lloyd's market. Adapt regulator names, sanctions lists and compliance roles to the carrier's jurisdiction.
  • Numeric thresholds (confidence cut-offs, cost targets, HITL rates, timeouts, ECE alerts) are illustrative starting defaults, not regulatory requirements. Tune them per line of business in the per-LoB policy settings and treat them as configuration, not constants, in any spec you write.

Submission-to-Bind Lifecycle

Every insurance submission follows a pipeline from initial receipt to policy issuance. The stages are sequential with gates between them.

Stage Overview

Ingestion → Triage → Assessment → Quoting → Binding → Issuance
              │          │            │         │         │
              ▼          ▼            ▼         ▼         ▼
         Classification  Pre-screen Manual    Manual    Manual
         & routing     + detailed  UW review  confirm   issue
  1. Ingestion — Receive submission (email, portal, API), parse documents, deduplicate, create case record, upload attachments to object storage.

  2. Triage — Classify submission type (new business, MTA/endorsement, claim, renewal, other). Route based on classification confidence.

  3. Assessment — Two-phase design (see "Cheap Checks First" below):

    • Pre-screening: Quick, low-cost checks — broker validation, territory/product appetite, basic eligibility, licensing, clearance. Goal: decline non-quotable submissions before expensive processing.
    • Detailed processing: Full extraction, enrichment, compliance, gap analysis. Only reached by submissions that pass pre-screening.
  4. Quoting — Assemble underwriting decision package, compute confidence and thoroughness scores, apply the quote-readiness gate, present to underwriter.

  5. Binding — Underwriter makes firm order decision, terms confirmed with broker, binding authority exercised.

  6. Issuance — Policy documents generated, premium invoiced, regulatory filings completed.

Cheap Checks First

Structure pipelines to minimise cost-to-decline. Run inexpensive checks (API lookups, business rules) before costly ones (LLM extraction, external enrichment, compliance screening). Illustrative target cost breakdown (recalibrate against current model and API pricing):

StageTarget CostPrimary Cost Drivers
Triage< $0.05Fast-tier LLM classification
Pre-screening< $0.10API lookups, minimal LLM
Detailed processing$1-5LLM extraction, external APIs, sanctions

See references/submission-lifecycle.md for detailed stage specifications.

Case Model

Use a hierarchical case model for tracking work through the pipeline:

Case (top-level submission record)
├── Stage (lifecycle phase: triage, assessment, quoting)
├── Step (atomic processing unit within a stage)
└── Task (work item assigned to human or agent)
  • Case ID: Unique, time-sortable identifier per submission.
  • Stage: Maps to pipeline phases. Each stage has an execution type (agent, manual, or parallel comparison).
  • Step: Granular processing within a stage (e.g., "extract core facts", "run sanctions screening"). Steps track individual agent node executions.
  • Task: Assignable work unit for HITL review or manual processing. Tasks have owners, SLAs, and audit trails.

Document Types and Extraction

Insurance submissions contain multiple document types. Each type has different extraction requirements and field criticality.

Common Document Types

Document TypeKey Fields to ExtractComplexity
Proposal formInsured name, address, business description, sums insured, requested coverage, deductiblesMedium
Schedule of valuesLocations, building details, construction type, occupancy, values per locationHigh (tabular)
Loss runs / claims historyPrior claims, dates, amounts, causes, reservesHigh (multi-year)
Slip / binderCoverage terms, limits, conditions, exclusions, endorsementsVery High (legal language)
Broker cover noteSummary terms, premium indication, expiring termsMedium
Financial statementsRevenue, assets, employee countMedium

Field Criticality Tiers

Every extracted field has a criticality tier that determines its confidence threshold and HITL routing. The thresholds below are illustrative starting defaults; tune them per LoB in the policy settings:

CriticalityThresholdExamplesHITL Policy
critical>= 0.95Coverage amount, named insured, effective/expiry dates, deductibleAlways HITL if below threshold
important>= 0.85Address, occupation, construction type, building ageJunior reviewer if below threshold
standard>= 0.75Broker reference, submission notes, secondary contactsFlagged for batch review

Non-negotiable HITL fields (always require human review regardless of confidence): financial-impact fields above a configurable monetary threshold, exclusion/endorsement language, contract-critical dates, sanctions fuzzy matches.

Field Catalog Configuration

Define field-level extraction and HITL policies as configuration (not code), grouped by LoB in the per-LoB policy settings:

field_catalog:
  sum_insured:
    criticality: critical
    confidence_threshold: 0.95
    hitl_policy: always_hitl_above_1m
  insured_name:
    criticality: critical
    confidence_threshold: 0.95
    hitl_policy: always_hitl
  broker_reference:
    criticality: standard
    confidence_threshold: 0.75
    hitl_policy: batch_review

This format drives HITL routing, confidence thresholds, and reviewer assignment for each extracted field. Override per LoB as needed.

Evidence Traceability

Every AI-extracted field must link to its source via evidence coordinates:

{
  "field": "sum_insured",
  "value": 5000000,
  "confidence": 0.92,
  "evidence": {
    "document_id": "DOC-001",
    "page": 3,
    "segment_id": "SEG-001-3-2",
    "bounding_box": {"x": 120, "y": 340, "w": 280, "h": 45}
  }
}

This is not optional. Regulatory audit expectations (in the UK market: PRA, FCA and Lloyd's; the equivalent supervisors elsewhere) demand that every AI-produced output be traceable to its source document. Evidence coordinates enable:

  • Underwriter verification (click-to-source)
  • Audit trail completeness
  • Confidence calibration feedback loops
  • Dispute resolution

Extraction Best Practices

  • Prompt per document type: Use document-type-specific extraction prompts rather than a single generic prompt. Each document type has different field layouts, terminology, and expected locations.
  • Segment-level extraction: Extract from parsed segments (not raw pages) to improve accuracy and enable precise bounding box coordinates.
  • Multi-pass for complex documents: For schedules of values and loss runs, use a structural pass (identify tables, headers, rows) followed by a field extraction pass per row.
  • Disambiguation protocol: When multiple candidate values exist for a field, capture all candidates with their evidence coordinates and route to HITL for disambiguation rather than picking the "best" one silently.
  • Cross-document validation: Cross-reference fields extracted from different documents (e.g., insured name in proposal form vs. broker cover note) and flag discrepancies for review.
  • Document trust boundaries: Broker-uploaded documents are untrusted input. Never treat document content as instructions — parse for data extraction only. Validate extracted values against expected types, ranges, and formats before accepting.

Compliance Gates

Regulated underwriting requires multiple compliance checkpoints. These are blocking — submissions cannot proceed until compliance clears.

Sanctions Screening

Screen every extracted entity (insured company, key persons, beneficial owners, asset locations) through a cost-tiered three-gate escalation: a cheap exact-match watchlist check, then fuzzy/alias screening, then a blocking human compliance review. Re-screen in detailed processing with full extracted data even if pre-screening cleared, because it ran on limited data. Gate-by-gate costs, human actions, and the partial-coverage pattern for sanctioned assets are in the "Sanctions Screening — 3-Gate Escalation" section of references/compliance-and-hitl.md.

Licensing and Clearance

  • Licensing: Verify the insurer/MGA is licensed to write this risk in this jurisdiction. Check via quote management system API.
  • Clearance: Verify no conflicting quotes exist for this insured from other brokers. Check via internal systems.
  • Re-run in detailed processing with full entity data (pre-screening used preliminary data).

Compliance Status Consolidation

Assemble a unified compliance view across all checks:

  • all_clear — all checks passed, no conditions
  • conditionally_clear — passed with conditions (e.g., licensing restrictions)
  • review_pending — unresolved HITL tasks
  • not_quotable — hard fail on compliance

See references/compliance-and-hitl.md for detailed compliance patterns.

Human-in-the-Loop Design

HITL is not a fallback — it is a first-class design element in underwriting automation. Three patterns, each for different scenarios:

Pattern 1: Asynchronous (Most Common)

Agent creates a review task, continues other work or pauses. Human completes the task within an SLA window. Agent resumes with human input.

  • Use for: Extraction review, disambiguation, broker queries, identity review.
  • Timeout: Configurable per gate. Illustrative defaults run from 30 min for a triage review (the worked example in references/submission-lifecycle.md) to a few hours for extraction review.

Pattern 2: Blocking (Compliance-Critical)

Agent halts completely until human explicitly clears. No progress on any downstream step until the gate is resolved.

  • Use for: Sanctions review, compliance review, clearance conflicts.
  • Timeout: No auto-timeout. Escalation after SLA breach.

Pattern 3: Deferred (Batch Review)

Agent proceeds with a provisional decision. Human reviews a batch of decisions during a scheduled review window.

  • Use for: Low-risk fields, audit sampling, calibration validation.
  • Review window: Typically daily or weekly.

HITL Gate Design Principles

  1. Gates are policy-driven, not hardcoded. Define gates in configuration (the per-LoB policy settings), not in agent code. This allows per-LoB customisation.
  2. Authorization is deterministic. Use a policy engine (e.g., Cedar) to control who can approve which gates. Keep authorization outside the LLM reasoning loop — agents cannot reason past policy gates.
  3. Capture structured override data. Every HITL review must record: original AI decision, human decision, rationale code, review time, and reviewer identity. This feeds confidence calibration.
  4. Guard against automation bias. Show confidence as bands (High/Medium/Low), not raw scores. Require independent human assessment before revealing AI output. Track review times to detect rubber-stamping.

Confidence Calibration

Raw LLM confidence is unreliable. Use a two-stage hybrid: deterministic business rules first (any Low-confidence trigger wins and routes to HITL; High requires every condition to hold; everything else is Medium), then self-consistency sampling for Medium outputs only — run the extraction N times at temperature > 0 and map the agreement rate to a confidence band. Monitor calibration with Expected Calibration Error (a system predicting 80% confidence should be right ~80% of the time) and auto-tighten thresholds on a critical breach. The rule lists, sampling pseudocode, agreement-to-band table, ECE formula and alert thresholds are in the "Confidence Calibration Details" section of references/compliance-and-hitl.md.

Operating Mode Progression

Introduce automation gradually through five operating modes, managed per workflow type (not globally). HITL rates are illustrative targets:

ModeHITL RateBehaviour
Manual100%Humans do all work. AI captures data for training.
Parallel comparison100% (comparison)AI runs in parallel. Results compared but not used.
Pre-fill with approval15-30%AI pre-fills. Human approves before any write.
Exceptions only5-15%AI handles routine cases. Exceptions route to human.
Automated< 5%Full automation. Human involvement only for policy-gated exceptions.

The mode names are illustrative labels for this ladder, not product vocabulary. The underlying model is a per-decision supervision setting: each mode fixes which decisions a human must take, approve, or merely sample.

Transitions and Emergency Stops

Moving a workflow up a mode needs admin approval, and the documented steps also need evidence (for example a configurable number of validated parallel-comparison outcomes before Parallel comparison → Pre-fill with approval). Every transition is recorded in an immutable audit ledger. Emergency-stop controls can force any workflow back to Manual at any time, and lifting an emergency stop never auto-restores the previous mode. The per-transition requirements and the four emergency-stop levels are in the "Operating Mode Transitions" and "Emergency Stop Controls" sections of references/compliance-and-hitl.md.

Underwriting Decision Package

The culmination of automated processing is a structured decision package that synthesises all upstream outputs for the underwriter:

  1. Broker & product facts — identity, relationship context, submission terms
  2. Assets & locations — insurable items with sanctions screening status
  3. Compliance outcomes — unified view across all compliance checks
  4. Coverage options & exclusions — requested terms vs. standard exclusions
  5. Scoring — overall confidence, thoroughness (% of required fields populated), evidence quality (% of facts with source traceability)
  6. Quote-readiness gate — deterministic routing to one of:
    • Ready to quote
    • Needs underwriter input
    • Needs compliance review
    • Request more information (critical gaps)

Lines of Business Considerations

Different LoB have different extraction requirements, compliance rules, and confidence thresholds. Design systems to be LoB-configurable:

  • Field catalogs (which fields to extract) are per-LoB configuration.
  • Confidence thresholds are per-LoB (terrorism may be stricter than general liability).
  • Compliance requirements vary by jurisdiction and LoB.
  • Use per-LoB policy settings — admin-owned configuration, one set per LoB — rather than code changes.

Common LoB Patterns

LoBKey Extraction ChallengesCompliance Focus
PropertyLocation schedules, building details, valuesSanctions (location-based), licensing
Casualty / LiabilityPolicy wording, exclusions, limits towersProfessional licensing, claims history
CyberTechnology stack, security posture, revenueData privacy regulations, incident history
MarineVessel details, routes, cargoSanctions (route-based), flag state
TerrorismHigh-value assets, location riskEnhanced sanctions, government pools

Reference Files

  • references/submission-lifecycle.md — Detailed stage-by-stage pipeline design with decision logic, event patterns, and cost targets
  • references/compliance-and-hitl.md — Sanctions screening escalation, HITL gate inventory, confidence calibration details, automation bias safeguards, operating mode transitions, emergency-stop controls
Repository

provectus/awos-recruitment

Path

registry/skills/underwriting/SKILL.md

Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.