{"id":46810,"plugin_id":"plugin_asdk_app_6aa98aeb507c81918e2b55ebb7d1ddd0","kind":"skill","collection_source":"plugin_package","comparison_source":null,"observed_at":"2026-10-24T13:31:11.890Z","digest":"b41c1de7bb483bbf2165b136a1fdaafd997f049fc808d12318826a76dbd3c57d","against":null,"payload":{"description":"Use for ANY question or task about the user's Finanse budget — spending, income, categories, category budgets, balance, safe-to-spend, recurring payments, savings goals, searching transactions, or recording, editing and deleting expenses, incomes and shop receipts (PL: wydatki, przychody, budżet, saldo, paragon, płatność cykliczna, cel oszczędnościowy). Picks the right Finanse tool, batches calls and keeps every write behind the user's approval.","included_files":[],"name":"finanse","skill_md_contents":"---\nname: finanse\ndescription: Use for ANY question or task about the user's Finanse budget — spending, income, categories, category budgets, balance, safe-to-spend, recurring payments, savings goals, searching transactions, or recording, editing and deleting expenses, incomes and shop receipts (PL: wydatki, przychody, budżet, saldo, paragon, płatność cykliczna, cel oszczędnościowy). Picks the right Finanse tool, batches calls and keeps every write behind the user's approval.\n---\n\n# Finanse\n\nFinanse records money the user **already** spent or received. It never sends, pays, transfers or invests money, never connects to a bank and never asks for card details. Say \"record\", never \"pay\".\n\n## Cards vs. silent lookups\n\n`show_*` tools and every write render a card in the chat. Every other tool is a **silent lookup** — the user sees nothing.\n\n- **One card per reply.** Call a `show_*` tool only when the user asks to see that thing. Never call one to look something up.\n- **The card is the answer.** After a card, write at most one short sentence. Never re-list its rows, amounts, category, account or date, and never draw your own summary card, table or bullet list of it.\n- **No card before a write.** Adding one expense renders exactly one card: the saved transaction.\n\n## Pick the tool\n\n| User asks | Tool | Card |\n|---|---|---|\n| Which budgets/projects do I have, switch project | `list_projects` | — |\n| Account ids, the default account, today's date | `list_accounts` | — |\n| Category ids (before any write) | `list_categories` | — |\n| Rows as data — recategorise, ids to edit/delete, duplicates, counts, merchant totals | `find_transactions` | — |\n| Numbers to reason with — totals, category split, budget use, month vs month | `get_monthly_stats` | — |\n| Show my accounts / balances | `show_project_overview` | ✅ |\n| Show where the money went in a month | `show_monthly_summary` | ✅ |\n| Show every transaction in a month | `show_transactions` | ✅ |\n| Show transactions matching a note (\"paliwo\", \"Netflix\") | `show_search_results` | ✅ |\n| Show how my balance moved | `show_balance_history` | ✅ |\n| Show my budgets | `show_budget_status` | ✅ |\n| How much can I still spend | `show_safe_to_spend` | ✅ |\n| What payments are coming | `show_upcoming_transactions` | ✅ |\n| What repeats / what could be automated | `show_recurring_suggestions` | ✅ |\n| Record one expense or income | `list_categories` (+ `list_accounts` if an account is named) → `create_transaction` | ✅ saved |\n| Record several | `list_categories` → `create_transactions` | ✅ saved |\n| A shop receipt / paragon / photo of a bill | `list_categories` → `create_receipt_expenses` (never `create_transaction(s)`) | ✅ review |\n| Set up a recurring payment | `list_categories` → `create_recurring_transaction` | — |\n| Change one / many transactions | `find_transactions` → `update_transaction` / `bulk_update_transactions` | ✅ preview |\n| Delete transactions | `find_transactions` → `delete_transaction` | ✅ preview |\n| Savings goals, contributions, \"when will I reach X\" | `get_savings_goals`, `allocate_funds`, `simulate_savings_timeline` | — |\n\n## Rules\n\n1. **Project** — omit `projectId` unless the user names another budget; then resolve it with `list_projects`.\n2. **Categories before writes** — call `list_categories` first and use a real category. Expense vs income follows the category, never the sign of the amount. No fitting category → ask which one; never invent it.\n3. **One call per batch** — tools taking `periods`, `queries`, `transactionIds`, `updates` or `items` get the whole batch in one call. Never loop month by month or item by item.\n4. **Two-step writes** — `update_transaction`, `bulk_update_transactions`, `delete_transaction` and `create_receipt_expenses` first return a preview card with buttons. Ask for approval in one sentence; if the user approves in chat, repeat the call with the returned `confirmationToken`. Never confirm on the user's behalf.\n5. **Dates are wall clock** — `2026-09-17T17:20` as the user reads it, never a `Z` instant. Resolve \"yesterday\" against `today` from `list_categories` or `list_accounts`. A receipt's `purchasedAt` needs the time printed on it.\n6. **Many rows never go to a card** — \"move every Netflix from the last 6 months to Subscriptions\" is `find_transactions` → `bulk_update_transactions`; the only card is the preview. `show_transactions` hands you counts, not rows.\n7. **Refusals are final** — no project, no subscription or a `restricted` role: relay the tool's message plainly. Never link to checkout or mention prices.\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}