failure-taxonomy

Categorize software failures and track occurrence frequency in a local JSON file.

1|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/jimmymalhan/codereview-pilot --skill failure-taxonomy-jimmymalhan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: failure-taxonomy
Source: https://github.com/jimmymalhan/codereview-pilot/tree/main/.claude/skills/failure-taxonomy
Command: npx skills add https://github.com/jimmymalhan/codereview-pilot --skill failure-taxonomy-jimmymalhan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the challenge of recurring failures by systematically categorizing them, tracking their frequency, and implementing preventative measures to reduce their recurrence.

Core Features & Use Cases

  • Failure Categorization: Assigns a specific category to each failure event (e.g., test_failure, build_failure, api_error).
  • Frequency Tracking: Maintains a count of how often each failure category occurs.
  • Preventative Action: Suggests or adds preventive measures to checklists for categories that exceed a certain frequency threshold.
  • Use Case: When a test_failure occurs multiple times, the skill can automatically add a reminder to the team's checklist to "Run npm test after each file edit."

Quick Start

Categorize the current failure as a 'timeout' and add a prevention step if it occurs more than twice.

Frequently Asked Questions about failure-taxonomy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I categorize software failures and track their occurrence frequency?

You can categorize software failures by assigning specific categories like test_failure or api_error, and track their occurrence frequency using a local JSON file that maintains persistent failure counts and prevention status.

What is the best way to prevent recurring build failures and test failures?

Preventing recurring build failures involves mapping incidents to predefined taxonomy categories and implementing preventative measures, automatically suggesting checklist additions like running tests after file edits when a category exceeds a frequency threshold.

How does failure taxonomy integrate with circuit breaker patterns and error tracking?

Failure taxonomy integrates with error tracking and circuit breaker patterns by mapping detected incidents to predefined taxonomy categories, allowing systematic categorization that supports circuit breaking based on tracked failure frequency.

Do I need a local JSON file for persistent incident management and failure tracking?

Yes, you need a local JSON file for persistent failure tracking, which stores the occurrence counts for each failure category and tracks the status of preventative measures across incidents.

Can I automatically add prevention steps to a checklist when an API error occurs multiple times?

Yes, when an API error or similar failure category occurs multiple times and exceeds a defined frequency threshold, the system automatically suggests or adds preventative measures to your team's checklist.

When should I not use a predefined taxonomy for incident management?

You should avoid using a predefined failure taxonomy when your incidents do not fit distinct categories like timeout or build_failure, or when you lack a local environment to maintain the persistent JSON tracking file.