Fakturownia CLI

Fakturownia CLI bundle: shared guidance, auth, accounts, departments, issuers, users, categories, clients, payments, bank accounts, products, price lists, in...

Security Scan

The skill is an instruction-only bundle that documents how to use the Fakturownia CLI; its requested environment variables and actions align with that purpose and there is no installer or unexpected network/execution behavior in the bundle itself.

Purpose & Capability

Name/description describe a CLI wrapper for the Fakturownia invoicing API and the bundle only requires the 'fakturownia' binary and relevant CLI commands; requested env vars (FAKTUROWNIA_PROFILE, FAKTUROWNIA_URL, FAKTUROWNIA_API_TOKEN) appear and are appropriate for this purpose.

Instruction Scope

SKILL.md and subskill recipes instruct the agent to verify the CLI is on PATH, run auth/login/status, and use the CLI for API operations. Instructions reference only the CLI, local files/stdin for inputs, and the documented env vars; they do not direct reading arbitrary host files or exfiltrating data to unexpected endpoints.

Install Mechanism

No install spec is present (instruction-only), so nothing will be downloaded or written by the skill itself. The manifest documents the binary requirement but does not provide a bootstrap that would fetch arbitrary code.

Credentials

Environment variables and credential usage are limited to the Fakturownia CLI's profile/token configuration (FAKTUROWNIA_API_TOKEN, FAKTUROWNIA_PROFILE, FAKTUROWNIA_URL). These are proportional and expected for a CLI that authenticates to an external invoicing service.

Persistence & Privilege

Skill is not always-enabled, is user-invocable, and allows normal autonomous invocation (platform default). It does not request system-wide modifications or access to other skills' configurations.

Assessment

This bundle is documentation and recipes for using the Fakturownia CLI rather than code that installs or reaches out to unknown endpoints. Before installing or using it: 1) ensure the fakturownia binary you will run is from a trusted source (install from the official repo/release referenced in the manifest), 2) protect any API tokens (FAKTUROWNIA_API_TOKEN) and only provide them to trusted agents or test accounts, 3) avoid using --raw or storing CLI-returned secrets unless necessary, and 4) if you don't trust autonomous agent actions, restrict the skill from running automatically and invoke it manually instead. If you want higher assurance, verify the referenced GitHub repository and test the workflow on a non-production account first.

Auto-generated by go run ./cmd/gen-skills. Do not edit manually.

fakturownia

Use this as the entrypoint for the generated Fakturownia CLI skill bundle.

Start Here

1. Open the skills index to choose the right subskill.
2. Read fakturownia-shared for auth prerequisites, global flags, output behavior, and schema discovery.
3. Then open the subskill that matches the task area.

Before You Use It

• Confirm fakturownia is already available on PATH with fakturownia --version before attempting task-specific commands.
• Save credentials before API calls with fakturownia auth login --prefix acme --api-token "$FAKTUROWNIA_API_TOKEN".
• If the environment already provides credentials, still run fakturownia auth status --json to confirm the resolved profile, prefix, and token source.
• Run fakturownia account get --json as the first authenticated smoke test before attempting task-specific writes or reads.

Subskills

• fakturownia-shared: Fakturownia CLI shared patterns: authentication prerequisites, global flags, output modes, --fields vs --columns, --raw, schema discovery, and binary maintenance. Use before any area-specific fakturownia task.
• fakturownia-auth: Fakturownia CLI auth: persist, inspect, and remove profiles and API tokens with fakturownia auth ....
• fakturownia-accounts: Fakturownia CLI accounts: create, inspect, delete, and unlink system accounts using the README-backed account contract, with sanitized structured output and optional profile persistence.
• fakturownia-departments: Fakturownia CLI departments: list, fetch, create, update, delete, and upload department logos, with README-backed request and output discovery.
• fakturownia-issuers: Fakturownia CLI issuers: list, fetch, create, update, and delete issuers with README-backed field and payload discovery.
• fakturownia-users: Fakturownia CLI users: create or invite account users through the README-backed add-user endpoint and inspect the accepted user payload shape.
• fakturownia-webhooks: Fakturownia CLI webhooks: list, fetch, create, update, and delete webhooks using conservative README-backed request and output discovery.
• fakturownia-categories: Fakturownia CLI categories: list, fetch, create, update, and delete categories, and inspect README-backed category fields and request schemas.
• fakturownia-clients: Fakturownia CLI clients: list, fetch, create, update, and delete clients, and inspect README-backed client fields and request schemas.
• fakturownia-payments: Fakturownia CLI payments: list, fetch, create, update, and delete banking payments, including the README-backed include=invoices list mode and request-body discovery.
• fakturownia-bank-accounts: Fakturownia CLI bank accounts: list, fetch, create, update, and delete bank accounts, and inspect the bank-account addendum fields that also affect invoice payloads.
• fakturownia-products: Fakturownia CLI products: list, fetch, create, update, and delete products, including warehouse-aware reads and README-backed request schemas.
• fakturownia-price-lists: Fakturownia CLI price lists: list, fetch, create, update, and delete price lists, including upstream-shaped position payloads and schema-backed discovery.
• fakturownia-invoices: Fakturownia CLI invoices: list, fetch, create, update, delete, email, cancel, send to KSeF through the API-native gov flow, download invoice attachments, and discover invoice fields and payloads through schema output.
• fakturownia-recurrings: Fakturownia CLI recurrings: list, create, update, and delete recurring invoice definitions with README-backed request and output discovery.
• fakturownia-warehouses: Fakturownia CLI warehouses: list, fetch, create, update, and delete warehouses, and inspect README-backed warehouse fields and request schemas.
• fakturownia-warehouse-actions: Fakturownia CLI warehouse actions: list warehouse actions with explicit README-backed filters and inspect conservative action fields through schema output.
• fakturownia-warehouse-documents: Fakturownia CLI warehouse documents: list, fetch, create, update, and delete warehouse documents, including kind selection and invoice linking through payload fields.
• fakturownia-schema: Fakturownia CLI schema discovery: inspect supported commands, flags, examples, exit codes, and output schemas with fakturownia schema ....
• fakturownia-doctor: Fakturownia CLI diagnostics: validate config resolution, credential-store access, reachability, authenticated API access, and release integrity with fakturownia doctor run.

Recipes

• Open the recipes index for higher-level invoice and recurring workflows from the upstream README.

CLI Entry Point

fakturownia --help