Skills Compliance
Complaint identification and classification
npx rulebase-skills install cx-complaint-classificationWhen to use it
Reach for this when someone says any of these — they are the phrases the skill itself triggers on:
- “are we identifying complaints correctly”
- “complaint detection”
How it works
The method, in the order the skill runs it. The full procedure — tables, worked examples and the edge cases — is in the skill itself.
The error that causes regulatory findings
A complaint is a definition, not a feeling.
Step 1: get the definition, in writing, from compliance
Do not draft it yourself. Obtain the definition that applies to your entity and licence, and hold it as the single source of truth.
Step 2: tune for recall, not precision
This is the design decision that most distinguishes complaint detection from ordinary classification, and it is counter-intuitive to anyone with an ML background.
Step 3: build detection in layers
Layer 1: structural signals. Cheap, high-precision, no model needed. Customer used the word "complaint" or "complain". Contacted an ombudsman or regulator. Third repeat contact on one issue. Escalation requested. Refund or compensation demanded. Solicitor or advocate involved.
Step 4: classify on separate axes
Once something is a complaint, several independent things need recording. Collapsing them into one field is the most common structural mistake — it makes root-cause reporting impossible.
Step 5: treat vulnerability as its own detection problem
Vulnerability signals frequently co-occur with complaints and carry separate, often stricter obligations. Detect them independently rather than as a complaint sub-category.
Step 6: build the audit trail before you need it
Regulators ask how you decided, not just what you decided. Every complaint record should carry: The definition version applied, Which elements were met, with a verbatim quote for each, Who confirmed it, and when, Detection route, Timestamps, immutable, with the clock-start rule applied consistently, Every state change, retained.
Step 7: audit for what you missed
Precision is easy to audit — review what you flagged. Recall is the hard part and the part that matters.
Related skills
Free and open source, and vendor-neutral — it reads the conversations from whichever helpdesk you already run. Browse all 149 skills · connect your helpdesk over MCP · source on GitHub
