Skip to main content
skill CX Codex

know-your-customer — Claude Code skill: KYC at account opening

Walks your agent through KYC: identity verification, beneficial ownership, EDD for PEPs, and keeping the customer profile current.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add JoelLewis/finance_skills --skill know-your-customer -a claude-code
Open on GitHub

What know-your-customer does

This skill covers what has to be gathered before an account opens and how the customer profile gets maintained afterwards. It carries FINRA Rule 2090, the CIP requirements (31 CFR 1023.220) and FinCEN's CDD Rule (31 CFR 1010.230). Ask about identity verification, beneficial ownership collection for entity accounts, enhanced due diligence for PEPs or high-risk customers, the initial risk rating, or KYC refresh triggers, and the agent answers from those rules.

Documentary and non-documentary verification are treated separately. The first relies on an unexpired government photo ID or formation documents; the second on credit bureau checks, public database searches and financial statements. Non-documentary methods are the fallback when the customer never appears in person or the paperwork raises doubt.

One thing to watch: the regulatory status inside the skill is pinned to June 2026, and the text itself tells you to check effective dates, dollar thresholds and pending rulemakings against current SEC, FINRA and FinCEN sources before advising. So verify the numbers yourself rather than trusting the file. For transaction monitoring, SAR filing and risk re-rating driven by surveillance, the author points to a separate anti-money-laundering skill.

What it helps with

  • list the identity data needed for a new client
  • work out who the beneficial owners of an entity account are
  • assign an initial customer risk rating at onboarding
  • choose between documentary and non-documentary verification
  • decide when a customer profile needs refreshing

Example prompts for the agent

  • What information do we need before opening an account for a new client?
  • Who counts as a beneficial owner for an LLC account?
  • How often should we refresh KYC for a high-risk customer?

How to install know-your-customer

1Skills CLI (Vercel)

npx skills add JoelLewis/finance_skills --skill know-your-customer -a claude-code

2Manually: put the files in place

~/.claude/skills/know-your-customer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/know-your-customer/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about know-your-customer

How do I install know-your-customer in Claude?

Run npx skills add JoelLewis/finance_skills --skill know-your-customer -a claude-code. The skill file then sits at ~/.claude/skills/know-your-customer/SKILL.md.

What does know-your-customer do?

It guides the agent through KYC requirements: CIP identity verification, beneficial ownership collection, enhanced due diligence for PEPs and high-risk customers, the initial risk rating, and profile refresh triggers.

How is it different from anti-money-laundering?

know-your-customer handles onboarding and profile maintenance. Transaction monitoring, SAR filing and surveillance-driven risk re-rating belong to the anti-money-laundering skill.

Source text

SKILL.md · MIT
---
name: know-your-customer
description: "Guide customer onboarding identification, due diligence, and profile maintenance under FINRA Rule 2090, the CIP rules, and the FinCEN CDD Rule. Use when the user asks about onboarding identity verification, beneficial ownership collection for entity accounts, enhanced due diligence for PEPs or high-risk customers at account opening, assigning the initial customer risk rating, KYC refresh triggers, or documentary vs non-documentary verification. Also trigger when users mention 'account opening requirements', 'who is the beneficial owner', 'new client identity check', 'how often to update KYC', 'essential facts for the account', 'foreign customer onboarding', or ask what information must be gathered before opening an account. (For ongoing transaction monitoring, SAR filing, and surveillance-driven risk re-rating, use anti-money-laundering.)"
---

# Know Your Customer

Regulatory status current as of June 2026 — verify effective dates, dollar thresholds, and pending rulemakings against current SEC/FINRA/FinCEN sources before advising.

## Core Concepts

### FINRA Rule 2090 — Know Your Customer
Every FINRA member must use reasonable diligence, with regard to the opening and maintenance of every account, to know and retain the essential facts concerning every customer and concerning the authority of each person acting on behalf of the customer. "Essential facts" are those required to: (a) effectively service the account, (b) act in accordance with any special handling instructions, (c) understand the authority of each person acting on behalf of the customer, and (d) comply with applicable laws, regulations, and rules.

### Customer Identification Program (CIP)
Required under USA PATRIOT Act Section 326 and implementing regulations. The broker-dealer CIP rule is **31 CFR 1023.220**; the bank CIP rule is 31 CFR 1020.220. (SEC Rule 17a-8 separately requires broker-dealers to comply with BSA recordkeeping and reporting.) The CIP must include:

- **Identity verification** for each customer opening an account: name, date of birth (for individuals), address, and identification number (SSN for US persons; passport number/country or other government ID for non-US persons)
- **Verification procedures** using documentary methods (government-issued ID), non-documentary methods (credit bureau checks, public database searches, financial statement review), or a combination
- **Recordkeeping** — retain identifying information and verification methods for 5 years after account closure
- **Comparison with government lists** — check customer names against OFAC and other government terrorist/sanctions lists
- **Customer notice** — inform customers that information is being collected to verify identity

### Customer Due Diligence (CDD) Rule
FinCEN's CDD Rule (31 CFR 1010.230, effective May 2018) requires covered financial institutions to:

1. **Identify and verify the identity of customers** (overlaps with CIP)
2. **Identify and verify the identity of beneficial owners of legal entity customers** — any individual who owns 25% or more of the equity interests, plus one individual with significant responsibility for managing the entity (a control person)
3. **Understand the nature and purpose of customer relationships** to develop a customer risk profile
4. **Conduct ongoing monitoring** to identify suspicious transactions and, on a risk basis, maintain and update customer information

The 25% beneficial ownership threshold applies to legal entities (corporations, LLCs, partnerships). Certain entities are exempt: publicly traded companies, regulated financial institutions, government entities, and others listed in the rule.

### Enhanced Due Diligence (EDD)
Higher-risk customers require additional scrutiny beyond standard CDD:

- **Politically Exposed Persons (PEPs)** — senior foreign political figures and their families/associates. No US regulatory definition mandates PEP screening for domestic customers, but FinCEN guidance and FATF standards expect it for foreign PEPs. Firms should understand the source of wealth and funds.
- **Foreign correspondent accounts** — BSA Section 312 requires EDD for correspondent accounts maintained for foreign financial institutions, with heightened requirements for institutions in jurisdictions of concern
- **High-risk jurisdictions** — countries identified by FATF, FinCEN advisories, or firm risk assessments as presenting elevated ML/TF risk
- **Complex ownership structures** — multi-layered entities, trusts with opaque beneficiary structures, nominee arrangements
- **Unusual account activity** — customers whose transaction patterns deviate significantly from expected activity based on their profile

EDD measures include: senior management approval for account opening, source of wealth/funds verification, more frequent account reviews, enhanced transaction monitoring, and ongoing negative media screening.

### Documentary vs Non-Documentary Verification
**Documentary methods:** Unexpired government-issued photo ID (driver's license, passport, state ID), documents showing formation of a legal entity (articles of incorporation, partnership agreement, trust instrument).

**Non-documentary methods:** Credit bureau inquiries, public database verification (Lexis-Nexis, etc.), financial statement verification, references from other financial institutions. Required as a backup when documentary verification is unavailable, inconclusive, or the customer is not physically present (e.g., online account opening).

Firms must use non-documentary methods in at least the following situations: (1) the customer opens an account without appearing in person, (2) the firm is not familiar with the documents presented, (3) other circumstances that increase risk.

### Ongoing Monitoring and Profile Updates
KYC is not a one-time event. Customer profiles must be updated when:

- **Material life events** occur (retirement, marriage/divorce, inheritance, job loss, significant health changes)
- **Account review triggers** fire (periodic reviews, risk-based reviews, transaction-triggered reviews)
- **Transaction patterns** deviate significantly from the established profile
- **The customer provides new information** that changes their investment profile
- **Regulatory changes** require additional information (e.g., new beneficial ownership requirements)

FINRA does not mandate a specific refresh cycle, but firms typically establish risk-based review schedules (e.g., annual review for high-risk accounts, every 3 years for standard risk).

### SEC Requirements for Investment Advisers
Investment advisers have a fiduciary duty to understand their clients, which creates KYC-like obligations independent of FINRA rules. Form ADV Part 2A describes the adviser's services and client relationships. The SEC expects advisers to gather sufficient information to fulfill their fiduciary duty of care — including financial situation, investment objectives, risk tolerance, and any constraints. FinCEN's 2024 final rule (31 CFR Part 1032) would extend BSA/AML program and SAR requirements to SEC-registered investment advisers, but its effective date was postponed from January 1, 2026 to January 1, 2028, and FinCEN has said it will revisit the rule's substance (and the companion proposed adviser CIP rule, jointly with the SEC) before then — verify current status.

### Recordkeeping Requirements
- **CIP records:** Identifying information, verification documents/methods, and resolution of discrepancies must be retained for 5 years after account closure
- **CDD/beneficial ownership:** Copies of beneficial ownership certification forms and verification records retained for 5 years after account closure
- **Account records:** FINRA Rule 4512 requires maintenance of customer name, tax ID, address, date of birth, employment status, associated person relationship, trusted contact person, and other information specified in the rule
- **Reliance on other institutions:** Under Section 326 reliance provisions, a firm may rely on another financial institution's CIP if: (a) the relying firm's CIP incorporates this reliance, (b) the other institution is subject to an AML program rule, and (c) the other institution enters into a written contract for this purpose

## Worked Examples

### Example 1: Opening a trust account without identifying beneficial owners
**Scenario:** A wealth management firm opens a revocable living trust account for a family trust. The account opening team collects the trust agreement and identifies the grantor/trustee but does not collect beneficial ownership information on the trust beneficiaries. The trust holds $2M in investable assets.
**Compliance Issues:** Potential CDD Rule violation. While revocable living trusts are generally exempt from the beneficial ownership requirement (since the grantor maintains control), irrevocable trusts and other legal entity structures require beneficial ownership identification. The team must correctly classify the trust type. Additionally, FINRA Rule 4512 requires identification of all persons authorized to transact in the account.
**Analysis:** The firm should have a clear trust classification workflow that determines: (1) whether beneficial ownership requirements apply based on the trust type, (2) who has authority to act on the account, and (3) what documentation is required. For revocable trusts, identifying the grantor/trustee as the beneficial owner and control person is typically sufficient, but the firm should verify the trust is truly revocable and document the determination. The trust agreement must be reviewed — not just collected.

### Example 2: Failing to update KYC after a client retires
**Scenario:** A long-standing client retires at age 65 after 20 years at the firm. Her account profile still lists her investment objective as "aggressive growth," risk tolerance as "high," and annual income at $250,000. Post-retirement, her income drops to $80,000 (Social Security and pension) and she begins taking regular distributions from the account. No profile update is triggered.
**Compliance Issues:** Stale KYC data leading to potential suitability violations. The client's investment profile has materially changed — time horizon has shifted, income has declined, liquidity needs have increased (regular distributions), and risk capacity has decreased. Continued aggressive growth recommendations based on outdated profile data would likely violate suitability obligations.
**Analysis:** The firm should have systems that flag material life events (age milestones, distribution patterns, income changes) as triggers for KYC refresh. A representative who knows a client has retired but does not update the profile is failing the "reasonable diligence" standard of Rule 2090. Best practice: establish automated triggers (client turns 65, regular withdrawals begin, account balance drops significantly) and require profile confirmation at each periodic review.

### Example 3: Onboarding a high-risk foreign entity
**Scenario:** A broker-dealer receives an account application from a newly formed LLC registered in Delaware with a single listed owner who is a citizen of a jurisdiction flagged in a FinCEN advisory. The stated purpose is "general investing." The LLC provides articles of organization but limited information about the source of funds.
**Compliance Issues:** Multiple red flags requiring enhanced due diligence: newly formed entity, high-risk jurisdiction connection, limited transparency on source of funds, Delaware LLC (common in layering structures). Standard CDD is insufficient.
**Analysis:** The firm must: (1) complete standard CDD including beneficial ownership (25% owners and one control person), (2) escalate to enhanced due diligence given the risk factors, (3) verify source of funds and source of wealth, (4) conduct OFAC screening on all identified individuals, (5) obtain senior management approval before opening, (6) establish enhanced ongoing monitoring. The firm should also consider whether the limited information provided is itself a red flag warranting a SAR filing or account refusal. Simply accepting "general investing" as a purpose statement for a high-risk entity is insufficient.

## Common Pitfalls
- Treating KYC as a one-time account-opening exercise rather than an ongoing obligation
- Collecting but not verifying beneficial ownership information — the CDD Rule requires both identification and verification
- Applying the same due diligence to all customers regardless of risk — risk-based approach is required
- Not documenting when a customer declines to provide information and failing to narrow the recommendation universe accordingly
- Relying solely on documentary verification for online/remote account opening without implementing non-documentary backup methods
- Failing to establish automated triggers for profile refresh (life events, transaction anomalies, age milestones)
- Not screening beneficial owners and control persons against OFAC and other sanctions lists
- Confusing the CDD Rule's beneficial ownership requirements with FINRA Rule 4512's account record requirements — they overlap but are distinct
- Incomplete trust classification leading to incorrect application of beneficial ownership requirements
- Not training frontline staff to recognize when a customer's circumstances have changed, triggering a profile update obligation

## Cross-References
- **anti-money-laundering** (compliance plugin): KYC/CDD data feeds directly into AML monitoring and suspicious activity detection
- **investment-suitability** (compliance plugin): Customer profile gathered through KYC is the foundation for suitability analysis
- **reg-bi** (compliance plugin): Reg BI's Care Obligation requires understanding the customer's investment profile — sourced from KYC
- **investment-policy** (wealth-management plugin): IPS constraints (time horizon, risk tolerance, liquidity) derive from KYC profiling
- **account-opening-compliance** (client-operations plugin): The onboarding compliance workflow that operationalizes CIP verification, CDD, and beneficial ownership collection defined here
- **account-opening-workflow** (client-operations plugin): The operational account opening process where KYC data collection and verification are embedded

© JoelLewis · MIT · JoelLewis/finance_skills

Similar skills

Everything for Finance and business →

From the same set59

anti-money-laundering An agent skill that walks through BSA/AML work: CTR and SAR thresholds, OFAC screening, structuring detection, FinCEN filing rules. CX Codex +1 685installs digital-assets A skill that gives your agent a reference on crypto fundamentals, blockchain mechanics, DeFi protocols and on-chain metrics. Handy for staking math or token valuation. CX Codex +1 683installs tax-loss-harvesting Runs the full tax-loss harvesting cycle: finding candidates, budgeting gains and losses, picking a replacement, and staying clear of wash sales. CX Codex +1 683installs next-best-action This skill designs next-best-action engines that watch client data for portfolio, life, market and compliance events and tell advisors what to do next. CX Codex +1 680installs fixed-income-sovereign Prices Treasury bonds, builds the yield curve, and works out duration, convexity and DV01. Useful when you need rate risk numbers instead of hand-waving. CX Codex +1 678installs settlement-clearing A skill covering trade settlement and clearing: the T+1 cycle, DTC/NSCC/FICC infrastructure, CNS netting, settlement fails and buy-in procedures. CX Codex +1 669installs performance-attribution Splits portfolio return into explainable pieces: how much came from sector weights, how much from stock picking inside them. Useful when you need to know why a portfolio beat or missed its benchmark. CX Codex +1 668installs client-onboarding Walks you through building a client onboarding flow from prospect intake to a funded account: KYC, documents, e-signature, custodian submission. CX Codex +1 670installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor