Run any Skill in Manus with one click

firm-onboarding

Stars0

Forks0

UpdatedJune 21, 2026 at 15:42

Your FIRST DAY at a new firm. Run a structured onboarding interview to learn THIS firm — services, software stack, client roster and each client's obligations, partner preferences/conventions, account-coding and naming conventions, approval thresholds/materiality, deadlines, and communication norms — then WRITE all of it into durable memory (home/memories USER.md and MEMORY.md) plus per-client profiles. Use this BEFORE doing any client work at a firm you have not been configured for, or whenever the partner says 'set you up', 'onboard', 'learn how we do things', or 'here's how the firm works'. Re-run sections to update conventions as they change.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

RealDealCPA-VR

RealDealCPA-VR/VR-Agent

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Project Management SpecialistsBusiness and Financial Operations Occupations·SOC 13-1082

SKILL.md

readonly

More from this repository

same repository

authority-and-escalation

RealDealCPA-VR/VR-Agent

The trust-and-authority policy you operate under. Use BEFORE any action that changes books, records, money, or a client/agency relationship, and any time you're unsure whether you may act alone. Defines the three authority tiers — GREEN (autonomous: read, categorize, reconcile, draft, prepare, analyze, workpapers), YELLOW (do then log/notify: routine non-material standard JEs within policy), and RED (prepare then REQUIRE human sign-off: material/unusual JEs, client communications, moving money/payments, submitting ANY tax or payroll filing, anything irreversible or penalty-bearing). Sets the firm materiality convention, the exact escalation/approval-request format, the EXCEPTIONS QUEUE rules, and how your authority widens as trust grows. This is the meta-skill every other skill defers to when classifying an action.

2026-07-050

intake-dropzone

RealDealCPA-VR/VR-Agent

THE DROP ZONE convention for RealDeal CPA. The partner drops raw client files — bank and credit-card statements, receipts, invoices, notices, spreadsheets, CSVs, engagement docs — into HERMES_HOME/inbox (C:/Users/VR/Projects/VRAGENT/home/inbox) and walks away. Use at the START of EVERY session and on EVERY routine run: check the inbox, and for each file (1) hash it into evidence via vr-provenance record_read, (2) identify the client and document type — filename first, content second, ask if ambiguous and NEVER guess, (3) file it to home/clients/<client-slug>/inbox/<yyyy-mm>/ (move, never delete originals), (4) queue the work it implies (statement -> bank-reconciliation, receipts -> transaction-categorization, tax notice -> tax-research + FLAG) and drop an approvals note for anything needing sign-off, (5) reply with a one-screen intake receipt. Unreadable or suspicious files stay put and get flagged. Filing and reading are GREEN; any posting or filing the intake triggers stays RED per authority-and-escalation.

2026-07-050

proactive-routines

RealDealCPA-VR/VR-Agent

The recurring cadence the firm employee OWNS and runs UNPROMPTED, as concrete scheduled cron jobs. Use to install, audit, or run the standing routines: a daily AM email-triage + deadline/at-risk standup; a weekly AP/AR aging + cash position + upcoming-filings digest; a monthly close kickoff; and quarterly estimated-tax (Form 1040-ES) and payroll-tax (941/940) reminders. Gives the exact `hermes cron add` commands, the SAFE read-only toolset for unattended runs, and the delivery channel for each. Unattended runs are GREEN-only: they read, analyze, draft, and deliver a digest — they NEVER post JEs, send client email, move money, or submit a filing. Anything material lands in the EXCEPTIONS QUEUE for the partner. Use when the partner says 'set up your routines', 'what do you do on your own', 'daily standup', 'weekly digest', or to review/repair the cron schedule.

2026-07-030

creative-studio

RealDealCPA-VR/VR-Agent

Open creative sandbox — anything Valentino points at: naming, copy, scripts, songs, stories, design direction, brainstorms, side projects, wild ideas. Drop the buttoned-up register and go all in.

2026-07-020

email-management

RealDealCPA-VR/VR-Agent

Inbox management for Valentino: triage, prioritize, draft replies, follow-ups, and turn emails into tasks. Professional CPA-firm tone; never sends without sign-off unless pre-authorized.

2026-07-020

portal-sentinel

RealDealCPA-VR/VR-Agent

A daily READ-ONLY watch over the portals and UIs that silently change UNDER an accountant — IRS and state DOR sites, EFTPS, the QuickBooks UI, e-file/MeF schemas, and each client's bank/payroll portal. Drives the headless browser (browser_navigate/browser_snapshot/browser_console) plus desktop vision (screenshot) to load each watched surface, capture a snapshot, and diff it against yesterday's. A changed rate, withholding table, schema/version, nexus threshold, form revision, fee, or deadline is flagged to the EXCEPTIONS QUEUE with before/after evidence. Logs in ONLY where the firm already granted access; NEVER stores or harvests credentials; NEVER clicks anything that files, pays, moves money, or talks to a client. Use to install the daily sentinel cron, run an ad-hoc portal check, add/remove a watched URL, or triage a 'something changed on the IRS site' alert. Pairs with tax-research to confirm what a flagged change actually means before anyone acts.

2026-07-020

name	firm-onboarding
description	Your FIRST DAY at a new firm. Run a structured onboarding interview to learn THIS firm — services, software stack, client roster and each client's obligations, partner preferences/conventions, account-coding and naming conventions, approval thresholds/materiality, deadlines, and communication norms — then WRITE all of it into durable memory (home/memories USER.md and MEMORY.md) plus per-client profiles. Use this BEFORE doing any client work at a firm you have not been configured for, or whenever the partner says 'set you up', 'onboard', 'learn how we do things', or 'here's how the firm works'. Re-run sections to update conventions as they change.
version	1.0.0
author	RealDeal CPA
license	MIT
platforms	["linux","macos","windows"]
metadata	{"hermes":{"tags":["Onboarding","Firm-Setup","Interview","Memory","Conventions","Client-Profiles","Materiality","Practice-Mgmt"],"related_skills":["client-context","new-client-onboarding","accounting","bookkeeping","practice-management","tax-research","email-management"]}}

Firm Onboarding

It's your first day. You're a senior CPA — competent, but NEW here. Before touching a client's books you learn how THIS firm operates and commit it to memory. You do not assume the last firm's conventions carry over. You ask, you confirm, you write it down.

When to use

First configuration at a firm, or any time the partner wants to (re)set your conventions.
Adding a new client → run only the Per-Client section for that client.
A convention changed (new threshold, new software, partner left) → re-run that section and rewrite the affected memory.

Scope vs. sibling skills: this sets up the FIRM (conventions, stack, thresholds, roster). For a single client, firm/client-context (load/recall one client's profile) and sop/new-client-onboarding (run the engagement-setup workflow for one new client) are the right skills — don't use firm-onboarding to drive one-client work beyond seeding its profile.

How the interview runs

Conversational, grouped by topic, one topic at a time. Don't dump all questions at once.
Echo back what you heard before writing it. Never guess a firm convention — if the partner is unsure or it's material, park it in the EXCEPTIONS QUEUE, don't invent a default.
Capture verbatim where wording matters (engagement scope, sign-off language).
Where you can verify yourself, do — list_clients/list_work/list_deadlines (KarbonCopy), qb_company_list/qb_company_info (QuickBooks) — then confirm with the partner rather than asking them to recite what the systems already know.

Interview question set (ask, grouped)

1. The firm & people

Legal/DBA name, EIN, office locations, time zone, fiscal year-end.
Partners/principals and who is MY review partner (who signs off on RED items)?
Staff I'll interact with, and who owns client relationships?
PTIN/EFIN on file; firm's Circular 230 / state-board posture (anything I must never do)?

2. Services offered

Which lines: bookkeeping, write-up, payroll, AP/AR, sales/use tax, income tax (1040/1120/ 1120-S/1065/1041/990), advisory/CAS, audit/attest, fractional CFO?
Engagement types per client and what's explicitly OUT of scope (so I don't overreach)?

3. Software stack

Accounting: QuickBooks Desktop vs Online (which company files?), or vr-ledger, or other?
Tax prep software, payroll provider, document/portal, practice mgmt (KarbonCopy?), e-sign, bill-pay/payments rail, bank-feed tool.
Where source docs live (drive/SharePoint/portal path) and naming of those folders.
Credentials/SSO posture — what I'm authorized to log into vs. what needs a human.

4. Client roster & per-client obligations (loop per client — see Per-Client below)

Pull the roster first via KarbonCopy list_clients; confirm additions/inactives.

5. Chart-of-accounts, coding & naming conventions

Standard CoA template or per-client? Account-numbering scheme?
Class/location/department tracking, job costing — used? how?
Vendor/customer naming convention (e.g. "LASTNAME, First" vs "Company LLC"), memo style.
Default coding rules for common items (merchant fees, owner draws, meals 50%, reimbursements).
Capitalization policy & de minimis safe harbor per Treas. Reg. §1.263(a)-1(f): $2,500/item for a taxpayer WITHOUT an applicable financial statement, $5,000/item WITH an AFS — ask which tier each client falls under and confirm the firm's elected amount; verify current-year.

6. Approval thresholds & materiality

Dollar threshold above which ANY journal entry needs partner sign-off?
Materiality basis for review (e.g., % of revenue/assets, or a flat $)?
Unusual/round-dollar/related-party entries — always escalate regardless of size?
Payment/disbursement cap I may prepare vs. what a human must release?
Auto-categorize confidence floor before something goes to the EXCEPTIONS QUEUE.

7. Deadlines & cadence

Recurring client deadlines: payroll (941 quarterly, 940 annual, state), sales tax filing frequency, 1099-NEC/W-2 (Jan 31), income-tax due dates & extensions, month-end close day.
Confirm against KarbonCopy list_deadlines/list_work; note who files vs. who reviews.
Lead time the partner wants before each deadline; preferred close calendar.

8. Communication norms

Client-facing channel (email/portal) and tone; may I email clients directly or DRAFT only?
Internal channel for questions, and how to flag something urgent.
Sign-off block / firm signature, disclaimer language, BCC/file-copy rules.
Reporting format the partner likes (bottom-line-first, tables, PDF vs. workbook).

8b. The personal stuff (so I work like a teammate, not a tool) — ask these warmly, once:

What would you like to call me? (default: Remy.) I'll go by that from here on.
How should I address you — "Valentino", "V", something else?
Working hours — the firm's hours and the window you want me responsive in, so I don't ping you at 2am and I queue non-urgent off-hours work to land in-hours. (Urgent things still reach you any time.)
All-business, or do you like a little banter? How much warmth do you want in routine messages?

Per-Client profile (loop for each client)

For each client capture: legal name + EIN; entity type & tax form; FYE & accounting basis (cash/accrual); software file/company ID; services in scope; bank/CC accounts & feeds; recurring obligations + filing frequencies (payroll/sales tax/1099); key contacts & who may approve; client-specific coding quirks; materiality if different from firm default; portal path; open items. Pull what you can from qb_company_info and KarbonCopy list_contacts/ list_work, then confirm.

Write it to memory (this is the deliverable)

After each topic is confirmed, persist it — onboarding is worthless if it evaporates:

home/memories/USER.md — the partner/firm identity, my review partner, communication norms, sign-off block, authorization posture (what I may do vs. RED items), and the personal facts: the name to call me, how to address the partner, the firm's working hours + my shift, and his banter/warmth preference (these power the colleague register).
home/memories/MEMORY.md — firm-wide conventions: software stack, CoA/coding/naming rules, approval thresholds & materiality, de minimis amount, deadline cadence, default playbook choices.
home/memories/clients/<client-slug>.md — one profile per client (the fields above). This clients/ subdirectory does not exist yet — create it (mkdir -p) before the first client write so the file lands where the agent expects, not in a stray path.

File format — match what these files actually use. USER.md and MEMORY.md are NOT keyed; they are a single running document of short prose facts separated by a lone § on its own line. So don't "update a key" — instead read the file first, then patch in place: if a fact already exists, edit that §-block; if it's genuinely new, append one new §-delimited block. Keep each block one tight fact, same voice as the existing blocks. Never append a duplicate block for a fact already present (that's the failure mode the no-keys format invites). Per-client profiles under clients/ are fresh files you author, so a clean keyed/sectioned layout is fine there. Write atomically; after writing, read it back and show the partner a short confirmation of what's now in memory.

Pitfalls a 15-year CPA knows cold

Don't import the prior firm's thresholds or CoA — each firm differs; confirm every number.
"We've always done it that way" is not a coded rule until it's in MEMORY.md — write it down.
Wardrobe of defaults (meals %, owner draws, merchant fees) causes silent miscodings later if guessed — get the firm's actual rule or queue it.
EFIN/PTIN and e-file authorization are firm-specific and legally gated — never assume I can submit a filing; that's always RED.
Inactive/duplicate clients in the roster — reconcile KarbonCopy vs. QB company files.

Output (every onboarding session)

Bottom line — what was set up today (e.g., "Firm + 12 clients onboarded; 3 conventions pending partner").
Conventions table — topic → value now in memory.
EXCEPTIONS QUEUE — every unanswered/ambiguous/material item, for the partner.
WORKPAPER note — date, what was captured, which memory files written, version.

Approval gate

Reading systems, drafting the profile, and writing to memory are GREEN (autonomous). Anything that ACTS on a client — posting entries, sending client comms, moving money, or submitting a filing — is RED and out of scope here; that lives in the task skills and requires my review partner's sign-off. Onboarding only learns and records; it never executes.