plugins/lobbi-insurance-domain/skills/policy-workflow/SKILL.md
Design policy submission, underwriting review, and issuance workflows for insurance agencies and MGAs. Use when automating new business intake, quote-to-bind processes, or policy change endorsement workflows.
npx skillsauth add markus41/claude plugins/lobbi-insurance-domain/skills/policy-workflowInstall 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.
Design the end-to-end workflow for insurance policy submission, underwriting, binding, issuance, and endorsement. Produces a workflow specification and system integration requirements suitable for automation build.
Confirm which workflow components are in scope before designing:
Lines of business in scope: [Personal auto / Commercial auto / Homeowners / Commercial property / GL / Professional liability / Workers comp / Other]
Submission form design:
Define required fields by line of business. Group into sections that mirror ACORD form structure so data maps cleanly to carrier systems.
| Section | Fields | Required? | Source of Truth | |---------|--------|-----------|----------------| | Applicant information | Full name, DOB, SSN/EIN, address, contact | Required | Applicant entry | | Risk information | [LOB-specific: vehicle VIN, property address, business description] | Required | Applicant entry | | Prior insurance | Current carrier, policy #, expiration date, reason for shopping | Required for most carriers | Applicant entry | | Loss history | Claims in past 3–5 years (dates, types, amounts) | Required | Applicant entry + CLUE pull | | Requested coverage | Coverage types, limits, deductibles | Required | Agent selection | | Signatures | Applicant signature, agent certification | Required | E-signature |
ACORD form mapping:
| LOB | ACORD Form | Fields Mapped | |-----|-----------|--------------| | Personal lines | ACORD 80 | All personal auto fields | | Commercial lines | ACORD 125 | Commercial applicant info | | Property | ACORD 140 | Property details | | GL | ACORD 126 | General liability |
Document collection at intake:
| Document | Required For | Collection Method | Validation | |---------|------------|-----------------|------------| | Prior dec page | All renewals and transfers | Upload | Policy number matches; not expired | | MVR authorization | Personal and commercial auto | E-signature | Signed before MVR pull | | Loss runs | Commercial lines (3–5 years) | Upload or carrier request | Signed by prior carrier | | Photo inspection | Property over $[X] | Upload or inspection order | 4-point completed |
Risk appetite rules (work with client underwriting team to define):
| Rule | Condition | Action | |------|-----------|--------| | Auto-decline | [e.g., >2 at-fault accidents in 3 years] | Decline with adverse action notice | | Refer to underwriter | [e.g., prior lapse >60 days] | Route to UW queue with flagged reason | | Straight-through quote | [e.g., preferred risk, no adverse factors] | Auto-quote, agent notification | | MGA/carrier referral | [e.g., risk outside standard appetite] | Route to E&S market workflow |
Referral queue design:
| Field | Description | |-------|-------------| | Submission ID | Unique ID for tracking | | LOB and risk type | For routing to correct underwriter | | Flag reason | Which rule triggered the referral | | Priority | Standard / Rush (binding deadline approaching) | | Assigned underwriter | Auto-assigned by LOB and territory | | SLA | Response required within [N] business hours | | Escalation trigger | Unreviewed after [N] hours → supervisor notification |
Declination workflow:
Rating system integration:
| Carrier / Rating Engine | Connection Method | Data Format | Rate Return Format | |------------------------|------------------|-------------|-------------------| | [Carrier 1] | API / Rater | JSON / XML | Quoted premium + tier | | [Carrier 2] | | | |
Quote workflow:
Quote document required elements:
Bind authority rules:
| Bind Type | Authority Level | Approval Required | |-----------|----------------|------------------| | Preferred risk within appetite | Agent bind authority | None — auto-bind | | Standard risk | Agency bind authority | Agency principal approval if over $[X] premium | | Referral risk | Carrier/MGA bind authority | Carrier written approval before binding | | E&S / surplus lines | Surplus lines bind authority | Diligent search documentation + affidavit |
Bind workflow steps:
Surplus lines bind checklist:
Issuance workflow:
Endorsement intake:
| Change Type | Intake Method | Processing Path | |------------|--------------|----------------| | Driver add/remove | Online form or phone | Automated if within appetite; referral if adverse | | Vehicle add/remove | Online form or phone | Automated for standard; referral for high-value or specialty | | Address change | Online form or phone | Automated for most; referral if rate territory impact | | Coverage change | Agent-initiated | Agent submits to carrier; audit trail required | | Named insured change | Agent + carrier approval | Carrier-specific process; may require new application |
Endorsement processing:
Deliver two artifacts:
Workflow Diagram Specification — For each component in scope, a step-by-step process narrative with decision branches, actor at each step (system / agent / underwriter / insured / carrier), and system interactions
System Integration Requirements — For each system integration point:
tools
Build Teams-native agents with the Teams SDK (formerly Teams AI Library v2) — App class, activity routing, adaptive cards, streaming, AI-generated labels, feedback, message extensions, Teams-as-MCP-server, and the bring-your-own-AI pattern with Agent Framework.
tools
Run agents on Microsoft Foundry (formerly Azure AI Foundry) Agent Service — prompt agents vs hosted agents, threads/runs and the Responses API, built-in tools (Bing grounding, code interpreter, file search, MCP, OpenAPI, A2A), connected agents, Entra agent identity, SDKs, and observability/evaluations.
tools
Build and host custom engine agents with the Microsoft 365 Agents SDK — AgentApplication, the Activity protocol, channel reach via Azure Bot Service, hosting Agent Framework or Semantic Kernel engines, and the Agents Toolkit/Playground workflow. Successor to the Bot Framework SDK.
tools
Design, govern, and extend Microsoft Copilot Studio agents — topics, generative orchestration, knowledge, tools and MCP, agent flows, autonomous triggers, publishing channels, Copilot Credits pricing, and solution-based ALM on Power Platform.