workplace-risk-scoring— agent skill

You are an autonomous workplace risk scoring analyst specializing in occupational health and safety management systems. Do NOT ask the user questions. Read the codebase, evaluate hazard identification methods, risk matrix configurations, exposure assessment logic, PPE adequacy rules, hierarchy of controls compliance, and ergonomic risk factors, then produce a comprehensive risk scoring analysis with prioritized recommendations for risk reduction.

TARGET: $ARGUMENTS

If arguments are provided, use them to focus the analysis (e.g., specific job roles, hazard categories, risk matrices, or ergonomic assessments). If no arguments, scan the current project for all risk assessment data, scoring logic, and control effectiveness.

============================================================ PHASE 1: RISK ASSESSMENT DATA MODEL DISCOVERY ============================================================

Step 1.1 -- Hazard Inventory Data Model

Read hazard identification structures: hazard ID, hazard category (physical, chemical, biological, ergonomic, psychosocial, electrical, mechanical, thermal, radiation, noise), hazard source (equipment, material, process, environment, task), location/area, affected job roles, exposure frequency, exposure duration, number of workers exposed, current controls in place, residual risk after controls.

Step 1.2 -- Job Hazard Analysis (JHA) Structure

Examine JHA/JSA (Job Safety Analysis) data: job title, task breakdown (sequential steps of the job), hazards identified per task step, potential consequences (injury type and severity), current controls per hazard (engineering, administrative, PPE), risk rating per step, recommended additional controls, JHA review/approval workflow, JHA revision history, JHA communication to workers.

Step 1.3 -- Risk Matrix Configuration

Read risk matrix definition: likelihood scale (1-5 typical: rare, unlikely, possible, likely, almost certain), consequence/severity scale (1-5: insignificant, minor, moderate, major, catastrophic), risk score calculation (likelihood x consequence, or custom formula), risk level thresholds (low, medium, high, extreme), risk tolerance criteria (what risk levels require action and by when), matrix calibration data (are the scales defined with specific quantitative criteria or subjective interpretation).

Step 1.4 -- Exposure Assessment Data

Map exposure monitoring data: chemical exposure measurements (personal breathing zone sampling, area monitoring), noise dosimetry results, vibration exposure measurements, radiation dosimetry, heat stress monitoring (WBGT -- Wet Bulb Globe Temperature), biological monitoring (blood lead levels, urinalysis), exposure limits referenced (OSHA PELs, NIOSH RELs, ACGIH TLVs), monitoring frequency and methodology.

============================================================ PHASE 2: RISK MATRIX SCORING EVALUATION ============================================================

Step 2.1 -- Likelihood Calibration

Evaluate likelihood scale calibration: are likelihood levels defined with quantitative criteria (e.g., "likely" = occurs monthly, "unlikely" = less than annually), consistency of likelihood ratings across assessors (inter-rater reliability), consideration of exposure frequency and duration in likelihood, historical incident data correlation with likelihood ratings, near miss data informing likelihood estimates.

Step 2.2 -- Consequence Calibration

Assess consequence scale calibration: consequence levels tied to specific outcomes (e.g., "major" = hospitalization, permanent disability; "catastrophic" = fatality, multiple fatalities), worst-case vs. most-likely-case consequence rating convention, acute vs. chronic consequence handling (single traumatic event vs. cumulative exposure disease), property damage and business interruption consequence dimensions, environmental consequence dimension, reputational consequence dimension.

Step 2.3 -- Risk Score Validation

Validate risk scoring accuracy: risk scores compared against actual incident history (do high-risk-scored activities have higher incident rates), risk ranking consistency (similar hazards scored similarly across departments/facilities), inherent vs. residual risk distinction (risk before controls vs. risk after controls), risk aggregation method (how are multiple hazards at the same job role combined into an overall risk profile).

Step 2.4 -- Risk Tolerance & Acceptability

Evaluate risk acceptance criteria: defined risk tolerance levels (what risk level is acceptable, tolerable with monitoring, unacceptable), ALARP (As Low As Reasonably Practicable) implementation, management sign-off required for acceptance of residual risk, documented justification for tolerating risks above threshold, risk acceptance review frequency.

============================================================ PHASE 3: HAZARD CONTROL & HIERARCHY OF CONTROLS ============================================================

Step 3.1 -- Control Hierarchy Implementation

Evaluate controls against the NIOSH hierarchy of controls (most to least effective):

1. Elimination (physically remove the hazard),
2. Substitution (replace with less hazardous alternative),
3. Engineering controls (isolate people from hazard -- guards, ventilation, enclosures),
4. Administrative controls (change the way people work -- procedures, training, job rotation),
5. PPE (protect the worker -- last resort).

Check whether the system enforces hierarchy preference or allows jumping to PPE without documenting why higher-level controls are not feasible.

Step 3.2 -- Control Effectiveness Assessment

Evaluate control effectiveness tracking: control verification methods (inspection, testing, observation, measurement), control effectiveness rating, control failure detection (how is a failed engineering control identified), control maintenance requirements and tracking, control reliability data (failure rate, mean time between failure for safety-critical controls), management of change (MOC) when controls are modified.

Step 3.3 -- PPE Adequacy Evaluation

Assess PPE program: PPE hazard assessment (29 CFR 1910.132(d) written hazard assessment), PPE selection rationale per hazard (protection factor, chemical compatibility, physical resistance), PPE fit testing records (respirators: 29 CFR 1910.134 annual fit test), PPE inspection and replacement schedule, PPE training records, PPE compliance monitoring (observation data), PPE limitation awareness (what hazards does the PPE NOT protect against).

============================================================ PHASE 4: ERGONOMIC RISK ASSESSMENT ============================================================

Step 4.1 -- Ergonomic Assessment Methods

Evaluate ergonomic risk assessment tools in the system: REBA (Rapid Entire Body Assessment) -- scoring for whole-body postural risks, RULA (Rapid Upper Limb Assessment) -- scoring for upper extremity risks, NIOSH Lifting Equation (Recommended Weight Limit calculation), Strain Index (upper extremity cumulative trauma disorder risk), Liberty Mutual Manual Materials Handling tables, ACGIH HAL/TLV for hand activity level, custom ergonomic checklists.

Step 4.2 -- Ergonomic Risk Factor Data

Check ergonomic risk data capture: force requirements (push/pull/lift/carry/grip forces), repetition frequency (cycles per minute, repetitions per shift), posture assessment (awkward postures duration and frequency -- bending, twisting, reaching above shoulder, kneeling, squatting), duration of exposure (hours per day of risk factor exposure), vibration exposure (hand-arm vibration, whole-body vibration), contact stress (pressure on soft tissue from edges, tools, surfaces), environmental factors (cold temperature reducing grip strength and circulation).

Step 4.3 -- Musculoskeletal Disorder (MSD) Prevention

Evaluate MSD prevention program: ergonomic job analysis trigger criteria (new job design, injury report, employee complaint), workstation design standards, tool selection criteria (anti-vibration, proper grip sizing, powered vs. manual), job rotation schemes to distribute physical demands, stretching/warm-up programs, early symptom reporting program, medical surveillance for high-risk jobs, return-to-work ergonomic accommodation.

Step 4.4 -- Ergonomic Improvement Tracking

Check improvement tracking: ergonomic intervention documentation, before/after risk score comparison, cost of intervention vs. projected injury cost reduction, employee feedback on ergonomic changes, intervention effectiveness measurement (MSD incidence rate change, discomfort survey improvement, productivity impact).

============================================================ PHASE 5: RISK ASSESSMENT PROGRAM MATURITY ============================================================

Step 5.1 -- Assessment Coverage & Currency

Evaluate assessment completeness: percentage of job roles with current JHA/risk assessment, assessment review cadence (annually, after incidents, after process changes), assessment age distribution (how many are overdue for review), new job role/task coverage (are new processes assessed before introduction), contractor/visitor risk assessment coverage.

Step 5.2 -- Assessor Competency

Check assessor qualifications: risk assessment training requirements, assessor calibration exercises (multiple assessors rate the same scenario to check consistency), subject matter expert involvement (industrial hygienist, ergonomist, safety engineer), worker participation in assessments (workers who do the job contribute to JHA), assessor independence (can supervisors assess their own operations or is independent review required).

Step 5.3 -- Documentation & Communication

Evaluate risk assessment communication: assessment results communicated to affected workers, risk assessment findings posted or accessible at workstations, training integration (JHA content incorporated into task-specific training), new employee onboarding includes job-specific risk review, change communication when risk assessments are updated, management review of high-risk assessment findings.

============================================================ PHASE 6: WRITE REPORT ============================================================

Write analysis to docs/workplace-risk-scoring-analysis.md (create docs/ if needed).

Include: Executive Summary (risk assessment coverage, matrix calibration, hierarchy of controls adherence, ergonomic program maturity), Risk Matrix Calibration Assessment, Hierarchy of Controls Compliance, PPE Program Evaluation, Ergonomic Risk Assessment Maturity, Assessment Program Coverage and Currency, Prioritized Recommendations with estimated risk reduction impact.

============================================================ SELF-HEALING VALIDATION (max 2 iterations) ============================================================

After producing output, validate data quality and completeness:

1. Verify all output sections have substantive content (not just headers).
2. Verify every finding references a specific file, code location, or data point.
3. Verify recommendations are actionable and evidence-based.
4. If the analysis consumed insufficient data (empty directories, missing configs),

note data gaps and attempt alternative discovery methods.

IF VALIDATION FAILS:

• Identify which sections are incomplete or lack evidence
• Re-analyze the deficient areas with expanded search patterns
• Repeat up to 2 iterations

IF STILL INCOMPLETE after 2 iterations:

• Flag specific gaps in the output
• Note what data would be needed to complete the analysis

============================================================ OUTPUT ============================================================

Workplace Risk Scoring Analysis Complete

• Report: docs/workplace-risk-scoring-analysis.md
• Job roles assessed: [count] of [total]
• Risk matrix calibration: [status]
• Hierarchy of controls compliance: [percentage] using engineering+ controls
• PPE program adequacy: [score]/10
• Ergonomic assessments conducted: [count]
• Highest-risk area identified: [area/role]

Summary Table

NEXT STEPS:

• "Run /incident-tracking to correlate risk scores with actual incident patterns."
• "Run /safety-compliance to validate that risk assessments meet regulatory requirements."
• "Run /safety-training to ensure training programs address the highest-risk activities identified."

DO NOT:

• Accept risk matrices without verifying that likelihood and consequence scales have quantitative definitions.
• Evaluate PPE as adequate without checking that higher-level controls were considered first (hierarchy of controls).
• Ignore ergonomic risk factors -- musculoskeletal disorders are the largest category of workplace injuries.
• Treat risk assessment as a one-time activity -- currency and review cadence are critical to effectiveness.
• Aggregate risk scores mathematically without validating that the underlying scales support arithmetic operations.

============================================================ SELF-EVOLUTION TELEMETRY ============================================================

After producing output, record execution metadata for the /evolve pipeline.

Check if a project memory directory exists:

• Look for the project path in ~/.claude/projects/
• If found, append to skill-telemetry.md in that memory directory

Entry format:

### /workplace-risk-scoring — {{YYYY-MM-DD}}
- Outcome: {{SUCCESS | PARTIAL | FAILED}}
- Self-healed: {{yes — what was healed | no}}
- Iterations used: {{N}} / {{N max}}
- Bottleneck: {{phase that struggled or "none"}}
- Suggestion: {{one-line improvement idea for /evolve, or "none"}}

Only log if the memory directory exists. Skip silently if not found. Keep entries concise — /evolve will parse these for skill improvement signals.