Agent skill

Client Onboarding

by JoelLewis in JoelLewis/finance_skills

Design and implement end-to-end client onboarding workflows from prospect intake through funded account, covering KYC verification, document collection, e-signature, and custodian submission.

MITAuto-check passedSales & Support

Install Client Onboarding

skills CLI
$ npx skills add JoelLewis/finance_skills --skill client-onboarding -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install JoelLewis/finance_skills client-onboarding --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/JoelLewis/finance_skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/advisory-practice/skills/client-onboarding .claude/skills/client-onboarding && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
client-onboarding
GitHub stars
205
Token cost
~8k tokens
SKILL.md length
3,999 words
Files
2 (incl. references)
Skills in repo
91
Repo updated
First seen
Licence
MIT

At a glance

Design and implement end-to-end client onboarding workflows from prospect intake through funded account, covering KYC verification, document collection, e-signature, and custodian submission.

  • Works in 9 steps: Prospect intake — capture contact… → Identity verification — CIP/KYC checks… → Suitability data collection — investment… → …
  • The user asks about building a digital onboarding flow
  • SKILL.md covers Core Concepts, Worked Examples, Common Pitfalls and Cross-References
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Client Onboarding is an agent skill from JoelLewis/finance_skills. Design and implement end-to-end client onboarding workflows from prospect intake through funded account, covering KYC verification, document collection, e-signature, and custodian submission. Use when the user asks about building a digital onboarding flow, integrating identity verification or CIP checks, reducing NIGO rejection rates, opening complex account types like trusts or entities, connecting to custodian APIs, designing suitability questionnaires, or comparing advisor-assisted vs self-service models. Also…

Its SKILL.md is about 8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/examples.md`).

It sits in Sales & Support, covering Help center and FAQ content. The repository describes itself as: Claude Code skill plugins for financial services — 81 skills across 7 domain plugins covering investment management, compliance, advisory practice, trading, and operations. The licence is MIT.

When your agent uses it

  • The user asks about building a digital onboarding flow
  • Integrating identity verification
  • Reducing NIGO rejection rates
  • Opening complex account types like trusts

Example prompts

  • “new account opening”
  • “onboarding bottleneck”
  • “KYC integration”
  • “/client-onboarding”

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Prospect intake — capture contact information, establish CRM record, assign advisor
  2. Identity verification — CIP/KYC checks (name, DOB, address, SSN/TIN, government ID)
  3. Suitability data collection — investment objectives, risk tolerance, time horizon, financial situation
  4. Account type selection — individual, joint, trust, IRA, entity, or other structure
  5. Document generation — assemble the required document package based on account type and features
  6. E-signature — execute new account forms, agreements, and disclosures electronically
  7. Custodian submission — transmit the completed application to the custodian for account creation
  8. Funding — ACH, wire, ACAT transfer, or check deposit to fund the new account
  9. Initial investment — assign the funded account to a model portfolio or execute the initial trade

What it can do on your machine

Read from SKILL.md and the folder at commit 5c498ea. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Client Onboarding loads about 8k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 180 tokens; SKILL.md has 3,999 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~180
When it runs · the whole SKILL.md, loaded when a task matches
~8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~11k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from JoelLewis/finance_skills at commit 5c498ea, republished under its MIT licence (© JoelLewis). 3,999 words, ~8,018 tokens.

Download SKILL.mdSave it as .claude/skills/client-onboarding/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
client-onboarding
description
Design and implement end-to-end client onboarding workflows from prospect intake through funded account, covering KYC verification, document collection, e-signature, and custodian submission. Use when the user asks about building a digital onboarding flow, integrating identity verification or CIP checks, reducing NIGO rejection rates, opening complex account types like trusts or entities, connecting to custodian APIs, designing suitability questionnaires, or comparing advisor-assisted vs self-service models. Also trigger when users mention 'new account opening', 'onboarding bottleneck', 'KYC integration', 'beneficial ownership', 'OFAC screening', 'account funding', or 'onboarding automation'.

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:

  1. Prospect intake — capture contact information, establish CRM record, assign advisor
  2. Identity verification — CIP/KYC checks (name, DOB, address, SSN/TIN, government ID)
  3. Suitability data collection — investment objectives, risk tolerance, time horizon, financial situation
  4. Account type selection — individual, joint, trust, IRA, entity, or other structure
  5. Document generation — assemble the required document package based on account type and features
  6. E-signature — execute new account forms, agreements, and disclosures electronically
  7. Custodian submission — transmit the completed application to the custodian for account creation
  8. Funding — ACH, wire, ACAT transfer, or check deposit to fund the new account
  9. 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

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 submission:

  • Some custodians accept submissions through their advisor portal with pre-populated data
  • The onboarding platform generates a data file or pre-fills the custodian's web forms
  • An operations team member reviews and clicks "submit" — human-in-the-loop

Manual submission:

  • Complex account types (certain trusts, estates, entities, international accounts) often require manual submission
  • Signed documents are uploaded to the custodian's document portal or sent via secure file transfer
  • Processing time ranges from days to weeks depending on account complexity

NIGO (Not In Good Order) handling: A NIGO rejection means the custodian has found errors or missing information in the application. Common NIGO causes:

  • Missing or illegible signatures
  • Inconsistent data between forms (e.g., name on W-9 does not match account application)
  • Missing required documents (e.g., trust certification not included)
  • Invalid or expired identity documents
  • Missing beneficial ownership certification for entity accounts
  • Incorrect account type coding
  • Missing beneficiary designation for retirement accounts

NIGO remediation workflow: the onboarding system should receive NIGO notifications from the custodian (via API callback, email, or status polling), parse the rejection reason, notify the advisor and/or client, collect the corrected information or documents, and resubmit. Reducing NIGO rates is one of the highest-impact onboarding optimizations.

Account funding methods:

  • ACH transfer — electronic transfer from a linked bank account; typically 2-4 business days; requires bank account verification (micro-deposits, Plaid, or manual voided check)
  • Wire transfer — same-day or next-day funding for large amounts; requires wire instructions from the custodian
  • ACAT transfer — Automated Customer Account Transfer system (DTCC) for transferring assets from another brokerage; typically 4-6 business days for full transfers; partial ACAT for specific positions
  • Check deposit — physical check or mobile check deposit; subject to hold periods
  • In-kind transfer — transferring existing securities without liquidating; important for tax-sensitive clients
  • Rollover — direct rollover from employer plan or another IRA; requires rollover paperwork from the distributing institution

Initial investment: Once the account is funded, the onboarding system should trigger model portfolio assignment. For discretionary accounts, this means linking the account to the appropriate model in the portfolio management system (PMS) and generating the initial trade orders. For non-discretionary accounts, the advisor submits the first investment recommendation.

Show full SKILL.md (1,592 more words)Show less
Compliance Checkpoints

Effective onboarding embeds compliance gates at specific stages, preventing the workflow from advancing until requirements are met:

Gate 1 — Identity verification (before account opening):

  • CIP verification must return a pass result
  • OFAC/sanctions screening must clear all associated individuals
  • If either fails, the flow halts and routes to compliance
  • No account can be opened until identity is verified (USA PATRIOT Act Section 326)

Gate 2 — Suitability documentation (before investment):

  • Investment profile (objectives, risk tolerance, time horizon, financial situation) must be completed
  • Risk questionnaire must be scored and documented
  • For Reg BI: the initial recommendation (including account type recommendation) must have a documented reasonable basis
  • For fiduciary advisers: the suitability profile must support the proposed investment strategy

Gate 3 — Beneficial ownership (before entity account opening):

  • FinCEN beneficial ownership certification must be completed for all legal entity accounts
  • 25% owners and at least one control person must be identified and verified
  • Exempt entity types (publicly traded companies, regulated financial institutions, government entities) must be documented

Gate 4 — Disclosure delivery (before or at account opening):

  • Form CRS must be delivered before or at the time of opening the account
  • Form ADV Part 2A (RIAs) must be delivered before or at the time of entering the advisory agreement
  • Privacy notice must be delivered at account opening
  • Margin and options disclosures must be delivered if those features are selected

Gate 5 — Supervisory review (risk-based, before account activation):

  • Certain account types or client profiles trigger mandatory supervisory review before the account becomes active
  • Common triggers: discretionary authority requested, margin or options trading, senior investors (age 65+), high-net-worth thresholds, PEPs or EDD clients, concentrated positions, complex entity structures
  • The supervisor reviews the application package, suitability documentation, and any compliance flags
  • The system must track review status and prevent account activation until supervisory approval is recorded

Compliance hold and escalation:

  • When any gate fails, the application enters a compliance hold state
  • The system notifies the compliance team with the specific failure reason and supporting documentation
  • Escalation paths: line supervisor, compliance officer, chief compliance officer, legal counsel
  • Resolution options: request additional information from the client, approve with conditions, decline the account
  • All compliance decisions must be documented and retained
Data Flow and System Integration

Onboarding is the primary data collection event that populates downstream systems. The data collected during onboarding flows to:

  • CRM (client master) — contact information, household relationships, advisor assignment, service tier, communication preferences. The CRM should be the first system updated, often serving as the source of truth for client identity data.
  • Portfolio management system (PMS) — account number, model portfolio assignment, investment restrictions, tax lot method, rebalancing preferences. The PMS receives the new account once it is created at the custodian and funded.
  • Custodian/account master — the custodian maintains the official account record, including registration, tax status, beneficiaries, and authorized parties. The onboarding system submits data to the custodian; the custodian returns the account number and confirmation.
  • Compliance systems — KYC/AML records, suitability documentation, disclosure delivery confirmations, supervisory review records. These records must be retained per regulatory requirements and accessible for examinations.
  • Document repository — signed account opening documents, identity verification records, formation documents for entities, trust certifications. Must be indexed by client and account for retrieval.
  • Financial planning system — goals, time horizons, income projections, tax data. If the firm uses a planning tool, onboarding data should feed into the initial plan.

Integration patterns:

  • Real-time API calls — for identity verification, custodian submission, OFAC screening. These require immediate responses and should include timeout handling and fallback procedures.
  • Asynchronous/event-driven — for downstream notifications (e.g., notifying the PMS that a new account is ready for model assignment). Message queues or webhook patterns are common.
  • Batch processing — some custodian integrations operate on batch submission cycles (e.g., end-of-day file uploads). The onboarding system must queue submissions and reconcile results.

Data validation: The onboarding system should validate data consistency across systems. Common validation checks:

  • Name and SSN/TIN match across all forms and systems
  • Account type is consistent between the onboarding platform and custodian
  • Beneficiary designations match between the onboarding record and custodian record
  • Advisor assignment in CRM matches the advisory agreement
  • Tax lot method in the PMS matches the client's election

Pre-population for existing clients: When an existing client opens an additional account, the onboarding system should pre-populate known data from the CRM and existing account records. Identity verification may be streamlined (re-verification vs full CIP depending on firm policy), and suitability data may only need to be confirmed rather than re-collected.

Onboarding Metrics and Optimization

Measuring onboarding effectiveness enables continuous improvement:

Key performance indicators:

  • Time-to-funded-account — elapsed time from prospect intake to first funded dollar. Industry benchmarks: 3-5 business days for simple accounts via digital onboarding, 2-4 weeks for complex accounts. Target for best-in-class digital: same day for individual taxable accounts.
  • Application abandonment rate — percentage of onboarding flows started but not completed. High abandonment at a specific step indicates friction. Industry average: 25-40% for digital-direct flows; significantly lower for advisor-assisted.
  • NIGO rate — percentage of submissions rejected by the custodian. Target: under 5%. Industry average: 10-20% for firms without automated validation.
  • Straight-through processing (STP) rate — percentage of applications that pass from submission to account creation without manual intervention. Target: above 80% for standard individual and joint accounts.
  • First-contact resolution rate — percentage of onboarding issues resolved without requiring the client to take additional action.
  • Client satisfaction score — post-onboarding survey measuring the client's experience.

Bottleneck identification:

  • Analyze time spent at each onboarding stage to identify where applications stall
  • Common bottlenecks: identity verification failures (especially for non-US persons), missing trust documents, client delays in completing e-signature, custodian processing backlogs, compliance review queues
  • Implement dashboards showing pipeline status: how many applications are at each stage, average time per stage, aging applications

Optimization strategies:

  • Reduce data entry — pre-populate from CRM, use OCR for document data extraction, integrate with bank verification services (Plaid, Yodlee) for funding
  • Validate early — run real-time validation checks as data is entered rather than waiting for custodian submission; catch NIGO-causing errors before documents are signed
  • Parallelize where possible — run identity verification while the client completes the suitability questionnaire; generate documents while waiting for verification results
  • Design mobile-first — clients increasingly complete onboarding on mobile devices; forms must be responsive and signature flows must work on small screens
  • A/B test onboarding flows — test different question orders, form layouts, and communication cadences to reduce abandonment
  • Automate follow-up — send automated reminders for incomplete applications, unsigned documents, and unfunded accounts

Worked Examples

Three worked examples are in references/examples.md — load for an end-to-end scenario: (1) designing a digital onboarding flow for individual taxable accounts with Schwab/Salesforce/Orion integration, (2) onboarding an irrevocable trust account for a high-net-worth client alongside individual accounts, (3) reducing a 35% NIGO rate through validation rules and automated document assembly.

Common Pitfalls

  • Opening an account before identity verification is complete — CIP must be satisfied before or at account opening, not after
  • Collecting suitability data but not documenting it in a format that satisfies regulatory requirements — the profile must be written, signed or acknowledged, and retained
  • Using a one-size-fits-all document package rather than dynamically assembling documents based on account type and features
  • Not screening all associated individuals (co-owners, trustees, beneficial owners, authorized signers) against OFAC — screening only the primary account holder is insufficient
  • Allowing the onboarding flow to proceed past compliance gates when a checkpoint fails — soft gates that can be bypassed undermine the compliance framework
  • Assuming e-signatures are universally accepted — certain custodians and form types still require wet signatures
  • Not maintaining a mapping between risk questionnaire scores and model portfolios, leading to inconsistent investment recommendations across advisors
  • Failing to validate data consistency before custodian submission, resulting in high NIGO rates
  • Treating entity and trust onboarding the same as individual onboarding — these account types require substantially more documentation, verification, and review
  • Not linking multiple accounts opened for the same client into a single household, causing fragmented client data across CRM and PMS
  • Neglecting the funding step — an opened but unfunded account generates no revenue and may be closed by the custodian after an inactivity period
  • Collecting beneficial ownership information but not verifying the identities of the beneficial owners, violating the CDD Rule's verification requirement

Cross-References

  • know-your-customer (compliance plugin): KYC/CIP requirements that the onboarding identity verification stage must satisfy; the KYC skill defines the regulatory standards, and this skill describes how to implement them in an onboarding workflow
  • investment-suitability (compliance plugin): Suitability data collection during onboarding provides the foundation for all subsequent investment recommendations; the suitability skill defines the regulatory obligations, and this skill covers how to gather the required data
  • anti-money-laundering (compliance plugin): OFAC screening and AML checks are embedded compliance gates in the onboarding flow; the AML skill covers the regulatory framework, and this skill describes the integration points
  • reg-bi (compliance plugin): Reg BI disclosure and care obligations must be satisfied at or before account opening; Form CRS delivery is a required onboarding step for broker-dealers and RIAs
  • client-disclosures (compliance plugin): Disclosure documents (Form ADV, Form CRS, privacy notice, prospectus) must be delivered during onboarding at prescribed trigger points
  • crm-client-lifecycle (advisory-practice plugin): The CRM receives client and household data from the onboarding process; onboarding creates the client master record that CRM manages throughout the relationship
  • portfolio-management-systems (advisory-practice plugin): The PMS receives new accounts from onboarding for model portfolio assignment and initial investment execution
  • privacy-data-security (compliance plugin): Onboarding collects sensitive nonpublic personal information (SSN, financial data, identity documents) that must be protected under Reg S-P and firm cybersecurity policies
  • account-opening-workflow (client-operations plugin): Back-office account opening process that receives onboarding outputs; handles operations processing, custodian submission, and account activation
  • estate-gifting (wealth-management plugin): background on trust types and beneficiary designations relevant when opening and titling trust accounts

© JoelLewis, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in plugins/advisory-practice/skills/client-onboarding of JoelLewis/finance_skills.

  • SKILL.md
  • references/examples.md

Open the folder on GitHubat commit 5c498ea

Compare with similar skills

Client Onboarding next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Client Onboarding compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Client Onboarding this skillJoelLewis/finance_skills205—~8kAutomated safety check: PassMIT
Brand Product Knowledge Builderlimecloud/lime1.5k—~709Automated safety check: PassApache-2.0
Cc10x Guideromiluz13/cc10x164—~2.2kAutomated safety check: PassMIT
Yao Geo Intent Mineryaojingang/yao-geo-skills868—~500Automated safety check: PassMIT
Faq CollectorCherryHQ/cherry-studio52k—~154Automated safety check: PassAGPL-3.0
Eol Internal Enablementdeanpeters/Product-Manager-Skills7.2k—~3.1kAutomated safety check: PassCustom licence

Similar skills

  • 将品牌产品资料、规格参数、卖点证据、FAQ、价格权益、竞品区别和合规边界,整理成符合 Agent Knowledge v0.6 document-first 标准、可被 AI 安全调用的产品资料知识库。适用于用户要求“整理产品知识库”“沉淀产品 FAQ”“把品牌产品资料变成项目资料”“维护产品资料包”的场景。

    1.5k GitHub stars~709 tokensUpdated yesterday
    Sales & SupportAuto-check passed
  • Cc10x Guide

    romiluz13/cc10x

    Answers questions about cc10x itself — what it is, how to install and configure it, how the router, workflows, memory, and hooks operate, and how to troubleshoot.

    164 GitHub stars~2.2k tokensUpdated yesterday
    Sales & SupportAuto-check passed
  • Yao Geo Intent Miner

    yaojingang/yao-geo-skills

    A skill your agent uses when a user asks for GEO 意图拓词、AI 搜索意图挖掘、AI 搜索问题集、问题簇、追问链路、查询重写、内容选题库、FAQ 题库、监测 Prompt 库, or AI Intent Miner.

    868 GitHub stars~500 tokensUpdated 8 days ago
    Sales & SupportAuto-check passed
  • Faq Collector

    CherryHQ/cherry-studio

    将成功解决的用户问题收录到 FAQ 知识库。问题解决后自动判断是否收录。也可以在用户说"收录到 FAQ"、"记录这个问题"、"add to FAQ"时手动触发。

    52k GitHub stars~154 tokensUpdated today
    Sales & SupportAuto-check passed
  • Eol Internal Enablement

    deanpeters/Product-Manager-Skills

    Build the support FAQ, sales talking points, and objection handling teams need before an EOL announcement.

    7.2k GitHub stars~3.1k tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed
  • Satisfaction Feedback

    Harryoung/efka

    Handle user satisfaction feedback. An agent skill from Harryoung/efka.

    104 GitHub stars~346 tokensUpdated 6 mo ago
    Sales & SupportAuto-check passed

More from JoelLewis/finance_skills

All 91 skills in this repo
  • Equities

    JoelLewis/finance_skills

    Analyze equity securities, factor models, and equity portfolio construction.

    205 GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed
  • Asset Allocation

    JoelLewis/finance_skills

    Determine how to distribute capital across asset classes using strategic and tactical allocation frameworks.

    205 GitHub stars~2.5k tokensUpdated 2 mo ago
    Auto-check passed
  • Bet Sizing

    JoelLewis/finance_skills

    Determine how much capital to allocate to individual positions within a portfolio.

    205 GitHub stars~2.5k tokensUpdated 2 mo ago
    Auto-check passed
  • Commodities

    JoelLewis/finance_skills

    Analyze commodity markets including futures curve dynamics, roll yield, and supply/demand fundamentals.

    205 GitHub stars~1.9k tokensUpdated 2 mo ago
    Auto-check passed
  • Currencies And Fx

    JoelLewis/finance_skills

    Analyze currency markets, exchange rate mechanics, and FX risk management for international portfolios.

    205 GitHub stars~1.9k tokensUpdated 2 mo ago
    Auto-check passed
  • Debt Management

    JoelLewis/finance_skills

    Provide frameworks for managing and paying off personal debt effectively.

    205 GitHub stars~2.5k tokensUpdated 2 mo ago
    Auto-check passed

Categories

Questions about Client Onboarding

What does Client Onboarding do?

Design and implement end-to-end client onboarding workflows from prospect intake through funded account, covering KYC verification, document collection, e-signature, and custodian submission. Client Onboarding is an agent skill from JoelLewis/finance_skills. Design and implement end-to-end client onboarding workflows from prospect intake through funded account, covering KYC verification, document collection, e-signature, and custodian submission.

When should I use Client Onboarding?

Client Onboarding fits situations like: the user asks about building a digital onboarding flow; integrating identity verification; reducing NIGO rejection rates; opening complex account types like trusts.

How do I install Client Onboarding in Claude Code?

Run `npx skills add JoelLewis/finance_skills --skill client-onboarding -a claude-code`. Or copy the skill folder (plugins/advisory-practice/skills/client-onboarding in JoelLewis/finance_skills) into .claude/skills/client-onboarding in your project. Claude Code loads it when a task matches its description.

How do I install Client Onboarding in Codex?

Run `npx skills add JoelLewis/finance_skills --skill client-onboarding -a codex`. Or copy the skill folder (plugins/advisory-practice/skills/client-onboarding in JoelLewis/finance_skills) into .agents/skills/client-onboarding in your project. Codex loads it when a task matches its description.

Can I use Client Onboarding in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add JoelLewis/finance_skills --skill client-onboarding -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/client-onboarding, .gemini/skills/client-onboarding, .github/skills/client-onboarding and .opencode/skills/client-onboarding in your project.

What does Client Onboarding need to run?

SKILL.md names no scripts, command-line tools or credentials: Client Onboarding is instructions for the agent only.

Does Client Onboarding access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Client Onboarding safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Client Onboarding use?

Client Onboarding is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Client Onboarding use?

About 8k tokens (SKILL.md is roughly 32k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.8k tokens, read only when the agent opens those files.

What are the alternatives to Client Onboarding?

Skills that share tags, products or a category with Client Onboarding: Brand Product Knowledge Builder (limecloud/lime, 1.5k stars), Cc10x Guide (romiluz13/cc10x, 164 stars), Yao Geo Intent Miner (yaojingang/yao-geo-skills, 868 stars) and Faq Collector (CherryHQ/cherry-studio, 52k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Client Onboarding?

JoelLewis (a GitHub user) maintains it in JoelLewis/finance_skills, which has 205 GitHub stars. The repository holds 91 skills in this directory. The repository was last updated on July 18, 2026.

Source: JoelLewis/finance_skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.