Update to Simply Family Budget

{
  "description": "Set up Simply Family Budget after installation or when a user asks to get started, by checking existing data and guiding them through one real wallet and one real transaction.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 251
    }
  ],
  "name": "sfb-get-started",
  "skill_md_contents": "---\nname: sfb-get-started\ndescription: Set up Simply Family Budget after installation or when a user asks to get started, by checking existing data and guiding them through one real wallet and one real transaction.\n---\n\nUse this skill for the Simply Family Budget setup/onboarding flow.\n\nThe goal is to get the user to one useful, real result with as little setup friction as possible. Do not give a feature tour and do not ask the user to configure their whole budget.\n\n## Start by checking the account\n\n1. Call `get_household_overview` to learn the family's currency and timezone.\n2. Call `list_wallets` for active wallets.\n\nIf active wallets already exist:\n- Do not create a duplicate wallet.\n- Briefly confirm that Simply Family Budget is connected and ready.\n- If the user is clearly already active, do not restart onboarding.\n- Offer one immediate next action, preferably adding a recent transaction or reviewing upcoming bills and projected balance.\n- Keep the response short.\n\nIf there are no active wallets, continue with the new-user flow below.\n\n## New-user flow\n\nExplain this once, in one short sentence:\n\n\"Simply Family Budget doesn't connect to your bank or import transactions automatically — you stay in control by adding them here or in the app.\"\n\nThen guide the user one question at a time.\n\n### 1. Choose the first wallet\n\nAsk which account they use most often:\n- chequing\n- credit card\n- savings\n- cash\n- other\n\nThen ask what they want to call it.\n\nThen ask for its current balance.\n\nFor a credit card, distinguish the current balance from available credit or credit limit. If the user's wording could map to more than one balance value, clarify before writing. Do not ask for a credit limit during onboarding unless the user volunteers it or the tool requires it.\n\nOnce the required values are known, call `create_wallet`.\n\nDo not invent a wallet name, balance, type, credit limit, or any other financial value.\n\n### 2. Add one real transaction\n\nAfter the wallet is created, say that the basic account is ready and ask for one recent real purchase.\n\nA compact prompt is enough, for example:\n\"Tell me one recent purchase — amount, merchant or note, and the date. For example: $34 at IGA today.\"\n\nFor an expense:\n1. Use `list_categories` with `type=expense` to resolve an appropriate existing category.\n2. Prefer an obvious matching existing category when the user's wording makes the category clear.\n3. If more than one category is plausible, ask the user to choose.\n4. If no suitable category exists, ask whether they want to create one before calling `create_category`.\n5. Use the wallet ID returned by discovery/creation; never invent IDs.\n6. Call `create_transaction`.\n\nWhen the user gives only a date and not a time, do not burden them with a time question. Use a reasonable local time on that date in the family's timezone so the intended local date is preserved.\n\nNever invent an amount, merchant, date, category, or transaction.\n\n### 3. Finish after the first success\n\nAfter the first transaction is created, confirm that setup is complete. Keep the closing message short and give no more than three concrete examples of what they can do next:\n\n- \"Add $18 at Tim Hortons from Visa.\"\n- \"Show our upcoming bills and tell me if the balance looks safe.\"\n- \"How much did we spend on groceries this month?\"\n\nDo not continue into budgets, recurrences, tags, or full household configuration unless the user asks.\n\n## Important boundaries\n\n- Never imply that Simply Family Budget connects to a bank, imports bank transactions automatically, or moves real money.\n- Never create demo or fake financial records during onboarding.\n- Never overwrite or delete existing data as part of setup.\n- If the user already has wallets, do not repeat the first-wallet flow.\n- Ask for clarification before a write when the user's financial intent is ambiguous.\n- Follow host confirmation requirements for write tools.\n- If authentication is missing or expired, explain that the user needs to reconnect Simply Family Budget, then stop the write flow.\n"
}