monthly-board-report

Generates monthly financial performance board reports with P&L, balance sheet ratios, and BvA variance analysis.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Compiling a monthly board-ready financial report requires pulling P&L, balance sheet, budget, and invoice data from accounting systems, computing ratios and variances, and formatting everything into a consistent executive pack — a repetitive, error-prone manual process. ## Core Features & Use Cases - Five-Step Data Gathering: Executes a defined sequence of acct_* tool calls (P&L, balance sheet, prior-month P&L, BvA via variance.py, customer invoices) to assemble all report inputs. - Formatted Board Report: Produces a standardized report with executive KPI scorecard, P&L breakdown, balance sheet health ratios, BvA variance analysis, and customer concentration risk, delivered to Slack/Telegram and archived to gbrain. - Graceful Degradation: Omits the BvA section when finance/budget.json is missing and falls back to manual generation when the script is unavailable. - Use Case: A finance manager asks for the August 2026 board report; the skill gathers the data, flags any budget lines over 10% variance, checks whether the top client exceeds the 20% concentration threshold, and posts the formatted report to the board channel. ## Quick Start Ask the finance-manager agent to generate the monthly financial performance report for a specific month and year, or invoke the /monthly-board-report slash command.

Frequently Asked Questions about monthly-board-report

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

FAQPage Schema
How do I generate a monthly board financial report automatically?

Invoke the /monthly-board-report slash command on the finance-manager profile or ask for the monthly financial performance report for a given month. The skill runs a five-step acct_* data-gathering sequence, formats the board template, saves it to gbrain, and delivers it to Slack or Telegram.

What data sources are needed for monthly financial reporting?

The report requires acct_get_profit_loss, acct_get_balance_sheet, acct_list_contacts, and acct_list_sales_invoices MCP tools connected to your accounting system. A finance/budget.json file in the gbrain finance source is optional and only needed for the BvA variance section.

What happens if the budget file is missing during BvA analysis?

The report degrades gracefully: if finance/budget.json is absent, the BvA section is replaced with an unavailability notice and the remaining four sections render normally. The script does not crash or raise an unhandled exception.

Can I generate a board report mid-month before month-end?

Yes, mid-month reports use month-to-date dates from month start through today instead of the full prior month range. The output is explicitly labeled as MTD as of the generation date to avoid confusion with completed-month reports.

Why does the board report show N/A for year-over-year growth?

YoY growth requires prior-year actuals in the accounting system. On newly deployed systems that data does not exist, so the report outputs N/A rather than fabricating a comparison.

When should I use the weekly pulse report instead of the monthly board report?

Use the weekly-pulse-report skill for short weekly operational summaries. The monthly board report is for formal monthly packs with full P&L breakdown, balance sheet ratios, BvA variance, and concentration risk intended for boards or investors.