Notify Slack channels about new invoices by fetching data from Fakturoid and uploading PDFs automatically.

Install

mkdir -p .claude/skills/notify-fridrichmrtn && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/19067" && unzip -o skill.zip -d .claude/skills/notify-fridrichmrtn && rm skill.zip

Installs to .claude/skills/notify-fridrichmrtn

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Send an invoice notification to Slack after manual invoicing or when the /invoice notification step was skipped
111 chars✓ has a “when” trigger
Beginner

Key capabilities

  • Send invoice notifications to Slack using Fakturoid invoice ID
  • Fetch invoice details automatically from Fakturoid
  • Upload invoice PDFs to Slack
  • Send text-only invoice notifications with manual arguments
  • Confirm notification status and PDF upload status from JSON output

How it works

This skill sends invoice notifications to Slack by either fetching details and PDF from Fakturoid using an invoice ID or by constructing a text-only message from manual arguments. It then posts the message to a configured Slack channel.

Inputs & outputs

You give it
Fakturoid invoice ID or manual invoice details
You get back
Slack notification message, uploaded PDF, and JSON status confirmation

When to use notify

  • Notifying team of new invoices
  • Uploading invoice PDFs to Slack
  • Sending invoice summaries

About this skill

/notify — Send Invoice Notification to Slack

Post an invoice notification to Slack. Useful after manual invoicing or when the /invoice notification step was skipped.

Arguments

  • --invoice-id (preferred) — Fakturoid invoice ID; details are fetched automatically and PDF is uploaded
  • --invoice-number (manual fallback) — e.g. "FV-2026-001"
  • --hours (manual fallback) — total billable hours
  • --amount (manual fallback) — e.g. "<total> CZK"
  • --client (manual fallback) — client name
  • --period (manual fallback) — e.g. "2026-03-01 - 2026-03-31"

If --invoice-id is provided, the other args are not needed (they are fetched from Fakturoid). If --invoice-id is not provided, all manual args are required (text-only notification, no PDF). Ask the user for any missing ones.

Steps

  1. With --invoice-id (preferred): uv run python -m invoicing notify --invoice-id <id> This auto-fetches invoice details, sends the Slack message, and uploads the PDF.

  2. With manual args (text-only, no PDF): uv run python -m invoicing notify --invoice-number <num> --hours <hrs> --amount "<amount>" --client "<client>" --period "<period>"

  3. Parse the JSON output to confirm status: "notified" and report pdf_uploaded status to the user.

Notes

  • Requires SLACK_BOT_TOKEN and SLACK_CHANNEL in .env.
  • When --invoice-id is used, the invoice PDF is automatically downloaded from Fakturoid and uploaded to Slack. If PDF download/upload fails, the text notification is still sent.

When not to use it

  • When `SLACK_BOT_TOKEN` or `SLACK_CHANNEL` are not configured in `.env`
  • When the user does not provide an `--invoice-id` or all required manual arguments

Prerequisites

SLACK_BOT_TOKEN in .envSLACK_CHANNEL in .env

Limitations

  • If `--invoice-id` is not provided, only text-only notifications are sent, and no PDF is uploaded
  • Requires `SLACK_BOT_TOKEN` and `SLACK_CHANNEL` in `.env`
  • If PDF download/upload fails, the text notification is still sent

How it compares

This workflow automates fetching invoice details and PDF upload from Fakturoid for Slack notifications, unlike a manual process that would require gathering information and uploading files separately.

Compared to similar skills

notify side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
notify (this skill)03moReviewBeginner
add-vault-note14moNo flagsIntermediate
hummingbot27moNo flagsIntermediate
miniqmt-skill05moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry