financial-forecaster

Predicts future balance and simulates purchase impact on finances. Use when user asks about: balance prediction, financial forecast, what-if scenarios, can I afford, impact of purchase. Triggers: 余额预测, 财务预测, 下个月还剩多少, 如果买X, 能不能买, 买得起吗.

⭐21stars🔀6forks📁View on GitHub🕐Updated Jan 7, 2026⬇️2downloads

When & Why to Use This Skill

The Financial Forecaster is a predictive analytics skill designed to project future account balances and simulate the financial impact of specific spending decisions. By integrating upcoming bills and income data, it provides users with actionable insights into their cash flow health, helping them determine affordability and avoid potential low-balance situations through data-driven forecasting.

Use Cases

  • Monthly Cash Flow Projection: Predict your end-of-month balance by accounting for recurring bills, income, and daily spending patterns.
  • Purchase Impact Simulation: Visualize how a significant expense, such as a new electronic device or a vacation, will affect your financial trajectory over the next 30 to 90 days.
  • Affordability Analysis: Receive clear 'can I afford this' recommendations based on real-time simulations of your future financial state.
  • Proactive Risk Management: Identify upcoming periods of low liquidity and receive warnings about potential budget shortfalls before they occur.
namefinancial-forecaster
description>
Use when user asks aboutbalance prediction, financial forecast, what-if scenarios,
Triggers余额预测, 财务预测, 下个月还剩多少, 如果买X, 能不能买, 买得起吗.
licenseApache-2.0
typepredictive
version"1.0"
allowed-toolsexecute read_file ls

Skill: Financial Forecaster

You are a financial forecasting analyst. Your job is to predict future finances.

Use Cases

  • "下个月还能剩多少" → Forecast end-of-month balance
  • "如果买这个手机会怎样" → Simulate purchase impact
  • "能买得起X吗" → Evaluate affordability

Available Script

forecast_balance.py - Balance Prediction

uv run python app/skills/financial-forecaster/scripts/forecast_balance.py --days 30

Parameters:

  • --days: Forecast period (default: 30)
  • --simulate-purchase: Enable purchase simulation
  • --amount: Purchase amount
  • --description: Purchase description

Output:

  • forecast: Daily balance predictions
  • warnings: Low balance alerts
  • recurring_events: Upcoming bills/income

Workflow

1. Balance Forecast

uv run python app/skills/financial-forecaster/scripts/forecast_balance.py --days 30

Present CashFlowForecastChart and summarize warnings.

2. Purchase Simulation

uv run python app/skills/financial-forecaster/scripts/forecast_balance.py --simulate-purchase --amount 5000 --description "iPhone"

Show impact on forecast and advise on affordability.

Rules

  • Focus on FUTURE: This skill answers "what will happen?"
  • Warnings First: Highlight low balance periods
  • Clear Recommendations: Tell user if purchase is affordable
  • No History Analysis: Do NOT analyze past spending (that's spending-analyzer's job)