maintenance-downtime

Log unplanned downtime events and calculate MTBF, MTTR, Pareto analysis, and downtime cost.

1|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/tapway/shogun-os --skill maintenance-downtime-tapway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maintenance-downtime
Source: https://github.com/tapway/shogun-os/tree/main/skills/manufacturing/maintenance-downtime
Command: npx skills add https://github.com/tapway/shogun-os --skill maintenance-downtime-tapway

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Manufacturing teams lose visibility into why equipment stops and how much those stoppages cost. This Skill centralizes unplanned downtime event logging and turns raw events into reliability metrics (MTBF, MTTR, availability), Pareto breakdowns, and cost estimates. ## Core Features & Use Cases - Downtime Event Logging: Record events with equipment ID, reason code, start/end times, shift, and operator, with automatic duration and cost calculation. - Pareto Analysis: Rank downtime by equipment, reason, shift, or operator to identify the vital few loss drivers. - Reliability Metrics: Compute MTBF, MTTR, and availability per equipment over any date range. - Cost Estimation: Estimate production loss using a configurable cost-per-hour rate with breakdown by reason category. - Use Case: A production manager notices line stoppages increasing. They log each event, run a 30-day Pareto grouped by reason, and discover mechanical failures on EQ-001 drive 35% of losses, justifying a targeted PM review. ## Quick Start Ask the agent to log a downtime event for equipment EQ-001 with reason mechanical_failure from 08:30 to 09:45 on the morning shift, then request a Pareto analysis for the last 30 days.

Frequently Asked Questions about maintenance-downtime

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

FAQPage Schema
How do I calculate MTBF and MTTR for manufacturing equipment?

Run the metrics subcommand with an equipment ID and date range. MTBF equals total operating time divided by number of failures, and MTTR equals total repair time divided by number of repairs, with availability also reported.

How to do a Pareto analysis of machine downtime?

Use the pareto subcommand with a date range and a group-by option of equipment, reason, shift, or operator. The output ranks contributors by downtime hours and highlights the vital few driving most losses.

What reason codes should I use for downtime tracking?

The skill uses a YAML catalog with codes like mechanical_failure, electrical_failure, changeover, material_shortage, no_operator, and quality_hold, grouped into equipment, process, supply, labor, and quality categories. You can customize the catalog file path via DT_REASON_CODES_PATH.

Can this skill handle planned maintenance scheduling?

No, it only tracks unplanned downtime events. For planned maintenance scheduling use the maintenance-pm skill, and for real-time machine state monitoring use the mes-connector skill instead.

Why is my downtime cost estimate inaccurate?

The estimate multiplies downtime hours by a flat DT_COST_PER_HOUR rate, which ignores product margin, downstream delays, and customer impact. Treat it as a directional indicator rather than a financial figure.

What happens when two downtime events overlap on the same equipment?

Overlapping events double-count downtime for the same equipment. The skill documentation recommends enforcing a single active event per equipment policy to keep metrics accurate.