MCPInstall

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.

Installs
718
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/joellewis/finance_skills --skill liquidity-management
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads liquidity-management automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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:

TierAccess TimeExamplesTypical Yield
Tier 1 — ImmediateSame dayChecking and savings at your primary bank, money market fundsLow
Tier 2 — Short-term1-3 business daysHigh-yield savings at an online bank, brokerage sweep cash, T-bills, bond funds and bond ETFsModerate
Tier 3 — Medium-term1-4 weeks (or penalty cost)CDs (early-withdrawal penalty), I-bonds (after 1-year lockup)Moderate-High
Tier 4 — Long-term30+ daysReal 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

FormulaExpressionUse Case
Liquidity ratioLiquid assets / monthly expensesAdequacy check
Net cash flowΣ income - Σ expensesMonthly surplus/deficit
CD ladder yieldWeighted average of rung yieldsBlended return on ladder
Smoothing reserveBase monthly expenses × 2-3Buffer for variable income
Breakeven penaltyCD 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.

FAQ

What does the liquidity-management skill do?

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.

How do I install liquidity-management?

Run npx skills add https://github.com/joellewis/finance_skills --skill liquidity-management in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/liquidity-management/ (personal) or .claude/skills/liquidity-management/ (project).

Which AI agents can use liquidity-management?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is liquidity-management safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains liquidity-management?

It is published by joellewis in joellewis/finance_skills. It has 718 recorded installs.

More from joellewis/finance_skills

View all →

asset-allocation

joellewis/finance_skills

Determine how to distribute capital across asset classes using strategic and tactical allocation frameworks. Use when the user asks about portfolio allocation, mean-variance optimization, Black-Litterman, risk parity, glide paths, or target-date strategies. Also trigger when users mention 'how much in stocks vs bonds', '60/40 portfolio', 'policy portfolio', 'core-satellite', 'liability-driven investing', 'asset-liability matching', or ask how to split their money across investments.

Business & Finance852 installs

statistics-fundamentals

joellewis/finance_skills

Apply statistical methods to financial data including descriptive statistics, covariance estimation, regression, hypothesis testing, and resampling. Use when the user asks about return distributions, correlation between assets, building a covariance matrix, running a CAPM regression, testing whether alpha is significant, checking if returns are normal, or estimating confidence intervals. Also trigger when users mention 'volatility', 'how correlated are these', 'fat tails', 'skewness', 'R-squared', 'beta of a fund', 'bootstrap a Sharpe ratio', 'shrinkage estimator', 'Ledoit-Wolf', or ask why their optimizer produces unstable weights.

Testing & QA817 installs

quantitative-valuation

joellewis/finance_skills

Estimate intrinsic value of stocks and companies using DCF, dividend discount models, comparable multiples, and residual income. Use when the user asks about discounted cash flow, DCF models, WACC, terminal value, dividend discount models, comparable multiples, or sum-of-the-parts valuation. Also trigger when users mention 'what is this stock worth', 'fair value estimate', 'Gordon growth model', 'free cash flow valuation', 'cost of equity', 'sensitivity analysis', 'exit multiple', or ask whether a stock is overvalued or undervalued.

Business & Finance787 installs

finance-psychology

joellewis/finance_skills

Recognize and mitigate cognitive biases that impair financial decisions, and coach clients toward values-driven financial lives. Use when the user asks about behavioral finance, money psychology, loss aversion, overconfidence, herd behavior, or emotional investing. Also trigger when users mention 'why do I panic sell', 'money fights with my spouse', 'I can never save enough', 'fear of investing', 'lifestyle creep', 'keeping up with the Joneses', 'Rich Life', 'money scripts', or ask how emotions affect financial decisions.

Business & Finance780 installs

commodities

joellewis/finance_skills

Analyze commodity markets including futures curve dynamics, roll yield, and supply/demand fundamentals. Use when the user asks about commodity investing, commodity ETFs, contango, backwardation, roll yield, commodity indices (GSCI, BCOM), or commodities as an inflation hedge. Also trigger when users mention 'oil prices', 'gold as a safe haven', 'agricultural futures', 'convenience yield', 'storage costs', 'natural gas', 'copper demand', or ask why commodity ETF returns differ from spot price changes.

Business & Finance774 installs

investment-policy

joellewis/finance_skills

Construct comprehensive Investment Policy Statements governing return objectives, risk tolerance, and portfolio constraints. Use when the user asks about building an IPS, setting return objectives, assessing risk tolerance, defining investment constraints, or establishing rebalancing and benchmark policies. Also trigger when users mention 'investment plan', 'policy portfolio', 'risk capacity vs willingness', 'spending rate for an endowment', 'foundation payout', 'manager selection criteria', or ask how to document their investment strategy.

Popular code quality & workflow skills

View category →

grill-me

mattpocock/skills

A relentless interview to sharpen a plan or design.

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

handoff

mattpocock/skills

Compact the current conversation into a handoff document for another agent to pick up.

domain-modeling

mattpocock/skills

Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.

codebase-design

mattpocock/skills

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

diagnosing-bugs

mattpocock/skills

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.