# Skills reference

Skills are Markdown instructions an agent loads **before** calling the tools: when to call which tool, how to build its input, and when **not** to calculate at all. The tools say *what* can be done; the skills say *how to do it correctly*.

- Source: [github.com/salaxy-payroll/salaxy-ai-for-payroll](https://github.com/salaxy-payroll/salaxy-ai-for-payroll) · root router `skills/SKILL.md` — **the repository opens publicly soon**; until then the links below need access
- Content language: **Finnish for now, moving to English**. Identifiers, field names and enum values are already English, as in the API.
- Country: **Finland**. Each country gets its own skill set — Finnish wage types and law do not carry over.

| Area | Status | Tools | Evals |
|---|---|---|---|
| [Payroll process](#payroll-process) | [Knowledge only] | — | 2 / 2 pass |
| [Calculations](#calculations) | [Live] | `calculation_preview`, `calculation_create`, `calculation_set_rows`, `calculation_update`, `calculation_get_summary`, `calculation_show_slip`, `calculation_copy`, `calculation_search`, `row_type_list` | 35 / 37 pass |
| [Employments](#employments) | [Live] | `employment_search`, `employment_get_summary`, `employment_create`, `employment_update`, `employment_set_rows` | 3 / 3 pass |
| [Payrolls](#payrolls) | [Live] | `payroll_create`, `payroll_copy`, `payroll_set_employments`, `payroll_set_rows`, `payroll_update`, `payroll_remove_calculation`, `payroll_get_summary`, `payroll_show_slips`, `payroll_search` | 1 / 1 pass |
| [Invoices](#invoices) | [Live] | `invoice_search`, `invoice_get_summary`, `invoice_preview`, `invoice_confirm` | 1 / 1 pass |
| [Reports](#reports) | [Live] | `salary_slip`, `salary_slip_pdf`, `summary_report`, `salary_summary`, `accounting_report`, `holiday_pay_debt`, `ir_reports`, `ir_report` | 0 / 2 pass |
| [Company settings](#settings) | [Coming soon] | — | 0 / 1 pass |
| [Absences](#absences) | [Live] | `absence_search`, `absence_get_summary`, `absence_set_periods` | 1 / 1 pass |
| [Holidays](#holidays) | [Live] | `holiday_spec_get_summary`, `holiday_spec_update`, `holiday_year_create`, `holiday_year_search`, `holiday_year_get_summary`, `holiday_year_set_accruals`, `holiday_year_set_leaves`, `holiday_year_update`, `holiday_year_recalculate` | 1 / 1 pass |

## Payroll process

[Knowledge only]

The whole flow: how payrolls, calculations and invoices relate and in what order they proceed, which skill handles which step, how settings are inherited, where accounting data and reports come from, and what Salaxy's terms mean. Builds nothing.

- Skill: [`skills/fi/payroll-process/SKILL.md`](https://github.com/salaxy-payroll/salaxy-ai-for-payroll/blob/feature/multi-country/skills/fi/payroll-process/SKILL.md)
- Tools: none
- Reference files: 4
- Eval cases: [2](https://code.salaxy.com/reference/verified.md#payroll-process)

**Skill description as the agent sees it (Finnish)**

> Palkanmaksun kokonaisprosessi Salaxyssä: miten palkkalista, palkkalaskelma ja laskut liittyvät toisiinsa, missä järjestyksessä ne etenevät ja mikä skilli mitäkin vaihetta hoitaa. Käytä tätä, kun kysymys koskee prosessia tai kokonaisuutta eikä yhden laskelman rakentamista. Triggeröi sanoista: palkanmaksuprosessi, mitä tapahtuu seuraavaksi, missä tilassa, miksi laskelmaa ei voi muuttaa, miten palkka päätyy maksuun, asetusten periytyminen, mistä laskelman tiedot tulevat, työntekijä vs. työsuhde, missä järjestyksessä asiat perustetaan, kirjanpitoaineisto ja raportit, Salaxyn termien merkitykset.

## Calculations

[Live]

Create or change a salary calculation: employment, pay period, salary date and wage-type rows, with a catalogue of Finnish wage types and Incomes Register income types.

- Skill: [`skills/fi/calculations/SKILL.md`](https://github.com/salaxy-payroll/salaxy-ai-for-payroll/blob/feature/multi-country/skills/fi/calculations/SKILL.md)
- Tools: [`calculation_preview`](https://code.salaxy.com/reference/mcp.md#calculation_preview) [Live], [`calculation_create`](https://code.salaxy.com/reference/mcp.md#calculation_create) [Live], [`calculation_set_rows`](https://code.salaxy.com/reference/mcp.md#calculation_set_rows) [Live], [`calculation_update`](https://code.salaxy.com/reference/mcp.md#calculation_update) [Live], [`calculation_get_summary`](https://code.salaxy.com/reference/mcp.md#calculation_get_summary) [Live], [`calculation_show_slip`](https://code.salaxy.com/reference/mcp.md#calculation_show_slip) [Live], [`calculation_copy`](https://code.salaxy.com/reference/mcp.md#calculation_copy) [Live], [`calculation_search`](https://code.salaxy.com/reference/mcp.md#calculation_search) [Live], [`row_type_list`](https://code.salaxy.com/reference/mcp.md#row_type_list) [Live]
- Reference files: 72
- Eval cases: [37](https://code.salaxy.com/reference/verified.md#calculations)

**Skill description as the agent sees it (Finnish)**

> Palkkalaskelman luonti tai muuttaminen: työsuhde, palkkakausi, palkkapäivä ja palkkalajirivit. Käytä tätä skilliä, kun haluat luoda palkkalaskelman tai muuttaa palkkalaskelmaa. Triggeröi sanoista: palkkalaskelman luonti, palkkalaskelman muuttaminen, palkkalaskelman rivit, palkkalajit, tulolajit, palkkakausi, palkkapäivä.

## Employments

[Live]

Create, find, change and end employments — the relation that carries the payroll terms: pay type, pension type, tax card type and default rows. There is no calculation without one.

- Skill: [`skills/fi/employments/SKILL.md`](https://github.com/salaxy-payroll/salaxy-ai-for-payroll/blob/feature/multi-country/skills/fi/employments/SKILL.md)
- Tools: [`employment_search`](https://code.salaxy.com/reference/mcp.md#employment_search) [Live], [`employment_get_summary`](https://code.salaxy.com/reference/mcp.md#employment_get_summary) [Live], [`employment_create`](https://code.salaxy.com/reference/mcp.md#employment_create) [Live], [`employment_update`](https://code.salaxy.com/reference/mcp.md#employment_update) [Live], [`employment_set_rows`](https://code.salaxy.com/reference/mcp.md#employment_set_rows) [Live]
- Reference files: 4
- Eval cases: [3](https://code.salaxy.com/reference/verified.md#employments)

**Skill description as the agent sees it (Finnish)**

> Työsuhteen luonti, muuttaminen, hakeminen ja päättäminen Salaxyn rajapinnassa. Työsuhde on se, joka kantaa palkanlaskennan ehdot — palkkausmuodon, eläkelajin, verokortin tyypin ja oletuspalkkarivit — ja ilman sitä ei voi tehdä laskelmaa. Triggeröi sanoista: työsuhteen luonti, työntekijän lisääminen, työsuhteen muuttaminen, työsuhteen päättäminen, työntekijän tietojen haku.

## Payrolls

[Live]

A payroll bundles one calculation per employee and is what goes to payment: statuses, conditions for payment, partial payment, invoices created from a payroll, and recurring payrolls. Calculation rows are in Calculations.

- Skill: [`skills/fi/payrolls/SKILL.md`](https://github.com/salaxy-payroll/salaxy-ai-for-payroll/blob/feature/multi-country/skills/fi/payrolls/SKILL.md)
- Tools: [`payroll_create`](https://code.salaxy.com/reference/mcp.md#payroll_create) [Live], [`payroll_copy`](https://code.salaxy.com/reference/mcp.md#payroll_copy) [Live], [`payroll_set_employments`](https://code.salaxy.com/reference/mcp.md#payroll_set_employments) [Live], [`payroll_set_rows`](https://code.salaxy.com/reference/mcp.md#payroll_set_rows) [Live], [`payroll_update`](https://code.salaxy.com/reference/mcp.md#payroll_update) [Live], [`payroll_remove_calculation`](https://code.salaxy.com/reference/mcp.md#payroll_remove_calculation) [Live], [`payroll_get_summary`](https://code.salaxy.com/reference/mcp.md#payroll_get_summary) [Live], [`payroll_show_slips`](https://code.salaxy.com/reference/mcp.md#payroll_show_slips) [Live], [`payroll_search`](https://code.salaxy.com/reference/mcp.md#payroll_search) [Live]
- Eval cases: [1](https://code.salaxy.com/reference/verified.md#payrolls)

**Skill description as the agent sees it (Finnish)**

> Palkkalista: laskelmien nippu ja sen vieminen maksuun. Tilat, maksuun viemisen ehdot ja osittainen maksuun vienti. **Ei laskelman rivejä** — ne ovat calculations-skilissä. Triggeröi sanoista: palkkalista, palkka-ajo, maksuun vienti, laskujen luonti palkkalistalta, toistuva palkkalista.

## Invoices

[Live]

For partners who pay through their own channel: fetch invoices, report their status back and build SEPA payment files. Paying is two-step — preview, a person approves, confirm — and a confirmation is never invented. The process and the meaning of the statuses are in Payroll process.

- Skill: [`skills/fi/invoices/SKILL.md`](https://github.com/salaxy-payroll/salaxy-ai-for-payroll/blob/feature/multi-country/skills/fi/invoices/SKILL.md)
- Tools: [`invoice_search`](https://code.salaxy.com/reference/mcp.md#invoice_search) [Live], [`invoice_get_summary`](https://code.salaxy.com/reference/mcp.md#invoice_get_summary) [Live], [`invoice_preview`](https://code.salaxy.com/reference/mcp.md#invoice_preview) [Live], [`invoice_confirm`](https://code.salaxy.com/reference/mcp.md#invoice_confirm) [Live]
- Eval cases: [1](https://code.salaxy.com/reference/verified.md#invoices)

**Skill description as the agent sees it (Finnish)**

> Laskujen hakeminen maksukanavalta, niiden tilan päivittäminen takaisin ja SEPA-maksuaineiston muodostaminen. Kumppanikehittäjän rajapintaohje — **prosessin kulku ja tilojen merkitys ovat payroll-process-skilissä**. Triggeröi sanoista: laskun haku, laskujen listaus, laskun tilan päivitys, maksuaineisto, SEPA, erätunniste.

## Reports

[Live]

Turn a calculation into a readable document — exactly three types: salary slip, e-payslip material (XML) and the employer report. Only Finnish works.

- Skill: [`skills/fi/reports/SKILL.md`](https://github.com/salaxy-payroll/salaxy-ai-for-payroll/blob/feature/multi-country/skills/fi/reports/SKILL.md)
- Tools: [`salary_slip`](https://code.salaxy.com/reference/mcp.md#salary_slip) [Live], [`salary_slip_pdf`](https://code.salaxy.com/reference/mcp.md#salary_slip_pdf) [Live], [`summary_report`](https://code.salaxy.com/reference/mcp.md#summary_report) [Live], [`salary_summary`](https://code.salaxy.com/reference/mcp.md#salary_summary) [Live], [`accounting_report`](https://code.salaxy.com/reference/mcp.md#accounting_report) [Live], [`holiday_pay_debt`](https://code.salaxy.com/reference/mcp.md#holiday_pay_debt) [Live], [`ir_reports`](https://code.salaxy.com/reference/mcp.md#ir_reports) [Live], [`ir_report`](https://code.salaxy.com/reference/mcp.md#ir_report) [Live]
- Eval cases: [2](https://code.salaxy.com/reference/verified.md#reports)

**Skill description as the agent sees it (Finnish)**

> Laskelman muuttaminen luettavaksi dokumentiksi: palkkalaskelma, verkkopalkka- aineisto ja työnantajan raportti. Käytä tätä skilliä, kun käyttäjä haluaa nähdä tai lähettää valmiin laskelman tulosteena eikä pelkkiä lukuja. Triggeröi sanoista: palkkalaskelma, palkkakuitti, tuloste, raportti, verkkopalkka, työnantajan raportti, näytä laskelma.

## Company settings

[Coming soon]

Company settings: bank account and SEPA id, pension contracts, cost-centre dimensions and language. Saving replaces the whole object — a partial save wipes the other sections.

> The tools come with the Configuration Agent server.

- Skill: [`skills/fi/settings/SKILL.md`](https://github.com/salaxy-payroll/salaxy-ai-for-payroll/blob/feature/multi-country/skills/fi/settings/SKILL.md)
- Tools: none
- Eval cases: [1](https://code.salaxy.com/reference/verified.md#settings)

**Skill description as the agent sees it (Finnish)**

> Yrityksen asetukset Salaxyn rajapinnassa: pankkitili ja SEPA-tunnus, eläkesopimukset, kustannuspaikkaulottuvuudet ja kieli. Ennen kaikkea se, että asetusten tallennus **korvaa koko objektin** eikä yhdistä — osittainen lähetys pyyhkii muut osiot. Käytä tätä, kun kysymys koskee yrityksen asetuksia. Triggeröi sanoista: asetusten muuttaminen, pankkitili, IBAN, SEPA-tunnus, eläkesopimus, eläkevakuutusyhtiö, vakuutussopimus, kustannuspaikka, dimensio, yrityksen kieli.

## Absences

[Live]

The absence calendar stored on an employment: absence periods and their fields, absence reports, lay-off notices, and how absences relate to the calculation. Absence rows themselves are in Calculations.

- Skill: [`skills/fi/absences/SKILL.md`](https://github.com/salaxy-payroll/salaxy-ai-for-payroll/blob/feature/multi-country/skills/fi/absences/SKILL.md)
- Tools: [`absence_search`](https://code.salaxy.com/reference/mcp.md#absence_search) [Live], [`absence_get_summary`](https://code.salaxy.com/reference/mcp.md#absence_get_summary) [Live], [`absence_set_periods`](https://code.salaxy.com/reference/mcp.md#absence_set_periods) [Live]
- Eval cases: [1](https://code.salaxy.com/reference/verified.md#absences)

**Skill description as the agent sees it (Finnish)**

> Poissaolokalenteri: työsuhteelle tallennetut poissaolojaksot, niiden kentät ja suhde palkkalaskelmaan. **Ei poissaoloriviä laskelmalle** — se on calculations-skilissä. Triggeröi sanoista: poissaolokalenteri, poissaolojakso, poissaolojen kirjaaminen, poissaoloraportti, lomautusilmoitus.

## Holidays

[Live]

Holiday accounting: accrual, entitlement, holiday calculation settings, and exceptions such as falling ill during a holiday or saved leave. Holiday pay rows themselves are in Calculations.

- Skill: [`skills/fi/holidays/SKILL.md`](https://github.com/salaxy-payroll/salaxy-ai-for-payroll/blob/feature/multi-country/skills/fi/holidays/SKILL.md)
- Tools: [`holiday_spec_get_summary`](https://code.salaxy.com/reference/mcp.md#holiday_spec_get_summary) [Live], [`holiday_spec_update`](https://code.salaxy.com/reference/mcp.md#holiday_spec_update) [Live], [`holiday_year_create`](https://code.salaxy.com/reference/mcp.md#holiday_year_create) [Live], [`holiday_year_search`](https://code.salaxy.com/reference/mcp.md#holiday_year_search) [Live], [`holiday_year_get_summary`](https://code.salaxy.com/reference/mcp.md#holiday_year_get_summary) [Live], [`holiday_year_set_accruals`](https://code.salaxy.com/reference/mcp.md#holiday_year_set_accruals) [Live], [`holiday_year_set_leaves`](https://code.salaxy.com/reference/mcp.md#holiday_year_set_leaves) [Live], [`holiday_year_update`](https://code.salaxy.com/reference/mcp.md#holiday_year_update) [Live], [`holiday_year_recalculate`](https://code.salaxy.com/reference/mcp.md#holiday_year_recalculate) [Live]
- Eval cases: [1](https://code.salaxy.com/reference/verified.md#holidays)

**Skill description as the agent sees it (Finnish)**

> Lomakirjanpito: lomaoikeuden kertyminen, lomalaskennan asetukset ja se, mitä lomalle tapahtuu poikkeustilanteissa. **Ei loma-ajan palkan riviä** — rivit ovat calculations-skilissä. Triggeröi sanoista: lomakertymä, lomaoikeus, lomanmääräytymisvuosi, lomakausi, lomalaskennan asetukset, säästövapaa, sairastuminen lomalla.
