run-workflow
/run-workflow
Run a Norman workflow (month-end close, monthly reconciliation, VAT-return readiness, invoice to payment, client document requests) on Norman's servers, answer the questions it asks, and schedule it to run by itself. Use when the user asks Norman to close a month, reconcile the bank, get ready for the VAT return, or "do it every month".
- Author
- norman-finance ↗
- Repository
- norman-mcp-server ↗
- Licence
- MIT
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 1
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Run a Norman workflow (month-end close, monthly reconciliation, VAT-return readiness, invoice to payment, client document requests) on Norman's servers, answer the questions it asks, and schedule it to run by itself. Use when the user asks Norman to close a month, reconcile the bank, get ready for the VAT return, or "do it every month".
Triggers from the description
Arguments
/run-workflow [workflow, e.g. 'close August' or 'VAT return']
Original author description
Run a Norman workflow (month-end close, monthly reconciliation, VAT-return readiness, invoice to payment, client document requests) on Norman's servers, answer the questions it asks, and schedule it to run by itself. Use when the user asks Norman to close a month, reconcile the bank, get ready for the VAT return, or "do it every month".
How it works
- Step 1: Pick the workflow
- Step 2: Start it
- Step 3: Follow the run
- Step 4: Report and offer the schedule
SKILL.md preview
---
name: run-workflow
description: Run a Norman workflow (month-end close, monthly reconciliation, VAT-return readiness, invoice to payment, client document requests) on Norman's servers, answer the questions it asks, and schedule it to run by itself. Use when the user asks Norman to close a month, reconcile the bank, get ready for the VAT return, or "do it every month".
version: 1.0.1
argument-hint: "[workflow, e.g. 'close August' or 'VAT return']"
metadata:
openclaw:
emoji: "\U0001F501"
homepage: https://norman.finance
requires:
mcp:
- norman-finance
---
Norman runs its workflows on its own servers. You start one, relay the user's answers, and report the result. You do not do the steps yourself.
## Step 1: Pick the workflow
- Call `list_workflows`. Match `$ARGUMENTS` or the user's words to a workflow key:
- "close the month" → `month-end-close`
- "reconcile" → `monthly-reconciliation`
- "VAT return", the German "UStVA", the Polish "JPK_V7" → `vat-readiness`
- If a run of that workflow is already active, continue with it (Step 3) instead of starting another.
- Tell the user which steps it will take (the `steps` of the workflow) and for which period (`defaultScope`, or the month they named).
## Step 2: Start it
- Call `start_workflow` with the key. Pass `period_start`/`period_end` only if the user named a different period.
- Say that Norman is now working on it and will stop only if it needs them.
## Step 3: Follow the run
- Call `get_workflow_run` when the user asks how it is going. Do not poll in a loop.
- Act on `blockedReason`:
- `user_input`: show the question from `blockedDetail`. Send the user's own answer with `answer_workflow_question`. Never answer on their behalf.
- `manual_step`: explain the step's instruction. Once the user did it, or wants to skip it, call `complete_workflow_step`.
- `source_required`: ask them to connect the bank or source in Norman, then `continue_workflow`.
- `step_failed`: say what stopped it (from `blockedDetail`). Offer `continue_workflow` to try again.
- `ai_limit` or `chat_limit_reached`: this month's AI messages are used up. The workflow can continue when the messages renew next month.
## Step 4: Report and offer the schedule
- When `state` is `done` or `done_with_warnings`, summarize each step's `summary` in plain words.
- If the workflow has no `schedule`, offer to run it by itself: month-end close on day 3, reconciliation on day 5, VAT readiness 5 days before the deadline (`before_vat_deadline` follows the German UStVA only: for a Polish company schedule it on a day of the month before the JPK_V7 is due on the 25th). Only after the user agrees, call `schedule_workflow`.
- A refusal with code `automation_paid_feature` means automatic runs need a paid plan. Say so; running by hand stays free.
Important:
- Start, answer, schedule and stop only when the user asked.
- Invoice to payment and client document requests send to clients only when the user asked for sending. Confirm before you relay a "yes, send it".
- For "what did Norman do this week?", call `get_agent_week` and quote its numbers.
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · norman-finance/norman-mcp-server | 100 | MIT |
| adobe/skills | 100 | Apache-2.0 |
| allenai/asta-plugins | 100 | Apache-2.0 |
| kd-labs-io/kd-code-extension | 100 | MIT |
| khpeet/newrelic-skills | 100 | Apache-2.0 |
| alesaiani/agentflow | 100 | Apache-2.0 |
| Pathista/pathista-agent-plugin | 96 | MIT |
Database snapshot: 13.11.2026 · package version 9cdca893baac (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90month-end-close
Run or review a month-end close: checklist, reconciliations, accruals, cut-off and sign-off. Use when the user asks to close a month or check close readiness. - 95jaz-jobs
Use this skill for recurring accounting workflows: month/quarter/year-end close, bank reconciliation, GST/VAT filing, payment runs, credit control, supplier recon, audit prep, fixed asset review, and Singapore Form C-S tax computation. 12 job playbooks that sequence real… - 90month-end-close-checklist-runner
Run a disciplined month-end close: every task sequenced, evidenced and signed off. TRIGGERS - Use when user needs help with month end close checklist runner related tasks. - 90month-end-close
Run a month-end (or period) close checklist against a Well workspace — verify everything is reconciled and posted before the books are closed. Use when the user asks to close the month/period, run a close checklist, check if the books are ready to close, or what's left before closing. - 90monthly-reconciliation
Perform a complete monthly financial reconciliation - review all transactions, match invoices, check outstanding payments, and prepare for tax filing. Use when the user wants to close the month, do monthly bookkeeping, or perform a Monatsabschluss (zamknięcie miesiąca). - 90ta-month-close
Close, reopen or check a German client's VAT period for a tax advisor, and read the state of its year. Use when a tax advisor says a month, quarter or year is done, asks what changed after a close, or asks whether a year is closed.