Update to SankeyArt

{
  "description": "Draws Sankey diagrams of income statements, cash flow statements, balance sheets and budgets with SankeyArt. Use when the user wants to see, draw or visualize financial figures as a Sankey or flow diagram, e.g. where revenue goes, how cash moves or how a budget splits, or change such a diagram.",
  "included_files": [],
  "name": "financial-statement-sankey",
  "skill_md_contents": "---\r\nname: financial-statement-sankey\r\ndescription: Draws Sankey diagrams of income statements, cash flow statements, balance sheets and budgets with SankeyArt. Use when the user wants to see, draw or visualize financial figures as a Sankey or flow diagram, e.g. where revenue goes, how cash moves or how a budget splits, or change such a diagram.\r\n---\r\n\r\n# Financial statement Sankey diagrams\r\n\r\nSankeyArt draws a diagram from flows: each flow goes from a `source` to a `target` with a positive `amount`. Every node in the middle of the diagram must take in as much as it passes on.\r\n\r\n## Choose the tool\r\n\r\n1. The user gives figures, in the chat or in a file: call `draft_sankey` with the complete diagram. Use only the figures the user gave or that are in their files. If a figure the diagram needs is missing, ask for it instead of estimating it.\r\n2. The user asks for a company's statement without giving figures: ask them for the figures or a file with them. Don't draw a company's figures from memory.\r\n3. When `draft_sankey` says that the user's SankeyArt account keeps their diagrams, save the diagram with `create_sankey` and its `draft_id` right away, before replying. From then on, draw new diagrams with `create_sankey` and change saved ones with `update_sankey`.\r\n4. To change a drawn diagram that isn't saved, call `draft_sankey` again with the complete updated diagram.\r\n5. `list_my_sankeys` lists the diagrams saved in the user's account and `get_sankey` opens one of them. Don't add images to such a list: a picture found elsewhere would show another diagram.\r\n\r\nAlways give the user the editor link that the tools return.\r\n\r\n## Lay out the flows\r\n\r\nList the flows from top to bottom, because the nodes of a column are stacked in the order in which they first appear: profits before costs, and the flows out of a node after those out of the nodes above it.\r\n\r\n**Income statement**\r\n\r\n- Revenue sources or segments → Revenue (only when the user gives a breakdown)\r\n- Revenue → Gross profit, Revenue → Cost of revenue\r\n- Gross profit → Operating profit, Gross profit → each operating expense (R&D, SG&A, ...)\r\n- Operating profit → Profit before tax, Operating profit → interest and other expenses\r\n- Other income → Profit before tax\r\n- Profit before tax → Net income, Profit before tax → Income tax\r\n\r\n**Cash flow statement**\r\n\r\n- Operating, investing and financing inflows → Cash in\r\n- Cash in → each outflow\r\n- If cash went up: Cash in → Net increase in cash, for what is left. If it went down: Net decrease in cash → Cash in, with the decrease as a positive amount. If it didn't change, leave this flow out.\r\n\r\n**Balance sheet**\r\n\r\n- Each asset → Total assets\r\n- Total assets → Liabilities and Equity, then each of those → its items\r\n\r\n**Budget**\r\n\r\n- Income sources → Total budget\r\n- Total budget → each spending category\r\n- If the income is more than the spending: Total budget → Savings, for what is left. If it is less: Budget deficit → Total budget, for the shortfall.\r\n\r\nA loss can't be a negative amount. If there is an operating loss, it flows into Gross profit to cover the operating expenses, and the diagram ends there, without the items below the operating result.\r\n\r\n## Fill in the details\r\n\r\n- `company_name`, `fiscal_year`, `reporting_period` (`full_year`, `Q1`–`Q4`, `H1`, `H2` or a month) and `statement_type` (`income`, `cashflow`, `balance`, `budget` or `other`).\r\n- Units: `settings.unit_prefix` (e.g. `$` or `€`) and `settings.unit_suffix` (e.g. `M` or `B`). Keep the amounts in the unit the user gave.\r\n- A comparison with another period: `amount_comparison` on each flow.\r\n- Colors and labels: `nodes`, by node name. Leave colors out unless the user asks for them: SankeyArt colors profits, costs and revenue by their names.\r\n\r\nBefore calling a tool, check that every middle node takes in as much as it passes on and that the final figures match the user's statement.\r\n\r\nDon't give investment or financial advice. Describe what the figures show, not what the user should do with them.\r\n"
}