{"id":57788,"plugin_id":"plugin_asdk_app_6981ec32565481919b1c5a1627b1e330","kind":"skill","collection_source":"plugin_package","comparison_source":null,"observed_at":"2026-10-27T00:14:50.604Z","digest":"258db562ff1002fcf8de52a3d2cf1d35e6344a6f30524e3133c32aba95a431ea","against":null,"payload":{"description":"Find the right SKR account code for a bookkeeping category (German SME only; a Polish company picks from list_company_categories). Search the full SKR03/SKR04 chart of accounts by code or use AI to match by name or description. Use when an SME user needs help finding a category code, wants to add a new custom category, or asks \"what account number is X?\"","included_files":[],"name":"suggest-category","skill_md_contents":"---\nname: suggest-category\ndescription: Find the right SKR account code for a bookkeeping category (German SME only; a Polish company picks from list_company_categories). Search the full SKR03/SKR04 chart of accounts by code or use AI to match by name or description. Use when an SME user needs help finding a category code, wants to add a new custom category, or asks \"what account number is X?\"\nversion: 1.0.1\nmetadata:\n  openclaw:\n    emoji: \"\\U0001F50D\"\n    homepage: https://norman.finance\n    requires:\n      mcp:\n        - norman-finance\n---\n\nHelp the user find the correct SKR chart of accounts category.\n\n**IMPORTANT: German SME accounts only.** This skill applies to GmbH/UG companies that use DATEV standard chart of accounts (SKR03/SKR04). For freelance accounts, use `categorize_transaction` instead — it has its own category set and AI detection. A Polish company (`country: PL`) never uses the SKR tools: a JDG picks from its PL_KPIR chart, an sp. z o.o. from its PL_FULL chart, both with `list_company_categories`.\n\n## How to determine account type\n\nCall `get_company_details` and check the `isSme` field:\n- `isSme: true` and `country: DE` → Use this skill (SKR tools below)\n- `country: PL` → Use `list_company_categories` (PL_KPIR or PL_FULL), not this skill\n- `isSme: false` → Use `categorize_transaction` for freelance AI categorization\n\n## Workflow\n\n1. **Determine the search approach** based on what the user provides:\n   - If they provide an **account number or prefix** (digits like `42`, `4200`, `6300`), use `search_skr_by_code` for instant CSV-based results.\n   - If they describe a **category by name or purpose** (e.g. \"office rent\", \"Reisekosten\", \"software subscriptions\"), use `suggest_skr_category` which leverages OpenAI to semantically match against the full catalog.\n\n2. **Show results clearly**: Present the matches with:\n   - Account number (code)\n   - German name (`nameDe`)\n   - English name (`nameEn`)\n   - Let the user pick the best fit.\n\n3. **Check the company's existing categories**: Call `list_company_categories` to see if the desired category is already provisioned. If it is, inform the user — no need to create a new one.\n\n4. **Create the category if needed**: If the user wants to add it, use `create_company_category` with:\n   - The account code from the SKR catalog\n   - The name (use the language the user prefers)\n   - The cashflow type (INCOME or EXPENSE)\n   - Optional German name and description\n\n5. **Context**: The company's active chart of accounts (SKR03 or SKR04) determines which catalog is searched. You can check the current template via `get_company_details`.\n\n## Tool summary\n\n| Tool | For | What it does |\n|---|---|---|\n| `search_skr_by_code` | SME only | Fast CSV lookup by account number prefix |\n| `suggest_skr_category` | SME only | AI (OpenAI) semantic search by name/description |\n| `create_company_category` | SME only | Create a new custom DATEV category |\n| `list_company_categories` | SME only | List categories already provisioned for the company |\n| `categorize_transaction` | All accounts | AI detection for a specific transaction (freelance + SME) |\n\n## Tips\n\n- The full SKR catalog has ~1000+ entries — the tools handle search/filtering, don't try to list everything.\n- `search_skr_by_code` searches by account number or prefix; `suggest_skr_category` matches a free-text name or description.\n- `categorize_transaction` is a *different* tool — it classifies a specific transaction. The SKR tools here help find/create account codes for the company's category setup.\n- Common SKR04 ranges: 0xxx = assets, 1xxx = financial accounts, 2xxx = liabilities, 3xxx = income, 4xxx = material costs, 5xxx = depreciation, 6xxx = other expenses, 7xxx = extraordinary items.\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}