failure-tracker

Log development failures with category, context, cause, solution, and prevention.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/stitts-dev/dotfiles --skill failure-tracker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: failure-tracker
Source: https://github.com/stitts-dev/dotfiles/tree/main/.claude/skills/failure-tracker
Command: npx skills add https://github.com/stitts-dev/dotfiles --skill failure-tracker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured way to document and learn from failures encountered during development, preventing recurring mistakes and improving overall process quality.

Core Features & Use Cases

  • Systematic Failure Logging: Capture details about what went wrong, why, and how it was resolved.
  • Categorization: Classify failures into Code, Pattern, Tool, Environment, or Process types for better analysis.
  • Routing Logic: Directs failures to the most appropriate log (global, skill-specific, or project-specific).
  • Prevention Guidance: Encourages documenting steps to avoid future occurrences.
  • Use Case: After spending hours debugging an unexpected API response, you can use this skill to log the root cause and the solution, ensuring that anyone encountering a similar issue in the future can quickly resolve it.

Quick Start

Log a new failure by providing its category, context, what went wrong, the cause, and how to prevent it.

Frequently Asked Questions about failure-tracker

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

FAQPage Schema
How do I track and document debugging failures during development?

Track debugging failures by logging the context, root cause, solution, and prevention steps. This systematic failure documentation categorizes issues into code, pattern, tool, environment, or process types to prevent recurring mistakes.

What is the best way to log development mistakes for a retrospective?

Logging development mistakes for a retrospective requires capturing what went wrong and why. This skill provides a standard log format that integrates with retrospective processes to analyze failures and update prevention checklists.

How do I categorize coding errors to prevent recurrence?

Categorize coding errors by classifying them into code, pattern, tool, environment, or process types. This classification routes failures to the appropriate project-specific or global logs for better analysis and future prevention.

Can I route failure logs to specific project directories?

Yes, you can route failure logs to specific project directories. The routing logic directs failures to global, skill-specific, or project-specific logs based on the context, ensuring documentation is organized and accessible.

What should be included in a software failure log entry?

A software failure log entry should include the failure category, context, what went wrong, the root cause, the solution, and how to prevent it. This standard format ensures comprehensive documentation for future debugging.

Why do I need a structured process for logging environment and tool failures?

A structured process for logging environment and tool failures prevents recurring mistakes and improves process quality. Systematic documentation ensures anyone encountering a similar issue can quickly find the root cause and resolution.