
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- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads liquidity-management automatically when relevant.
- 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:
| 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.
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
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.
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.
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.
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.
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.
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
grill-me
mattpocock/skills
A relentless interview to sharpen a plan or design.
improve-codebase-architecture
mattpocock/skills
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.