home-inspector-ops

v1.0.0 MIT professional updated 2026-09-27

Turn raw home-inspection findings (system, item, severity, note) into a formatted client-ready Markdown report grouped by system with a severity summary table. Use when writing up a residential inspection instead of formatting the report by hand.

$ skillbank install home-inspector-ops@1.0.0
# pins exactly 1.0.0 · README + changelog included

Home Inspector Ops

Overview

You walk the property, you note the defects — then you face an hour of formatting. Home Inspector Ops takes your findings as JSON and produces a clean Markdown report: a severity summary table up front, findings grouped by system (Electrical, Roofing, Plumbing, …), and the worst problems listed first within each group. Export to PDF or Word with any Markdown converter.

Severities are fixed and meaningful: safety (immediate hazard), major (significant defect), minor (routine repair), cosmetic (appearance only). All data stays local — nothing is uploaded.

Installation

1. Copy the home-inspector-ops/ directory anywhere convenient. 2. Make the script executable (Unix):


   chmod +x scripts/report.py

No pip install needed — standard library only.

Configuration

No config file. Findings JSON is either a bare list of finding objects or an object with optional address, date, inspector fields plus a findings list:


{
  "address": "1420 Oak Street, Springfield",
  "date": "2026-09-25",
  "inspector": "Jane Cooper",
  "findings": [
    {"system": "Roofing", "item": "Missing shingles on south slope",
     "severity": "major",
     "note": "Three tab shingles missing near ridge; decking exposed."},
    {"system": "Electrical", "item": "Double-tapped breaker in main panel",
     "severity": "safety",
     "note": "Two branch circuits share one breaker lug; fire risk."}
  ]
}

| Field | Required | Description | |------------|----------|------------------------------------------------------------| | system | yes | Building system, e.g. Roofing, Electrical, Plumbing, HVAC. | | item | yes | Short name of the defect. | | severity | yes | One of: safety, major, minor, cosmetic. | | note | yes | One or two sentences of detail for the client. |

Inputs

| Command | Arguments | Returns | |-------------------------------------------------|-------------------------------|----------------------------------| | report.py <findings.json> | findings JSON file | Markdown report on stdout. | | report.py <findings.json> --output report.md | findings JSON file | Markdown report written to file. |

Invalid JSON, missing fields, or an unknown severity exits with a clear error and a nonzero exit code — never a raw traceback.

Worked example


$ cat > findings.json << 'EOF'
{
  "address": "1420 Oak Street, Springfield",
  "date": "2026-09-25",
  "inspector": "Jane Cooper",
  "findings": [
    {"system": "Roofing", "item": "Missing shingles on south slope",
     "severity": "major",
     "note": "Three tab shingles missing near ridge; decking exposed to weather."},
    {"system": "Electrical", "item": "Double-tapped breaker in main panel",
     "severity": "safety",
     "note": "Two branch circuits share one breaker lug; fire risk. Recommend licensed electrician."},
    {"system": "Plumbing", "item": "Slow drip at kitchen sink trap",
     "severity": "minor",
     "note": "Active slow leak at P-trap; no water damage visible yet."}
  ]
}
EOF
$ ./scripts/report.py findings.json --output report.md
wrote report to report.md

report.md begins:


# Home Inspection Report
**Address:** 1420 Oak Street, Springfield
**Date:** 2026-09-25
**Inspector:** Jane Cooper

**Total findings:** 3

## Severity summary

| Severity | Count | Meaning |
|----------|-------|---------|
| Safety | 1 | Immediate hazard; repair before occupancy |
| Major | 1 | Significant defect; repair promptly |
| Minor | 1 | Routine maintenance or repair |
| Cosmetic | 0 | Appearance only |

Safety notes

The report carries a footer stating it is a general visual inspection, not a code-compliance certification — keep it there. Severity labels have liability weight; when in doubt between major and safety, say major and recommend a licensed specialist evaluate it.

Version history

Changelog

1.0.0 — 2026-09-27

  • Initial release. scripts/report.py converts findings JSON into a
  • Markdown inspection report grouped by system with a severity summary table. Added references/severity-guide.md.

← back to catalog