Install
$ agentstack add skill-joellewis-finance-skills-client-onboarding ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
Client Onboarding
Core Concepts
Onboarding Workflow Architecture
Client onboarding is an orchestrated, multi-stage process that transforms a prospect into a funded, investable account. The canonical stages are:
- Prospect intake — capture contact information, establish CRM record, assign advisor
- Identity verification — CIP/KYC checks (name, DOB, address, SSN/TIN, government ID)
- Suitability data collection — investment objectives, risk tolerance, time horizon, financial situation
- Account type selection — individual, joint, trust, IRA, entity, or other structure
- Document generation — assemble the required document package based on account type and features
- E-signature — execute new account forms, agreements, and disclosures electronically
- Custodian submission — transmit the completed application to the custodian for account creation
- Funding — ACH, wire, ACAT transfer, or check deposit to fund the new account
- Initial investment — assign the funded account to a model portfolio or execute the initial trade
The two primary flow models are advisor-assisted and self-service (digital-direct). In advisor-assisted onboarding, the advisor guides the client through each step, often in a meeting or screen-share, with the onboarding platform pre-populating data from the CRM. In self-service onboarding, the client completes a guided digital workflow independently, with the advisor reviewing and approving the completed application. Most firms support a hybrid model where self-service handles simple account types and advisor-assisted handles complex ones.
The onboarding platform acts as an orchestrator across multiple downstream systems: CRM (client master), KYC/AML vendor (identity verification), custodian (account opening API), document management (storage and retrieval), and portfolio management system (model assignment). The platform must manage state transitions, handle errors at each stage, and provide visibility to both the advisor and compliance.
Digital Identity Verification
Identity verification during onboarding must satisfy CIP requirements under USA PATRIOT Act Section 326 and, for legal entities, the FinCEN CDD Rule (31 CFR 1010.230). The onboarding workflow collects the following minimum identifying information:
- Individuals: Full legal name, date of birth, residential address, Social Security Number (or TIN for non-citizens)
- Entities: Legal name, formation date, principal place of business, EIN/TIN, formation documents
Verification methods integrated into digital onboarding:
- Database verification — real-time API calls to identity verification vendors (LexisNexis Risk Solutions, Equifax, TransUnion, Alloy) that cross-reference provided data against credit bureau, public records, and government databases. This is the most common method for digital onboarding because it requires no document handling and provides a pass/fail result in seconds.
- Document verification — the client uploads a photo of a government-issued ID (driver's license, passport), and optionally a selfie for facial comparison. OCR extracts data fields; liveness detection prevents spoofing. Used as a fallback when database verification is inconclusive or as a primary method for non-US persons.
- Knowledge-based authentication (KBA) — the client answers challenge questions generated from their credit file (e.g., "Which of the following addresses have you lived at?"). KBA is declining in use due to data breach exposure but remains a supplementary method.
- Biometric verification — fingerprint or facial recognition, typically used in mobile onboarding flows.
OFAC and sanctions screening is a mandatory gate before account opening. The onboarding platform must screen all individuals associated with the account (account holders, authorized signers, beneficial owners, trustees) against the OFAC SDN list, FinCEN 314(a) lists, and any firm-specific restricted lists. A match or potential match must halt the onboarding flow and route to compliance for manual review.
Beneficial ownership collection for entity accounts requires identification of every individual who directly or indirectly owns 25% or more of the equity interests in the legal entity, plus at least one individual with significant managerial control (the control person). The onboarding workflow must dynamically present beneficial ownership forms when the account type is an entity (LLC, corporation, partnership, certain trusts).
Enhanced due diligence triggers that the onboarding system should detect and flag: politically exposed persons (PEPs), connections to high-risk jurisdictions (per FinCEN advisories and FATF guidance), complex multi-layered ownership structures, and negative news screening results. When EDD is triggered, the onboarding flow should pause and escalate to the compliance team before proceeding.
Suitability and Risk Profiling
Onboarding is the primary data collection event for investment suitability. Before any investment recommendation can be made, the firm must gather sufficient information to satisfy FINRA Rule 2111 (suitability) for broker-dealers and Regulation Best Interest for BD recommendations, or the fiduciary duty of care for registered investment advisers.
Required data elements:
- Investment objectives (capital preservation, income, growth, aggressive growth, speculation)
- Time horizon (short-term under 3 years, intermediate 3-10 years, long-term over 10 years)
- Risk tolerance (conservative, moderate, aggressive — and the behavioral willingness to endure volatility)
- Liquidity needs (anticipated withdrawals, major expenses, emergency reserves)
- Annual income and net worth (including liquid net worth)
- Investment experience (years of experience, asset classes traded, knowledge level)
- Tax status (marginal tax bracket, tax-sensitive vs tax-exempt accounts)
- Special circumstances (concentrated stock positions, employer restrictions, ESG preferences)
Risk questionnaire design follows two approaches:
- Psychometric questionnaires measure the client's emotional and behavioral relationship with risk — willingness to accept losses, reaction to market downturns, comfort with uncertainty. These are better at capturing true risk tolerance but can be subjective.
- Knowledge-based questionnaires assess the client's understanding of investment concepts and their objective financial capacity to bear risk. These are more defensible from a compliance standpoint but may not capture behavioral tendencies.
Best practice is a combined approach: psychometric questions to assess willingness, financial data to assess capacity, and a mapping algorithm that produces a risk score or category. The risk score then maps to a model portfolio or investment strategy range.
Regulatory requirements at onboarding: The suitability profile must be documented before the first investment recommendation. For discretionary accounts, the investment policy statement (IPS) should be established during onboarding. For Reg BI accounts, the Care Obligation requires that any recommendation — including account type — have a reasonable basis given the client's profile.
Account Type Selection and Configuration
The onboarding workflow must guide account type selection based on the client's needs. Account types and their key characteristics:
Individual and joint accounts:
- Individual taxable — single owner, simplest structure
- Joint Tenants with Right of Survivorship (JTWROS) — co-owners; on death, surviving owner inherits automatically
- Tenants in Common (TIC) — co-owners; each owns a specified share that passes to their estate
- Community Property — available in community property states; assets acquired during marriage are jointly owned
Retirement accounts:
- Traditional IRA — tax-deductible contributions (subject to income limits), tax-deferred growth, RMDs at age 73
- Roth IRA — after-tax contributions, tax-free growth and qualified withdrawals, no RMDs during owner's lifetime
- SEP IRA — employer-funded; contribution limits up to 25% of compensation or the annual dollar limit
- SIMPLE IRA — employee salary deferral plus employer match or non-elective contribution
- Inherited IRA — beneficiary account; subject to 10-year distribution rule (SECURE Act) for most non-spouse beneficiaries
Trust accounts:
- Revocable (living) trust — grantor maintains control; assets avoid probate; grantor's SSN typically used as TIN
- Irrevocable trust — grantor gives up control; separate tax entity with its own EIN; beneficial ownership rules apply
- Testamentary trust — created by will; requires court documentation
Entity accounts:
- LLC — requires articles of organization, operating agreement, EIN, beneficial ownership certification
- Corporation (C-Corp, S-Corp) — requires articles of incorporation, bylaws, corporate resolution, EIN
- Partnership (LP, LLP, GP) — requires partnership agreement, EIN, identification of general partner(s)
Custodial accounts:
- UTMA/UGMA — custodian manages assets for a minor until the age of majority (18 or 21 depending on state)
Estate accounts:
- Require letters testamentary or letters of administration, death certificate, EIN for the estate
Account features configured during onboarding:
- Margin eligibility (requires separate margin agreement and additional disclosures)
- Options approval level (levels 0-4 depending on custodian; requires options agreement and risk disclosure)
- Check writing and debit card access
- Tax lot accounting method selection (specific identification, FIFO, average cost)
- Beneficiary designation (primary and contingent for retirement and TOD accounts)
- Dividend and capital gains reinvestment preferences
- Trusted contact person (FINRA Rule 4512)
Document Collection and Generation
Each account type requires a specific document package. The onboarding system should dynamically assemble the required documents based on the account type and features selected.
Universal documents (all account types):
- New account application form (custodian-specific)
- W-9 (US persons) or W-8BEN/W-8BEN-E (non-US persons)
- Advisory agreement or brokerage agreement
- Form CRS (Client Relationship Summary)
- Privacy notice (Reg S-P)
- Trusted contact person designation
Account-type-specific documents:
- Joint accounts: joint account agreement specifying ownership type
- Trust accounts: trust certification (or full trust agreement), trustee identification, trust TIN documentation
- Entity accounts: formation documents (articles of incorporation/organization, partnership agreement), corporate resolution or operating agreement authorizing the account, beneficial ownership certification form (FinCEN)
- IRA accounts: IRA adoption agreement, beneficiary designation form, IRA disclosure statement, rollover/transfer forms (if funding from another retirement account)
- Estate accounts: letters testamentary/administration, death certificate, EIN assignment letter
- Custodial accounts (UTMA/UGMA): custodial account agreement, minor's SSN
Feature-specific documents:
- Margin: margin agreement, margin risk disclosure
- Options: options agreement, OCC Characteristics and Risks of Standardized Options document
Document assembly in modern onboarding platforms involves pre-populating forms with data already collected during earlier onboarding stages (identity, suitability, account type). The system generates a personalized document package with client data filled in, leaving only signature blocks and any fields that require manual completion. This dramatically reduces errors and accelerates the process.
Document management considerations:
- Version control: track which version of each form was used (custodians update forms periodically)
- Expiration tracking: certain documents (e.g., trust certifications, corporate resolutions) may need periodic recertification
- Retention: SEC Rule 17a-4 (broker-dealers) and Rule 204-2 (investment advisers) govern document retention periods — typically 5-6 years, with some records retained for the life of the account
- Storage: documents should be stored in a searchable, indexed repository linked to the client and account records
E-Signature and Consent
Electronic signatures are legally binding for account opening documents under the E-SIGN Act (15 USC 7001) and the Uniform Electronic Transactions Act (UETA), adopted in some form by 49 states and DC.
E-SIGN Act requirements for valid electronic signatures:
- The signer must consent to use electronic records and signatures
- The consent must be informed — the signer must be told what types of records will be provided electronically and how to withdraw consent
- The signer must demonstrate the ability to access electronic records in the format used
- The firm must retain the electronic record in a form that accurately reproduces the original
E-signature platform integration: Most advisory firms use DocuSign, Adobe Sign, or custodian-embedded signing tools (e.g., Schwab's e-signature within their account opening API). Integration patterns include:
- Embedded signing — the e-signature ceremony is embedded within the onboarding platform's user interface, providing a seamless experience
- Redirect signing — the client is redirected to the e-signature vendor's portal to complete signing, then returned to the onboarding platform
- Email-based signing — the client receives an email with a link to review and sign documents, completing the process asynchronously
Consent to electronic delivery is a prerequisite. Before delivering documents electronically, the firm must obtain the client's affirmative consent, inform them of their right to receive paper copies, and verify their ability to access electronic documents. This consent is typically captured as one of the first steps in a digital onboarding flow.
Wet signature exceptions: Some custodians and certain form types still require original (wet ink) signatures. Common exceptions include: certain international account forms, some trust documentation, specific alternative investment subscription agreements, and medallion signature guarantees for account transfers. The onboarding system should identify these exceptions and route them to a wet-signature workflow.
Signature ceremony design for multi-party accounts:
- Joint accounts: both owners must sign; the system should define a signing order or allow parallel signing
- Trust accounts: all trustees authorized to act on the account must sign
- Entity accounts: authorized signers per the corporate resolution or operating agreement must sign
- The system must track completion status for each signer and send reminders for incomplete ceremonies
Audit trail requirements: The e-signature record must include: signer identity (name, email), timestamp of each signature, IP address, authentication method used, document hash (to prove the signed document was not altered post-signature), and a certificate of completion. This audit trail must be retained as part of the account records.
Custodian Submission and Account Funding
After documents are signed, the completed application package is submitted to the custodian for account creation. Submission methods vary by custodian and account complexity:
API-based submission (straight-through processing):
- Major custodians (Charles Schwab, Fidelity, Pershing, TD Ameritrade/Schwab) offer account opening APIs that accept structured data and documents
- The onboarding platform submits client data, account configuration, and signed documents programmatically
- The custodian validates the submission and returns an account number (typically within minutes to hours for standard accounts)
- This is the target state for high-volume firms seeking straight-through processing (STP)
**Semi-automated
…
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: JoelLewis
- Source: JoelLewis/finance_skills
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.