property-investor-ops
Screen a rental property in one command — give it price, monthly rent, taxes, insurance, vacancy/capex/management percentages, and optional financing, and get cap rate, monthly cash flow, cash-on-cash return, and a 1%-rule check with the full math shown. Use when underwriting a buy-and-hold deal or comparing two properties side by side.
$ skillbank install property-investor-ops@1.0.0 # pins exactly 1.0.0 · README + changelog included
Property Investor Ops
Overview
A rental-deal underwriter that fits in one command. You supply the purchase price, gross monthly rent, annual taxes and insurance, vacancy/CapEx/ management percentages, and optional financing (down payment, rate, term). The script prints the full pro-forma math — effective gross income, operating expenses, NOI — then cap rate, monthly cash flow, cash-on-cash return, and a 1%-rule check. All data stays local — nothing is uploaded.
Installation
1. Copy the property-investor-ops/ directory anywhere convenient. 2. Make the script executable (Unix):
chmod +x scripts/analyze.py
No pip install needed — standard library only.
Configuration
No config file. All inputs are command-line flags:
| Flag | Default | Description | |----------------|---------|------------------------------------------------| | --price | — (required) | Purchase price. | | --rent | — (required) | Gross monthly rent, all units combined. | | --taxes | — (required) | Annual property taxes. | | --insurance | — (required) | Annual insurance premium. | | --vacancy | 5 | Vacancy allowance, % of rent. | | --capex | 8 | CapEx reserve, % of rent. | | --management | 10 | Management fee, % of rent. | | --down | none | Down payment; omit for an all-cash analysis. | | --rate | 6.75 | Mortgage APR. | | --term | 30 | Mortgage term in years. |
Percentages are % of gross rent. CapEx and management reserves are applied to gross rent (not effective gross) — the conservative convention.
Inputs
analyze.py --price N --rent N --taxes N --insurance N [options]
Returns, on stdout: effective gross income, itemized operating expenses, NOI, cap rate, financing terms with monthly P&I, monthly and annual cash flow, cash-on-cash return, and the 1%-rule check. Invalid input produces a clear Error: message on stderr and exit code 2 — never a raw traceback. See references/metrics-explained.md for what each metric means and what the analysis leaves out.
Worked example
A sample duplex — $240,000 purchase, $1,200/side ($2,400 total rent), 20% down at 6.75% for 30 years:
./scripts/analyze.py --price 240000 --rent 2400 --taxes 4200 --insurance 1500 \
--vacancy 5 --capex 8 --management 10 \
--down 48000 --rate 6.75 --term 30
Output:
Rental analysis: $240,000.00 purchase, $2,400.00/mo rent
Gross rent (annual) $28,800.00
- Vacancy (5.0%) $1,440.00
= Effective gross income $27,360.00
Operating expenses:
Taxes $4,200.00
Insurance $1,500.00
CapEx reserve (8% of rent) $2,304.00
Management (10% of rent) $2,880.00
Total operating expenses $10,884.00
Net operating income $16,476.00
CAP RATE 6.87%
Financing: $48,000.00 down, $192,000.00 loan @ 6.750% / 30yr
Monthly P&I $1,245.31
MONTHLY CASH FLOW $127.69
Annual cash flow $1,532.30
CASH-ON-CASH RETURN 3.19%
(closing costs are not included in cash invested)
1%-RULE CHECK: monthly rent is 1.00% of price — PASS (needs >= 1.00%)
Thin cash flow, honest numbers: the vacancy and CapEx reserves are what push this duplex from "looks great" to "$128 a month." That is exactly the point — run the reserves, not the fantasy.
Version history
Changelog
1.0.0 — 2026-09-27
- Initial public release.
scripts/analyze.py: rental pro-forma → cap rate, monthly cash flow, cash-on-cash return (with down payment, rate, term), and 1%-rule check, all with itemized math.references/metrics-explained.md: what cap rate, cash flow, cash-on-cash, and the 1% rule mean, plus what the analysis leaves out.- Zero dependencies; tested with a $240k duplex sample plus bad-input cases (zero price, percentage out of range, down payment ≥ price).