Skip to content
Design
Skill

/failure-taxonomy

Classifying AI failures — hallucination, refusal, irrelevance, tone mismatch, latency.

BOOST
From plugin
ai-design-skills
18844 skills18 commands
Install
$ npx -y skills add owl-listener/ai-design-skills --skill failure-taxonomy --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/failure-taxonomy

Context preview

The summary Claude sees to decide when to auto-load this skill.

Classifying AI failures — hallucination, refusal, irrelevance, tone mismatch, latency.

SKILL.md

failure-taxonomy.SKILL.md
name: failure-taxonomy
description: Classifying AI failures — hallucination, refusal, irrelevance, tone mismatch, latency.

Failure Taxonomy

Not all AI failures are the same. A hallucination is different from a refusal, which is different from a tone mismatch. A failure taxonomy classifies failure types so teams can track, prioritise, and address them systematically.

Failure Categories

**Content Failures:**

  • **Hallucination**: The AI presents false information as fact
  • **Inaccuracy**: The AI gets details wrong (dates, numbers, names)
  • **Incompleteness**: The AI misses important information
  • **Irrelevance**: The AI's response doesn't address the user's actual question
  • **Contradiction**: The AI contradicts itself within or across responses

**Behavioral Failures:**

  • **Inappropriate refusal**: The AI refuses a reasonable request
  • **Missing refusal**: The AI fulfils a request it should have declined
  • **Tone mismatch**: The AI's tone is wrong for the context
  • **Persona break**: The AI drops out of its defined persona
  • **Over-generation**: The AI produces far more than needed

**Technical Failures:**

  • **Latency**: Response takes too long
  • **Truncation**: Response is cut off
  • **Format errors**: Output is in the wrong format or structure
  • **Tool failures**: The AI attempts to use a tool and fails
  • **Context loss**: The AI loses track of conversation history

**Safety Failures:**

  • **Harmful content**: The AI generates content that could cause harm
  • **Privacy violation**: The AI reveals sensitive information
  • **Bias manifestation**: The AI's output shows bias against a group
  • **Manipulation**: The AI's output could be used to deceive or manipulate

Severity Levels

  • **Critical**: Causes harm or creates serious trust violation. Requires immediate fix.
  • **High**: Significantly degrades user experience or task success. Fix within days.
  • **Medium**: Noticeable quality issue that users can work around. Fix within weeks.
  • **Low**: Minor quality issue. Track and batch with other fixes.

Using the Taxonomy

  • **Logging**: Classify every detected failure by type and severity
  • **Trending**: Track failure type frequency over time
  • **Prioritisation**: Address highest-severity, highest-frequency failures first
  • **Root cause analysis**: Group failures by type to identify systemic causes
  • **Prevention**: Use failure patterns to inform guardrail design and prompt improvements

Design Artefacts

  • Failure taxonomy reference document
  • Failure logging templates
  • Severity classification rubric
  • Failure trend dashboards
  • Root cause analysis protocols
Read more
Ships withai-design-skills

Part of the Designer Skills suite. Install this collection and four more with one command in Claude Code: /plugin marketplace add Owl-Listener/designer-skills This repo still works on its own. The suite just gives everyone one front door.

Get the whole plugin

Other skills on ai-design-skills.