mcpbeat

Liquidity Management

joellewis/liquidity-management

Plan and manage cash flow to ensure adequate liquidity while minimizing opportunity cost of excess cash. Use when the user asks about cash flow forecasting, CD or bond laddering, liquidity tiers, income smoothing for variable earners, or sweep strategies. Also trigger when users mention 'T-bill ladder', 'where to park cash', 'irregular income budgeting', 'freelancer cash management', 'lumpy expenses', 'liquidity ratio', 'how much cash to hold', or ask how to plan for large upcoming expenses.

8k tokens
context cost
the whole folder, loaded on every use
2
files
ships runnable scripts
0
copies elsewhere
how many repositories repackaged it
161
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/JoelLewis/finance_skills --skill liquidity-management

What comes with it

22 645 bytes besides the instruction
scripts/liquidity_management.py

The instruction itself

18 sections, as written by the author

Liquidity Management

Core Concepts

Cash Flow Forecasting

Project income and expenses monthly for 12+ months:

  • Income sources: salary, business income, investment income, rental income, side gigs
  • Fixed expenses: mortgage/rent, insurance, subscriptions, loan payments
  • Variable expenses: food, utilities, discretionary spending
  • Periodic lumpy expenses: property taxes, insurance premiums, tuition, estimated taxes
  • Net cash flow: income - expenses per period → identifies surplus/deficit months

Income Smoothing (Variable Earners)

For commission, freelance, seasonal, or bonus-heavy income:

  • Compute trailing 12-month average income as "base salary equivalent"
  • Budget based on base amount, not peak months
  • Buffer surplus months into a smoothing reserve (separate from emergency fund)
  • Target smoothing reserve: 2-3 months of base expenses
  • Draw from reserve in below-average months

Liquidity Tiers

Classify investable assets by time to access:

| Tier | Access Time | Examples | Typical Yield |

|------|------------|---------|---------------|

| Tier 1 — Immediate | Same day | Checking and savings at your primary bank, money market funds | Low |

| Tier 2 — Short-term | 1-3 business days | High-yield savings at an online bank, brokerage sweep cash, T-bills, bond funds and bond ETFs | Moderate |

| Tier 3 — Medium-term | 1-4 weeks (or penalty cost) | CDs (early-withdrawal penalty), I-bonds (after 1-year lockup) | Moderate-High |

| Tier 4 — Long-term | 30+ days | Real estate, PE/VC, locked alternatives, retirement accounts (pre-59½) | Highest |

Tier notes:

  • Tier 1 vs Tier 2 savings: the distinction is transfer time, not product type. A savings account at your primary bank offers same-day access (Tier 1); a high-yield savings account at an online bank typically requires a 1-3 business day ACH transfer to reach your checking account (Tier 2).
  • Bond funds and bond ETFs: both settle T+1 (the US moved to T+1 settlement in May 2024 for equities, ETFs, and mutual funds), so sale proceeds are available in roughly 1-3 business days including transfer to a bank. They belong in Tier 2 for access time — though, unlike deposits, the sale price is subject to market risk.

CD Laddering

Stagger CD maturities for regular access + higher yields:

  • Example: $60K split into 6 CDs maturing every 2 months
  • As each CD matures: either use the cash or reinvest at the longest rung
  • Benefit: captures term premium while maintaining periodic liquidity
  • Variant: 3/6/9/12-month ladder, renewing each at 12 months

Bond Laddering

Similar concept with Treasury or corporate bonds:

  • Annual maturities across 1-5 or 1-10 years
  • Provides predictable cash flows and interest rate diversification
  • Rungs mature and are reinvested at prevailing rates (automatic rate averaging)

T-Bill Ladder

Short-duration, high-liquidity ladder:

  • 4/8/13/26-week T-bills rolling continuously
  • Purchased at Treasury Direct or through brokerage
  • State tax exempt (federal only)
  • Highly liquid: can sell on secondary market before maturity

Liquidity Metrics

  • Liquidity ratio: liquid assets / monthly expenses (target ≥ 3-6)
  • Cash reserve ratio: cash + near-cash / total portfolio
  • Current ratio (business): current assets / current liabilities (target > 1.5)
  • Quick ratio (business): (current assets - inventory) / current liabilities

Seasonal and Tax Planning

  • Estimated taxes: quarterly for self-employed (Q1: Apr 15, Q2: Jun 15, Q3: Sep 15, Q4: Jan 15)
  • Property taxes: typically semi-annual — reserve monthly for escrow-like smoothing
  • Holiday/vacation: set aside monthly into dedicated sub-account
  • Annual expenses: insurance premiums, memberships → amortize monthly

Margin of Safety

Maintain buffer above minimum liquidity requirements:

  • Income uncertainty → larger buffer
  • Known upcoming large expenses → pre-fund 2-3 months early
  • Market correlation: income and portfolio may both decline in recession

Key Formulas

| Formula | Expression | Use Case |

|---------|-----------|----------|

| Liquidity ratio | Liquid assets / monthly expenses | Adequacy check |

| Net cash flow | Σ income - Σ expenses | Monthly surplus/deficit |

| CD ladder yield | Weighted average of rung yields | Blended return on ladder |

| Smoothing reserve | Base monthly expenses × 2-3 | Buffer for variable income |

| Breakeven penalty | CD early withdrawal penalty / (CD rate - savings rate) | Whether to break CD |

Worked Examples

Example 1: CD Ladder Construction

Given: $60,000 to deploy, want liquidity every 2 months, 12-month CDs yielding 4.8%

Calculate: Ladder structure and blended yield

Solution:

  • Split into 6 equal CDs of $10,000 each
  • Stagger maturities: 2, 4, 6, 8, 10, 12 months
  • Initial yields may vary by term: 2mo=4.2%, 4mo=4.4%, 6mo=4.5%, 8mo=4.6%, 10mo=4.7%, 12mo=4.8%
  • Blended yield ≈ average = 4.53%
  • Every 2 months one CD matures → reinvest at 12-month rate (4.8%) or use funds
  • After full cycle (12 months), all CDs are 12-month earning 4.8%

Example 2: Variable Income Smoothing

Given: Freelancer with monthly income ranging $3,000-$15,000, average $8,000. Monthly expenses $5,500.

Calculate: Base budget and smoothing reserve target

Solution:

  • Base budget: $5,500/month (essential expenses)
  • Average monthly surplus: $8,000 - $5,500 = $2,500
  • Smoothing reserve target: $5,500 × 3 = $16,500
  • In months earning >$8K: direct excess to smoothing reserve until funded
  • In months earning <$5.5K: draw from smoothing reserve
  • Once reserve is funded, excess above $8K goes to savings/investment goals

Common Pitfalls

  • Illiquidity surprise: needing cash when assets are locked in alternatives or retirement accounts
  • Penalty drag from breaking CDs frequently (defeats the purpose of laddering)
  • Over-optimizing yield at the expense of access (yield chasing in illiquid instruments)
  • Not planning for estimated tax payments (large quarterly cash needs for self-employed)
  • Ignoring correlation between income loss and market decline (both happen in recessions)
  • Treating credit lines as liquidity (they can be revoked when most needed)

Cross-References

  • emergency-fund (wealth-management plugin): first tier of liquidity, must be funded before optimizing
  • lending (wealth-management plugin): margin loans, HELOCs as backup liquidity (with risks)
  • time-value-of-money (core plugin): CD/bond pricing, yield calculations
  • debt-management (wealth-management plugin): debt payments are fixed cash flow obligations
  • savings-goals (wealth-management plugin): multiple goals compete for available cash flow
  • tax-efficiency (wealth-management plugin): estimated taxes, tax-loss harvesting timing
  • fixed-income-sovereign (wealth-management plugin): T-bill ladder mechanics, Treasury Direct
  • financial-planning-workflow (advisory-practice plugin): cash flow tier structure informs the liquidity analysis in comprehensive financial plans
  • equity-compensation (wealth-management plugin): option exercise costs, RSU withholding gaps, and AMT bills create planned liquidity needs in vest and exercise years

Running the script

Run the reference implementation directly:

uv run scripts/liquidity_management.py     # PEP 723 header resolves dependencies automatically
python3 scripts/liquidity_management.py    # after: pip install numpy scipy

A bare run prints a demo covering liquidity ratios, a 12-month cash flow projection, cash runway, liquidity tier analysis, CD ladder construction, income smoothing, and CD breakeven analysis. Use --verify to recompute the demo figures and assert they match this skill's worked examples (prints PASS/FAIL, exits nonzero on mismatch), and --help to list the available classes and functions. The file is primarily meant to be imported as a module (from liquidity_management import LiquidityManagement) rather than run standalone.

How to use it

Copy the folder

Take joellewis/liquidity-management from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.

Install what it needs

The instructions reference pip. Without those the skill loads but fails at the first command.