maintenance-pm

Manages preventive maintenance schedules, generates work orders, and calculates PM compliance rates.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Manufacturing teams struggle to track preventive maintenance across calendar-based and meter-based schedules, leading to missed PMs, unplanned downtime, and poor compliance visibility. This Skill centralizes PM scheduling, due/overdue tracking, work order generation, and compliance reporting in one place. ## Core Features & Use Cases - PM Schedule Management: List and filter PM tasks by plant, equipment, and status across daily, weekly, monthly, quarterly, semi-annual, annual, and meter-based frequencies. - Automatic Work Order Generation: Generate work orders from the PM schedule within a configurable forward window (default 7 days). - Compliance & Overdue Reporting: Calculate PM compliance rates against a target threshold and identify overdue PMs with aging buckets and escalation priorities. - Use Case: A maintenance supervisor runs a weekly compliance report for PLANT-01, finds compliance at 92.3% against a 90% target, and escalates 3 PMs overdue by more than 3 days to the maintenance supervisor contact. ## Quick Start Ask the agent to list all due preventive maintenance tasks for your plant and generate work orders for the next 7 days.

Frequently Asked Questions about maintenance-pm

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

FAQPage Schema
How do I generate work orders from a preventive maintenance schedule?

Run the generate-wo subcommand with a date and optional plant filter, for example: python maintenance_pm.py generate-wo --date 2026-01-15 --plant plant-01. It generates work orders for PMs falling within the configured forward window, which defaults to 7 days via PM_AUTO_GENERATE_DAYS.

How is PM compliance rate calculated in maintenance tracking?

PM compliance rate is the percentage of PMs completed on time out of total PMs due in a period. Use the compliance subcommand with --from and --to dates; the result compares the rate against PM_COMPLIANCE_TARGET, which defaults to 90 percent.

What is the difference between calendar-based and meter-based preventive maintenance?

Calendar-based PMs trigger on fixed intervals like daily, weekly, or annual cycles, while meter-based PMs trigger after a set number of operating hours or cycles. Meter-based PMs require timely meter readings, so stale meter data can cause PMs to go undetected.

Why are meter-based PMs not triggering on schedule?

Meter-based PMs depend on timely meter readings from equipment. If readings stop arriving, the PMs go undetected, so set up alerts for stale meter data and verify the meter source connection and PM_METER_TYPES configuration.

When should I not use a preventive maintenance schedule tool?

Do not use it for unplanned breakdown tracking, which belongs to downtime analysis, or for corrective action management, which belongs to quality CAPA workflows. It is designed specifically for planned, recurring maintenance tasks.