budget-financial-modeling

Generates driver-based OPEX and CAPEX budgets and rolling 12-month projections as structured JSON files.

1|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/tapway/shogun-os --skill budget-financial-modeling-tapway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: budget-financial-modeling
Source: https://github.com/tapway/shogun-os/tree/main/skills/finance/budget-financial-modeling
Command: npx skills add https://github.com/tapway/shogun-os --skill budget-financial-modeling-tapway

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Annual planning often relies on arbitrary percentage increases that hide structural cost changes and produce budgets that cannot be tracked consistently. This Skill builds bottom-up budgets anchored to real business drivers and stores them in a structured format that downstream variance analysis can consume. ## Core Features & Use Cases - Annual Budget Build: Pulls prior-year actuals via accounting tools and applies driver-based assumptions (headcount, revenue per seat, cost per unit) to produce a structured budget JSON. - Rolling 12-Month Projections: Re-forecasts remaining months using YTD actuals and run rates, saving timestamped projection files. - Use Case: During FY2027 planning, a finance manager provides +15% headcount and RM8K revenue-per-seat assumptions; the Skill produces finance/budget.json ready for the bva-variance-analysis skill to track actuals against. ## Quick Start Ask the finance-manager agent to build the FY2027 annual budget using last year's actuals and your driver assumptions for headcount and revenue per seat.

Frequently Asked Questions about budget-financial-modeling

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a driver-based annual budget from accounting actuals?

Pull prior-year actuals with acct_get_profit_loss, then apply driver assumptions such as headcount, revenue per seat, or cost per unit to each line. The result is a structured JSON budget with account_code, budget_amount, and driver per line.

How to update a rolling 12-month financial projection with latest actuals?

Fetch year-to-date actuals via acct_get_profit_loss, then re-forecast remaining months using the driver assumptions and YTD run rate. The updated projection is saved as a timestamped file under finance/projections/rolling-<YYYY-MM>.json.

What tools are required for budget financial modeling with this skill?

It requires the finance-manager profile, the acct_get_profit_loss and acct_get_balance_sheet MCP tools for actuals, and a gbrain finance source where budget.json and projection files are stored.

When should I not use driver-based budget modeling?

Do not use it for tracking actuals against an approved budget, which belongs to variance analysis, or for computing cash runway, which requires a dedicated cash forecasting approach. It is specifically for authoring budgets and projections.

Why does variance analysis fail after the budget file changes?

Variance analysis fails when the budget.json schema drifts from what the variance script expects, causing silent failures. Version the schema and document breaking changes whenever the budget structure is modified.