Skill instructions
bookkeep-documents1.86 KB
View saved version →
---
name: bookkeep-documents
description: >
Record receipts, bills, invoices, expenses, sales, payments, refunds, and
statement-backed activity from source documents into Vibooks. Use when a
user provides a folder or set of bookkeeping documents and wants reviewable,
source-aware entries created through proper subledger workflows.
---
# Bookkeep Documents
Follow the bundled `vibooks` skill for professional bookkeeping treatment,
source evidence, jurisdiction, tax, correction, and verification rules.
The plugin already provides the bundled Vibooks workflow. Do not install a
duplicate standalone skill with `npx skills`; use the agent client's plugin
manager for plugin updates.
1. Run `vibooks_readiness` when available and confirm the intended company,
book, accounting period, and source-document scope.
2. Read the original receipts, bills, invoices, statements, and attachments.
Stop for material ambiguity in dates, counterparties, amounts, tax
treatment, payment state, or intended accounting treatment.
3. Use first-class Vibooks workflows for invoices, bills, receipts, payments,
refunds, applications, transfers, payroll, and adjustments. Do not replace
them with generic journals when a supported workflow exists.
4. Discover unfamiliar operations with `vibooks_ops`, then inspect contracts
with `vibooks_describe` and `vibooks_schema`.
5. Before any write, summarize the intended records and confirm that the user
authorized that bookkeeping action. Pass `confirmMutation: true` to
`vibooks_invoke` only for that reviewed, authorized write.
6. Attach or link source evidence where supported, read the result back, and
run workflow-specific verification before calling the batch complete.
Report records created or corrected, evidence linked, exceptions requiring a
decision, and verification results. Do not claim tax filing, audit, or
assurance work.
Referenced files: 1 — file references are metadata, not package contents.
reconcile-close1.66 KB
View saved version →
---
name: reconcile-close
description: >
Reconcile bank and credit-card statements, investigate differences, verify
balances and subledgers, and prepare a Vibooks book for month end or period
close. Use for reconciliation, close readiness, trial balance, aging,
financial-report, or unresolved-difference work.
---
# Reconcile And Close
Follow the bundled `vibooks` skill for reconciliation, period controls,
corrections, source evidence, and professional bookkeeping rules.
The plugin already provides the bundled Vibooks workflow. Do not install a
duplicate standalone skill with `npx skills`; use the agent client's plugin
manager for plugin updates.
1. Confirm the company, book, statement account, statement dates, ending
balance, and period under review. Never invent missing statement facts.
2. Run `vibooks_readiness` and use `vibooks_verify` for the initial read-only
reconciliation and close-readiness view when those tools are available.
3. Tie statement balances to the account register and ledger. Investigate
missing, duplicate, uncleared, misdated, misclassified, or unapplied items
through their first-class source workflows.
4. Present proposed corrections and unresolved differences before mutation.
Use `vibooks_invoke` with `confirmMutation: true` only after the user
authorizes the specific correction.
5. Re-run reconciliation, trial-balance, subledger, aging, and relevant report
checks after corrections. Do not close a period while material exceptions
remain unresolved.
Finish with reconciled statement balances, unresolved differences, report and
subledger checks, proposed follow-ups, and a clear close-ready or not-ready
result.
Referenced files: 1 — file references are metadata, not package contents.
review-books1.73 KB
View saved version →
---
name: review-books
description: >
Independently review AI-assisted or posted Vibooks bookkeeping against
original receipts, invoices, bills, statements, attachments, and read-only
ledger evidence. Use for bookkeeping quality control, discrepancy review,
source-to-ledger validation, or a second-agent review without changing the
book.
---
# Review Vibooks Books
Follow the bundled `vibooks` skill's independent evidence-review workflow and
professional bookkeeping criteria.
The plugin already provides the bundled Vibooks workflow. Do not install a
duplicate standalone skill with `npx skills`; use the agent client's plugin
manager for plugin updates.
1. Keep the review read-only. Do not pass `confirmMutation: true` and do not
alter the Vibooks book during this skill.
2. Work from original source documents and read-only Vibooks state in a clean
review workspace. Do not reuse the posting agent's extraction artifacts,
intermediate files, conclusions, or reasoning as evidence.
3. Confirm the company, book, period, accounting basis, jurisdiction, tax
setup, and evidence scope before drawing conclusions.
4. Use `vibooks_readiness`, `vibooks_verify`, and read-only operations through
`vibooks_invoke` when available. Discover unfamiliar reads with
`vibooks_ops`, `vibooks_describe`, and `vibooks_schema`.
5. Compare source facts with contacts, documents, postings, subledgers,
reconciliations, tax summaries, and reports. Separate confirmed errors,
missing evidence, policy questions, and acceptable treatments.
Deliver an evidence-based findings report with affected records, source facts,
ledger facts, materiality, and proposed correction workflows. Stop before any
correction until the user separately authorizes it.
Referenced files: 1 — file references are metadata, not package contents.
setup2 KB
View saved version →
---
name: setup
description: >
Set up, install, start, reconnect, or verify Vibooks and vibooks-cli for a
small-business bookkeeping workflow. Use when Vibooks is not installed,
local API readiness is unclear, access is missing, or a company or book must
be created or reused before bookkeeping begins.
---
# Set Up Vibooks
Follow the bundled `vibooks` skill for installation, authentication,
licensing, jurisdiction, and bookkeeping safety rules.
The plugin already provides the bundled Vibooks workflow. Do not install a
duplicate standalone skill with `npx skills`; use the agent client's plugin
manager for plugin updates.
1. Apply the bundled `vibooks` skill's 24-hour update-check cache before using
`vibooks_update_status`. With two fresh catalog entries, call it once with
`includeNetwork: false` when local installed versions are needed and combine
those facts with the validated cache. If either entry is stale or the user
asks to check now, call the normal networked tool once and validate each
returned catalog as the bundled skill requires. Report updates; do not run a
duplicate standalone check or install anything silently.
2. Run `vibooks_readiness`. If startup is unclear, inspect
`vibooks_desktop_status`; inspect `vibooks_license_status` only when access
or licensing blocks the requested work.
3. Reuse a trusted existing installation and book when possible. Otherwise
follow the bundled skill's official install and bootstrap workflow.
4. Confirm the active company, book, accounting basis, jurisdiction, currency,
and tax setup before creating bookkeeping data.
5. When an unfamiliar API operation is needed, discover it with `vibooks_ops`,
then inspect it with `vibooks_describe` and `vibooks_schema` before use.
6. Do not bypass licensing, period controls, supported workflows, or the
official Vibooks API and CLI paths.
Finish by reporting the selected company and book, readiness state, unresolved
setup decisions, and the next bookkeeping action that is safe to perform.
Referenced files: 1 — file references are metadata, not package contents.
vibooks26.3 KB
View saved version →
---
name: vibooks
description: >
Use only when the request explicitly operates, configures, reviews, installs,
or troubleshoots Vibooks. Do not trigger for other accounting software,
generic accounting or payroll advice, or document and spreadsheet work
outside Vibooks. Installs or reuses Vibooks desktop, headless packages, or vibooks-cli;
verifies local API readiness, first-token access, trusted company or book
connection, and public skill-manifest freshness before high-risk writes;
bootstraps or rebuilds small-business books with jurisdiction, accounting,
and tax setup for covered or uncovered countries; records, corrects,
reconciles, verifies, and closes real bookkeeping, including supported
Canadian payroll, pay statements, vacation pay, and payroll corrections,
through official Vibooks workflows rather than direct storage edits;
independently reviews
AI-assisted Vibooks bookkeeping against original source evidence in a clean
review workspace without reusing prior extraction artifacts.
metadata:
skill_version: 1.5.0
source_repo: vibooks-ai/skills
update_check: https://vibooks.ai/skills/manifest.json
install_command: npx skills add vibooks-ai/skills --skill vibooks -g
update_check_command: npx skills check
update_all_command: npx skills update
update_scope: all_installed_skills
web_fallback: https://vibooks.ai/skill.md
install_sh: https://vibooks.ai/install.sh
install_ps1: https://vibooks.ai/install.ps1
downloads: https://vibooks.ai/downloads.json
---
# Vibooks
Use this skill when the user needs Vibooks installed or reused locally, needs
an agent connected safely to Vibooks, or wants real bookkeeping work done
inside Vibooks.
## Choose The Skill Distribution
When this skill is loaded from the official Vibooks plugin, including through
a namespaced skill such as `vibooks:setup` or `vibooks:bookkeep-documents`, the
plugin already provides the bundled Vibooks workflow. Treat the skill as
installed in plugin mode. Do not install or update a duplicate standalone copy
with `npx skills add`, `npx skills check`, or `npx skills update` merely because
an unnamespaced global `vibooks` skill is absent.
Install and update the plugin through the current agent client's plugin
directory or marketplace. After a plugin install or update, start a new task or
restart the client when required so it loads the new bundled content. The
plugin package version and `metadata.skill_version` are separate: the former
identifies the published plugin release, while the latter identifies the
bundled core workflow.
Use the standalone installation and update commands below only when the
official plugin is not loaded and the client supports the `skills` CLI
ecosystem, or when the user explicitly requests a standalone installation.
## Install This Skill
This section applies to standalone or direct-read web use, not plugin mode. For
agents that support the `skills` CLI ecosystem and have not loaded the official
Vibooks plugin, install Vibooks from the public skill source repo:
```bash
npx skills add vibooks-ai/skills --skill vibooks -g
```
Use that repo source for installation. `-g` is the recommended default so the
installed skill stays available across projects; omit it only when the user
explicitly wants a project-local install.
Best results come from installed-skill mode:
1. run `npx skills add vibooks-ai/skills --skill vibooks -g`
2. if the agent client picks up new skills live, switch to the installed
`vibooks` skill for the current session
3. if the agent client only picks up new skills at startup, let the next
restart pick up the installed `vibooks` skill and keep using the documented
web copy for the current session
Treat the direct-read web copy at `https://vibooks.ai/skill.md` as a first-use
bootstrap, not as the preferred steady-state mode.
If the agent is reading `https://vibooks.ai/skill.md` and the local `vibooks`
skill is not installed yet, is missing `metadata.skill_versio
Preview of the first 4,000 characters. Read full instructions →
Referenced files: 14 — file references are metadata, not package contents.