Agent skill

Fee Billing

by JoelLewis in JoelLewis/finance_skills

Build and manage advisory fee billing operations from fee schedule design through calculation, collection, revenue recognition, and compliance disclosure.

MITAuto-check passedDocuments & Office

Install Fee Billing

skills CLI
$ npx skills add JoelLewis/finance_skills --skill fee-billing -a claude-code

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

GitHub CLI
$ gh skill install JoelLewis/finance_skills fee-billing --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/fee-billing .claude/skills/fee-billing && 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
fee-billing
GitHub stars
206
Token cost
~6.8k tokens
SKILL.md length
3,572 words
Files
2 (incl. references)
Skills in repo
91
Repo updated
First seen
Licence
MIT

At a glance

Build and manage advisory fee billing operations from fee schedule design through calculation, collection, revenue recognition, and compliance disclosure.

  • Works in 9 steps: Fee Schedule Structures → AUM Valuation for Billing → Billing Cycle Mechanics → …
  • The user asks about tiered
  • 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

Fee Billing is an agent skill from JoelLewis/finance_skills. Build and manage advisory fee billing operations from fee schedule design through calculation, collection, revenue recognition, and compliance disclosure. Use when the user asks about tiered or breakpoint fee schedules, billing cycle configuration, AUM valuation for billing, direct-debit vs invoice collection, GAAP revenue recognition for fees, ADV Part 2A or Reg BI fee disclosure, diagnosing billing exceptions or refunds, migrating from spreadsheet billing to automated systems, or forecasting advisory revenue…

Its SKILL.md is about 6.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 Documents & Office, covering Responsive design, Forecasting and time series and Excel spreadsheets. 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 tiered
  • Breakpoint fee schedules
  • Billing cycle configuration
  • AUM valuation for billing

Example prompts

  • “fee calculation”
  • “billing engine”
  • “effective fee rate”
  • “/fee-billing”

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Fee Schedule Structures
  2. AUM Valuation for Billing
  3. Billing Cycle Mechanics
  4. Fee Calculation Engine
  5. Collection Methods
  6. Billing Exceptions and Adjustments
  7. Revenue Recognition
  8. Compliance and Disclosure
  9. Billing System Architecture

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

Fee Billing loads about 6.8k tokens when it runs, and up to ~9.2k if it reads all its reference files. Until then it costs about 188 tokens; SKILL.md has 3,572 words of instructions outside code blocks.

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

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,572 words, ~6,797 tokens.

Download SKILL.mdSave it as .claude/skills/fee-billing/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
fee-billing
description
Build and manage advisory fee billing operations from fee schedule design through calculation, collection, revenue recognition, and compliance disclosure. Use when the user asks about tiered or breakpoint fee schedules, billing cycle configuration, AUM valuation for billing, direct-debit vs invoice collection, GAAP revenue recognition for fees, ADV Part 2A or Reg BI fee disclosure, diagnosing billing exceptions or refunds, migrating from spreadsheet billing to automated systems, or forecasting advisory revenue. Also trigger when users mention 'fee calculation', 'billing engine', 'effective fee rate', 'household billing aggregation', 'mid-period adjustment', 'billing in advance vs arrears', 'fee compression', or 'ERISA 408(b)(2)'.

Fee Billing

Core Concepts

1. Fee Schedule Structures

Advisory firms employ a range of fee structures, often combining several within a single practice.

Flat Fee (Fixed Dollar). A predetermined dollar amount charged per period regardless of account size. Common for financial planning engagements or retainer-based advice. Straightforward to bill but disconnected from asset growth.

AUM-Based (Percentage of Assets). The most prevalent model for registered investment advisers. A single percentage (e.g., 1.00%) is applied to the market value of managed assets. Simple to communicate but can become expensive for large portfolios and cheap for small ones.

Tiered / Breakpoint (Declining Rate). A graduated schedule where successive tiers of assets are billed at progressively lower rates. For example:

TierAUM RangeAnnual Rate
1First $500,0001.00%
2Next $500,0000.80%
3Next $1,000,0000.60%
4Over $2,000,0000.40%

Under a true tiered schedule each dollar is billed at the rate for the tier it falls within. Under a breakpoint schedule the entire balance is billed at the rate corresponding to the highest tier reached. The distinction matters significantly for large accounts and must be clearly defined in the advisory agreement.

Flat-Plus-AUM Hybrid. Combines a fixed planning fee with a lower AUM percentage. Useful for firms that want to be compensated for planning work independently of portfolio size.

Hourly. Charges based on advisor time. Rarely used as the sole billing method for ongoing relationships but common for project-based planning engagements.

Financial Planning Fees. One-time or recurring fees for plan creation and updates, often billed separately from investment management fees.

Performance-Based Fees. Permitted only for "qualified clients" under SEC Rule 205-3. Under the SEC's 2026 inflation adjustment (order issued April 2026, effective June 29, 2026), a qualified client must have at least $1.4 million in AUM with the adviser or a net worth exceeding $2.7 million — up from the $1.1 million / $2.2 million thresholds set in 2021. The SEC adjusts these thresholds for inflation every five years, and prior thresholds generally continue to apply to pre-existing contracts; verify current values. Requires a high-water mark or similar mechanism to prevent double-charging after drawdowns. Rarely used by typical RIAs due to complexity and regulatory constraints.

Family / Household Billing Aggregation. Assets across related accounts (spouses, trusts, custodial accounts, IRAs) are combined for fee-tier determination, then the calculated fee is allocated back to individual accounts. This gives the household the benefit of breakpoint pricing. The aggregation definition (who qualifies as "household") must be documented in the advisory agreement.

2. AUM Valuation for Billing

The accuracy and consistency of AUM valuation directly determines billing accuracy.

Valuation Date Selection. The most common approaches are:

  • Quarter-end value: Assets valued as of the last business day of the billing quarter. Simple and widely used.
  • Prior quarter-end value: Assets valued as of the end of the preceding quarter. Avoids billing on unrealized gains or losses that occurred during the period just ended. Common for advance billing.
  • Period average: The average of daily or month-end values across the billing period. Smooths volatility but is operationally complex.

Market Value vs. Cost Basis. Nearly all advisory agreements specify market value. Cost basis would understate the true value being managed and is almost never used.

Held-Away Assets. Assets the adviser monitors but that are not custodied at the primary custodian (e.g., 401(k) plans, outside brokerage accounts, annuities). Whether these are included in the billable AUM depends on the advisory agreement. If included, obtaining timely and accurate valuations is a persistent operational challenge.

Accrued Income. Bond accrued interest and declared but unpaid dividends may be included or excluded. Most custodian feeds include accrued interest in the total market value, so the default is typically inclusion unless the fee schedule specifies otherwise.

Margin Debit Treatment. If a client uses margin, the question arises whether to bill on gross assets or net equity. The advisory agreement should specify. Most firms bill on net equity (gross market value minus margin balance).

Cash Inclusion / Exclusion. Some agreements exclude cash or money market positions from billable AUM, particularly if the adviser is not actively managing those balances. This is uncommon but must be handled when present.

New Account Proration. Accounts opened mid-period require proration. The standard method is to calculate the fee based on the number of days the account was open relative to the total days in the billing period. Some firms use a simpler approach and bill for the partial quarter only if the account was opened before the midpoint of the period.

3. Billing Cycle Mechanics

Quarterly Billing. The dominant cycle for RIAs. Billing quarters typically align with calendar quarters (Jan-Mar, Apr-Jun, Jul-Sep, Oct-Dec), though some firms use fiscal quarters.

Monthly Billing. Less common for investment management but used for financial planning retainers or firms that want to smooth revenue. Requires more operational overhead.

Annual Billing. Occasionally used for flat-fee or financial-planning-only arrangements. May be billed as a single payment or split into installments.

Advance vs. Arrears Billing.

  • Advance (in advance): Fees are billed at the start of the period for services to be rendered. Creates a deferred revenue liability on the firm's balance sheet. Requires refund calculation for accounts terminated mid-period. Most common for RIAs.
  • Arrears (in arrears): Fees are billed at the end of the period for services already rendered. Simpler from a revenue-recognition standpoint (revenue is earned when billed) but delays cash collection. Growing in popularity due to its alignment with the service delivery timeline.

Pro-Ration Rules. Events requiring proration include:

  • Account openings mid-period
  • Account closings or terminations mid-period
  • Large contributions (some firms apply a materiality threshold, e.g., only prorate for contributions exceeding $10,000 or 10% of account value)
  • Large withdrawals (same materiality threshold logic)
  • Transfers between accounts within the same household (should be revenue-neutral)

The standard proration formula is:

Prorated Fee = Full-Period Fee * (Days in Period Account Was Active / Total Days in Period)

Billing Period Alignment. When a firm converts billing cycles (e.g., from quarterly to monthly), a transition period is needed. Clients should not be double-billed or under-billed during the switch. A reconciliation calculation comparing what was billed under the old cycle against what is owed under the new cycle is essential.

4. Fee Calculation Engine

A systematic fee calculation follows these steps:

Step 1: Determine Household Composition. Identify all accounts linked to the billing household. Include all account types per the advisory agreement (individual, joint, IRA, Roth IRA, trust, UGMA/UTMA, entity accounts).

Step 2: Retrieve Account Valuations. Pull market values as of the valuation date from the custodian or portfolio management system. Apply any exclusions (cash exclusion, held-away asset inclusion, margin debit netting).

Step 3: Aggregate Household AUM. Sum the billable market values across all accounts in the household to determine the household-level AUM for tier determination.

Step 4: Apply Fee Schedule. Using the household's assigned fee schedule, calculate the annual fee. For a tiered schedule:

Household AUM: $1,800,000
Tier 1: $500,000 * 1.00% = $5,000
Tier 2: $500,000 * 0.80% = $4,000
Tier 3: $800,000 * 0.60% = $4,800
Annual Fee: $13,800
Effective Rate: 0.767%

Step 5: Convert to Billing Period. Divide the annual fee by the number of billing periods (4 for quarterly, 12 for monthly).

Quarterly Fee: $13,800 / 4 = $3,450

Step 6: Apply Overrides and Adjustments. Check for negotiated rate overrides, minimum fee floors, fee caps, waivers, or credits. Apply in the correct order (typically: calculate standard fee, then apply negotiated rate, then apply minimum, then apply cap, then apply waivers).

Step 7: Allocate to Accounts. Distribute the household fee across individual accounts, typically pro-rata by market value:

Account A ($900,000 / $1,800,000) = 50% * $3,450 = $1,725.00
Account B ($500,000 / $1,800,000) = 27.78% * $3,450 = $958.33
Account C ($400,000 / $1,800,000) = 22.22% * $3,450 = $766.67

Step 8: Apply Proration. For any accounts opened or closed mid-period, prorate the allocated fee.

Step 9: Rounding. Apply consistent rounding rules (typically round to the nearest cent). Ensure rounding differences are allocated to a designated account (usually the largest) so the sum of account-level fees equals the household fee exactly.

Step 10: Generate Billing Output. Produce the custodian debit instruction file or invoice, the billing detail report, and the audit trail record.

Minimum Fee Application. Many firms set a minimum quarterly or annual fee (e.g., $250/quarter). If the calculated fee falls below the minimum, the minimum is charged instead. This should be applied at the household level, not the account level.

Fee Cap Application. Less common but sometimes offered to attract large accounts. A cap ensures the dollar fee does not exceed a maximum regardless of AUM growth.

Negotiated Rate Overrides. Individual clients or households may have rates that differ from the published fee schedule. The billing system must support per-household or per-account rate overrides while maintaining an audit trail of who authorized the deviation and when.

Rounding Rules. Define and document the rounding convention. Typical practice rounds each account fee to the nearest cent. Allocate any remainder (positive or negative) from rounding to the largest account in the household.

5. Collection Methods

Direct Debit from Custodian Account. The most common method for RIAs. The adviser sends fee debit instructions to the custodian (Schwab, Fidelity, Pershing, etc.), and the custodian debits the client's account directly. Requires:

  • Written authorization in the advisory agreement or a separate billing authorization form
  • Custodian-specific file format (varies by custodian; typically CSV or fixed-width)
  • Submission within the custodian's billing window (often the first 10-15 business days of the quarter)
  • The custodian sends a statement to the client showing the fee deduction, providing a layer of independent oversight

Invoice Billing. The adviser sends an invoice and the client pays by check, wire, or ACH. More common for institutional clients, financial planning fees, or clients who prefer not to authorize direct debits. Increases accounts receivable management burden.

Split Billing Across Accounts. When a household has multiple accounts, the fee can be debited from each account in proportion to its share of the household AUM (the most common approach) or debited entirely from one designated account.

Billing from Specific Accounts. Some clients designate a specific account for fee payment. Common when clients prefer fees to come from a taxable account (for potential tax deductibility) rather than a retirement account.

Tax-Advantaged Account Billing Considerations. Fees can be debited from IRAs and other tax-advantaged accounts, but there are considerations:

  • IRA fee debits are not treated as distributions if the fee is for investment management of the IRA assets
  • If the fee covers services beyond the IRA (e.g., financial planning for the household), the debit may be treated as a distribution
  • Some practitioners recommend paying fees from taxable accounts when possible because the fee payment from an IRA reduces the tax-advantaged balance, whereas paying from a taxable account may be deductible (subject to limitations)
  • ERISA plan accounts have additional rules under DOL guidance

Third-Party Billing. When the adviser bills through a TAMP (Turnkey Asset Management Platform) or sub-advisory arrangement, the TAMP may handle billing and remit the adviser's share. The adviser must reconcile the revenue received against the expected calculation.

6. Billing Exceptions and Adjustments

Fee Waivers. Common categories include:

  • Employee and employee-family accounts (full or partial waiver)
  • Charitable organization accounts (reduced rate or full waiver)
  • Pro bono or scholarship accounts
  • Accounts below a size threshold during an initial ramp-up period

All waivers should be documented with authorization and expiration (if applicable).

Negotiated Rates. Large clients or those with longstanding relationships may receive custom rates below the standard schedule. The billing system must store the effective date, the negotiated schedule, and the approving authority.

Legacy Fee Schedules. When a firm updates its published fee schedule, existing clients may be grandfathered on the old schedule. The billing system must support multiple active fee schedules concurrently. Over time, legacy schedules create operational complexity and should be periodically reviewed for consolidation.

Retroactive Adjustments. Occur when an error is discovered after billing has been processed. The adjustment should be applied in the next billing cycle (credit or additional debit) with clear documentation of the original error, the corrected calculation, and the net adjustment.

Billing Disputes. When a client disputes a fee, the process should include:

  1. Immediate acknowledgment of the dispute
  2. Detailed recalculation and documentation
  3. Resolution within a defined timeframe (e.g., 30 days)
  4. If the client is correct, issue a credit or refund
  5. Maintain a dispute log for compliance review

Refunds for Terminated Accounts. For advance-billed accounts, calculate the unearned portion of the fee from the termination date through the end of the billing period and issue a refund. The advisory agreement should specify the refund methodology.

Refund = Quarterly Fee * (Remaining Days / Total Days in Quarter)

Fee Reversals. Full reversal of a fee debit at the custodian level. Typically used when a billing error is caught within the custodian's reversal window (often same-day or next-day). After the reversal window, the correction must be handled as a retroactive adjustment.

Show full SKILL.md (1,526 more words)Show less
7. Revenue Recognition

GAAP Treatment: Advance Billing. When fees are billed at the start of a quarter, the firm recognizes a liability (deferred revenue or unearned fees) at the billing date. Revenue is then recognized ratably over the service period (the quarter). At the end of the quarter, all deferred revenue for that period has been earned and recognized.

GAAP Treatment: Arrears Billing. Revenue accrues over the service period. At the end of each month within the quarter, the firm recognizes one-third of the estimated quarterly fee as accrued revenue. When the fee is billed and collected at quarter-end, the accrual is reversed and replaced with recognized revenue.

Revenue Per Client Metrics. Key metrics include:

  • Average revenue per household
  • Average revenue per account
  • Revenue per advisor
  • Effective fee rate (total fees / total AUM) as a blended measure

Revenue Concentration Analysis. Regulators and business prudence demand awareness of concentration risk. If a single client or small group of clients represents a disproportionate share of revenue, the firm faces business risk. Common thresholds to monitor: no single household should exceed 5-10% of total revenue.

Revenue Forecasting. Forecast advisory revenue using:

  • Current AUM multiplied by the blended effective fee rate
  • Adjust for expected market appreciation or depreciation
  • Adjust for expected net new assets (organic growth) or attrition
  • Adjust for known fee schedule changes or renegotiations
  • Sensitivity analysis across bull, base, and bear market scenarios
8. Compliance and Disclosure

ADV Part 2A (Brochure) Fee Disclosure. Item 5 of Form ADV Part 2A requires clear disclosure of:

  • Fee schedules and how fees are calculated
  • Whether fees are negotiable
  • Billing frequency and collection method
  • Whether fees are billed in advance or arrears
  • Refund policy for terminated accounts
  • Other costs clients may bear (custodian transaction fees, fund expenses, etc.)

The disclosure must be sufficiently detailed that a client can understand the total cost of the advisory relationship.

Fee-on-Fee Issues. When an adviser charges an AUM-based fee on a portfolio that includes mutual funds or ETFs, the client pays both the advisory fee and the underlying fund expense ratio. This "fee on a fee" must be disclosed. Some advisers offset the fund expenses against the advisory fee or use the lowest-cost share classes available to mitigate this concern.

Total Cost of Ownership Disclosure. Best practice (and increasingly expected by regulators) is to present the client with a comprehensive view of all costs: advisory fees, fund expenses, custodian fees, transaction costs, and any other charges. This aligns with the SEC's guidance on adviser fiduciary duty.

Regulation Best Interest (Reg BI) Cost Considerations. For dual-registrant firms, Reg BI requires disclosure of material fees and costs and their impact on the client's investment. The cost comparison between advisory and brokerage accounts is a key element.

ERISA 408(b)(2) Fee Disclosure. For advisers serving retirement plans, ERISA Section 408(b)(2) requires detailed disclosure of all direct and indirect compensation received in connection with plan services. The disclosure must be provided before the engagement begins and updated within 60 days of any change.

Fee Reasonableness Documentation. Advisers should maintain documentation supporting the reasonableness of their fees. This includes periodic benchmarking against industry surveys (e.g., the annual RIA benchmarking studies from Schwab, Fidelity, or InvestmentNews), documentation of the services provided for the fee, and consideration of the client's total cost.

9. Billing System Architecture

Core Components:

  • Fee Schedule Repository. A database of all fee schedules (standard and negotiated), including effective dates, tier structures, and associated metadata. Must support versioning so historical calculations can be recreated.

  • Account/Household Master. Links accounts to billing households, assigns fee schedules, stores billing preferences (collection method, billing account designation, proration rules).

  • Valuation Engine. Retrieves or calculates account market values as of the billing date. Sources include custodian position files, portfolio management systems, and manual entries for held-away assets.

  • Calculation Engine. The core logic that executes the ten-step process described in Section 4. Must handle all fee schedule types, proration, overrides, minimums, caps, and rounding.

  • Custodian Debit Instruction Generator. Produces the custodian-specific file format for fee debits. Each custodian (Schwab, Fidelity, Pershing, TD Ameritrade legacy, etc.) has its own format requirements, submission deadlines, and reversal procedures.

  • Invoice Generator. For clients billed by invoice, produces statements with fee detail.

Integration Points:

  • Portfolio Management System (PMS). The billing system pulls valuations and account structure from the PMS. In some platforms (e.g., Orion, Black Diamond, Tamarac), the billing engine is integrated into the PMS.
  • Custodian. Bidirectional: the billing system sends debit instructions to the custodian and receives confirmation (or rejection) files back.
  • CRM. Fee schedule assignments and negotiated rates may be managed in the CRM and synchronized to the billing system.
  • Accounting System. Billing output feeds revenue entries in the firm's general ledger.

Billing Preview and Approval Workflow.

  1. The billing engine runs in preview mode, producing a billing preview report.
  2. Operations staff review the preview for anomalies (unusually large fees, negative fees, zero-dollar fees, fees that deviate significantly from the prior period).
  3. Exceptions are investigated and resolved.
  4. An authorized person approves the billing run.
  5. The engine generates the final debit instructions or invoices.
  6. Instructions are submitted to custodians.

Audit Trail. Every billing run must produce a complete audit trail including:

  • Valuation date and source
  • Fee schedule applied (with version identifier)
  • Household AUM and per-account AUM
  • Step-by-step calculation detail
  • Any overrides, waivers, or adjustments applied
  • The identity of the person who approved the billing run
  • Timestamp of submission to the custodian

Billing Reports. Standard reports include:

  • Billing summary by household (fee, effective rate, AUM)
  • Billing detail by account
  • Period-over-period comparison (fee change from prior quarter)
  • Exception report (new accounts, terminated accounts, large variances)
  • Revenue summary by advisor, team, or branch
  • Accounts receivable aging (for invoice-billed clients)

Worked Examples

See references/examples.md for three end-to-end worked examples — a quarterly tiered-fee calculation for a five-account household, mid-quarter proration for contributions/transfers/terminations, and a spreadsheet-to-automated billing migration. Load it when the user needs a full numerical walkthrough.

Common Pitfalls

  • Confusing tiered and breakpoint pricing. A tiered schedule charges each dollar at the rate for its tier. A breakpoint schedule charges the entire balance at the rate for the highest tier reached. Mixing these up leads to significant billing errors, especially for large accounts.
  • Failing to prorate for mid-period events. Not adjusting fees for material contributions, withdrawals, or account openings/closings results in overbilling or underbilling and invites client complaints.
  • Ignoring rounding allocation. When per-account fees are rounded independently, the sum may not equal the household fee. Without a systematic rounding allocation, small discrepancies accumulate and create reconciliation headaches.
  • Billing retirement accounts for non-retirement services. Debiting an IRA for advisory fees that cover financial planning or services unrelated to the IRA assets can trigger a taxable distribution. Always confirm that fees debited from tax-advantaged accounts correspond to services for those accounts.
  • Neglecting to update negotiated rates. When a fee schedule is updated but negotiated rate clients are forgotten, those clients may continue paying outdated rates indefinitely. Maintain a review cadence for all non-standard arrangements.
  • Inadequate disclosure of fee-on-fee costs. Failing to disclose that clients pay both the advisory fee and underlying fund expenses is a recurring SEC examination finding. Ensure ADV Part 2A and client communications address total cost clearly.
  • Missing the custodian billing window. Each custodian has a defined window for accepting fee debit instructions. Missing the window delays fee collection by an entire quarter and disrupts cash flow.
  • Not reconciling custodian confirmations. After submitting debit instructions, the custodian returns a confirmation file indicating which debits were processed and which were rejected (insufficient funds, account closed, etc.). Failing to review this file means rejected debits go uncollected.
  • Advance-billing refund errors on termination. When an advance-billed account terminates mid-quarter, the firm owes a prorated refund. Incorrect day-count calculations or failing to issue the refund entirely creates compliance risk and client ill will.
  • Overcomplicating household definitions. Overly broad household aggregation (e.g., including extended family members who are not part of the advisory relationship) can inflate tier benefits. Overly narrow definitions deprive clients of legitimate aggregation. The definition must match the advisory agreement.
  • Lack of billing audit trail. Without a detailed record of every calculation input and output, the firm cannot defend its billing in the event of a client dispute or regulatory examination.
  • Revenue recognition timing errors. Recognizing advance-billed fees as revenue immediately rather than deferring and recognizing ratably overstates revenue in the billing period and understates it in subsequent periods.

Cross-References

  • fee-disclosure (compliance plugin) — Detailed requirements for fee disclosure in client-facing documents and regulatory filings.
  • portfolio-management-systems (advisory-practice plugin) — Integration between billing engines and PMS platforms for valuation and account data.
  • advisor-dashboards (advisory-practice plugin) — Revenue metrics, billing status, and fee analytics displayed on advisor-facing dashboards.
  • client-reporting-delivery (advisory-practice plugin) — Inclusion of fee summaries and performance-net-of-fee figures in client reports.
  • investment-policy (wealth-management plugin) — Fee schedule terms as specified in the investment policy statement or advisory agreement.
  • reg-bi (compliance plugin) — Regulation Best Interest cost disclosure obligations for dual-registrant firms.
  • fiduciary-standards (compliance plugin) — Fiduciary duty to charge reasonable fees and act in the client's best interest regarding cost.
  • tax-efficiency (wealth-management plugin) — Tax implications of fee payment source (taxable vs. tax-advantaged accounts) and deductibility considerations.
  • performance-reporting (wealth-management plugin) — Gross-of-fee vs. net-of-fee performance calculation and the role of accurate fee data.

© 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/fee-billing of JoelLewis/finance_skills.

  • SKILL.md
  • references/examples.md

Open the folder on GitHubat commit 5c498ea

Compare with similar skills

Fee Billing 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.

Fee Billing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fee Billing this skillJoelLewis/finance_skills206—~6.8kAutomated safety check: PassMIT
Paginated Reportdata-goblin/power-bi-agentic-development1k—~3.5kAutomated safety check: PassGPL-3.0
Invoice Generatorluzhenqian/ai-coding-lab153—~955Automated safety check: PassNone
Statement Extract And ProveOneWave-AI/claude-skills336—~2.2kAutomated safety check: PassMIT
Executive Dashboard Generatormanojbajaj95/claude-gtm-plugin1052 repos~3.4kAutomated safety check: PassMIT
PDFIgorWarzocha/Opencode-Workflows122—~495Automated safety check: PassNone

Similar skills

  • Paginated Report

    data-goblin/power-bi-agentic-development

    Author, validate, publish, and test Power BI paginated reports in the RDL format.

    1k GitHub stars~3.5k tokensUpdated 3 days ago
    Documents & OfficeAuto-check passed
  • Invoice Generator

    luzhenqian/ai-coding-lab

    从 Excel 时间表或手动输入生成专业发票。当用户提到生成发票、创建账单、invoice、billing、开发票、时间表转发票、账单生成时使用此技能。

    153 GitHub stars~955 tokensUpdated 4 mo ago
    Documents & OfficeAuto-check passed
  • Statement Extract And Prove

    OneWave-AI/claude-skills

    Converts bank, credit card and brokerage statement PDFs, invoices and vendor price lists into clean CSV or Excel, then proves the extraction is complete and correct - opening balance plus…

    336 GitHub stars~2.2k tokensUpdated 8 days ago
    Documents & OfficeAuto-check passed
  • Executive Dashboard Generator

    manojbajaj95/claude-gtm-plugin

    Transform raw data from CSVs, Google Sheets, or databases into executive-ready reports with visualizations, key metrics, trend analysis, and actionable recommendations.

    105 GitHub starsUsed in 2 repos~3.4k tokens
    Documents & OfficeAuto-check passed
  • PDF

    IgorWarzocha/Opencode-Workflows

    Handle PDF manipulation, form filling, text/table extraction, and high-fidelity generation.

    122 GitHub stars~495 tokensUpdated 8 mo ago
    Documents & OfficeAuto-check passed
  • Trend Analysis

    MichaelYang-lyx/AIDABench

    基于多维度数据进行分级评估与趋势预测,通过设定差异化增长率计算预测值,并生成对比可视化图表,适用于绩效评估、目标设定等场景。

    111 GitHub starsUsed in 1 repo~818 tokens
    Data & AnalyticsAuto-check passed

More from JoelLewis/finance_skills

All 91 skills in this repo
  • Asset Allocation

    JoelLewis/finance_skills

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

    206 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.

    206 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.

    206 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.

    206 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.

    206 GitHub stars~2.5k tokensUpdated 2 mo ago
    Auto-check passed
  • Diversification

    JoelLewis/finance_skills

    Build diversified portfolios using correlation analysis, efficient frontier construction, and factor-based diversification.

    206 GitHub stars~2.3k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Fee Billing

What does Fee Billing do?

Build and manage advisory fee billing operations from fee schedule design through calculation, collection, revenue recognition, and compliance disclosure. Fee Billing is an agent skill from JoelLewis/finance_skills. Build and manage advisory fee billing operations from fee schedule design through calculation, collection, revenue recognition, and compliance disclosure.

When should I use Fee Billing?

Fee Billing fits situations like: the user asks about tiered; breakpoint fee schedules; billing cycle configuration; AUM valuation for billing.

How do I install Fee Billing in Claude Code?

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

How do I install Fee Billing in Codex?

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

Can I use Fee Billing 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 fee-billing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fee-billing, .gemini/skills/fee-billing, .github/skills/fee-billing and .opencode/skills/fee-billing in your project.

What does Fee Billing need to run?

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

Does Fee Billing 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 Fee Billing 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 Fee Billing use?

Fee Billing 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 Fee Billing use?

About 6.8k tokens (SKILL.md is roughly 27k 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.4k tokens, read only when the agent opens those files.

What are the alternatives to Fee Billing?

Skills that share tags, products or a category with Fee Billing: Paginated Report (data-goblin/power-bi-agentic-development, 1k stars), Invoice Generator (luzhenqian/ai-coding-lab, 153 stars), Statement Extract And Prove (OneWave-AI/claude-skills, 336 stars) and Executive Dashboard Generator (manojbajaj95/claude-gtm-plugin, 105 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fee Billing?

JoelLewis (a GitHub user) maintains it in JoelLewis/finance_skills, which has 206 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.