Agent skill

Portfolio Management Systems

by JoelLewis in JoelLewis/finance_skills

Select, configure, and operate portfolio management systems for advisory firms, covering model portfolios, UMA/sleeve management, drift monitoring, rebalancing, and custodian data feeds.

MITAuto-check passedBusiness, Finance & HR

Install Portfolio Management Systems

skills CLI
$ npx skills add JoelLewis/finance_skills --skill portfolio-management-systems -a claude-code

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

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

At a glance

Select, configure, and operate portfolio management systems for advisory firms, covering model portfolios, UMA/sleeve management, drift monitoring, rebalancing, and custodian data feeds.

  • Works in 10 steps: Portfolio Management System Architecture → Model Portfolio Management → Sleeve-Based and UMA Architecture → …
  • The user asks about choosing a PMS platform
  • 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

Portfolio Management Systems is an agent skill from JoelLewis/finance_skills. Select, configure, and operate portfolio management systems for advisory firms, covering model portfolios, UMA/sleeve management, drift monitoring, rebalancing, and custodian data feeds. Use when the user asks about choosing a PMS platform, building or distributing model portfolios, implementing UMA or sleeve-based management, setting drift monitoring thresholds, aggregating held-away assets, reconciling PMS with custodian records, configuring PMS-based billing, or troubleshooting custodian feed issues. Also…

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

It sits in Business, Finance & HR, covering Accounting and bookkeeping. 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 choosing a PMS platform
  • Distributing model portfolios
  • Implementing UMA
  • Sleeve-based management

Example prompts

  • “portfolio management system”
  • “Black Diamond”
  • “Tamarac”
  • “/portfolio-management-systems”

Workflow steps

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

  1. Portfolio Management System Architecture
  2. Model Portfolio Management
  3. Sleeve-Based and UMA Architecture
  4. Drift Monitoring and Rebalancing
  5. Held-Away Asset Aggregation
  6. Portfolio Accounting and Reconciliation
  7. Trading and Order Management Integration
  8. Performance Calculation Engine
  9. Billing and Fee Calculation
  10. Custodian Integration and Data Feeds

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

Portfolio Management Systems loads about 3.3k tokens when it runs, and up to ~13k if it reads all its reference files. Until then it costs about 191 tokens; SKILL.md has 1,516 words of instructions outside code blocks.

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

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). 1,516 words, ~3,270 tokens.

Download SKILL.mdSave it as .claude/skills/portfolio-management-systems/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
portfolio-management-systems
description
Select, configure, and operate portfolio management systems for advisory firms, covering model portfolios, UMA/sleeve management, drift monitoring, rebalancing, and custodian data feeds. Use when the user asks about choosing a PMS platform, building or distributing model portfolios, implementing UMA or sleeve-based management, setting drift monitoring thresholds, aggregating held-away assets, reconciling PMS with custodian records, configuring PMS-based billing, or troubleshooting custodian feed issues. Also trigger when users mention 'portfolio management system', 'Orion', 'Black Diamond', 'Tamarac', 'Addepar', 'Advent APX', 'model portfolio', 'sleeve management', 'rebalancing engine', 'custodian feed', or 'PMS migration'.

Portfolio Management Systems

Core Concepts

Expanded detail for each numbered section below lives in references/platform-details.md. Load it when the task needs: §1 the platform comparison table or IBOR/OBOR reconciliation dimensions; §2 full model specification, governance steps, or marketplace detail; §3 UMA cash-waterfall rules or the UMA/SMA/wrap comparison table; §4 drift measurement formulas, threshold configurations, or tax-aware rebalancing logic; §5 aggregation data sources and data-quality failure modes; §6 break-resolution workflow, corporate-action types, or cost basis methods; §8 daily vs. monthly calculation and benchmark tracking detail; §10 the custodian data-flow table, integration methods, and feed timing. (Reference §7 trading and §9 billing are pointers to the order-management-advisor and fee-billing skills — load those skills directly instead.)

1. Portfolio Management System Architecture

The PMS is the operational nerve center of an advisory practice, orchestrating data flow between custodians, trading platforms, reporting engines, CRM, and planning tools. Core functions include portfolio construction, model management, rebalancing, trading, performance reporting, and billing. Major platforms: Orion, Black Diamond, Tamarac, Addepar, Morningstar Direct, Advent/APX. The PMS serves as the firm's Investment Book of Record (IBOR), which must be reconciled daily against the custodian's Official Book of Record (OBOR).

2. Model Portfolio Management

Model portfolios define target allocations (asset classes, securities, weights) applied consistently across client accounts. Types include strategic (SAA), tactical (TAA overlays), and specialty models (income, ESG, tax-managed). Firms typically use a two-tier hierarchy (firm-level + advisor-customized). Model changes trigger versioning, account identification, trade proposal generation, and tax-aware transition. Third-party model marketplaces (BlackRock, DFA, Vanguard, PIMCO) allow smaller firms to access institutional-quality investment management.

3. Sleeve-Based and UMA Architecture

Unified Managed Accounts (UMAs) divide a single custodial account into virtual sub-accounts (sleeves), each following its own strategy or manager. Benefits: cross-sleeve tax optimization, simplified reporting, reduced account proliferation, and unified cash management. Cash waterfall rules govern deposits, withdrawals, and income allocation across sleeves. UMAs differ from SMAs (single-strategy, one manager) and mutual fund wraps (indirect ownership, limited customization). Typical minimums: $250K-$1M+.

4. Drift Monitoring and Rebalancing

Drift is the divergence of actual weights from targets caused by differential returns and cash flows. Measured as absolute drift (percentage-point difference) or relative drift (percentage of target). Threshold configurations range from conservative (3%/15%) to permissive (7%/30%). Rebalancing approaches: calendar-based, threshold-based, opportunistic (cash-flow-directed), and hybrid. Tax-aware rebalancing incorporates capital gains minimization, loss harvesting, wash sale avoidance, and gain budgets.

5. Held-Away Asset Aggregation

A complete client picture requires visibility into all assets, including employer plans, stock options, RSUs, bank accounts, and accounts at other custodians. Data sources: aggregation services (Plaid, Yodlee, MX, ByAllAccounts), custodian feeds, manual entry, and employer plan integrations. Challenges include data staleness, categorization errors, and broken connections. The PMS should provide both managed-only and total-household reporting views.

6. Portfolio Accounting and Reconciliation

Portfolio accounting tracks positions, transactions, cost basis, cash flows, and accrued income. Daily reconciliation compares PMS against custodian across three dimensions: positions, transactions, and cash. Breaks require classification, root-cause diagnosis, correction, and documentation. Common break sources: corporate actions (splits, mergers, spin-offs, DRIP), trade settlement timing, and data feed issues. Cost basis methods: specific identification, FIFO, and average cost.

7. Trading and Order Management Integration

The PMS generates trade proposals from model changes, rebalancing triggers, cash flows, and ad-hoc instructions. In larger firms, trades flow through a separate OMS for compliance checks, block aggregation, and execution routing. Block trading aggregates orders across accounts for best execution with pro-rata allocation. Pre-trade checks cover restricted securities, concentration limits, client restrictions, regulatory limits, and cash minimums. Implementation methods: direct custodian trading, third-party EMS, and mutual fund trading platforms.

8. Performance Calculation Engine

The PMS computes returns at multiple levels: security, sleeve, account, household, model, composite, and firm. TWR (time-weighted) eliminates cash flow impact for manager evaluation and GIPS compliance. MWR (money-weighted/IRR) reflects the investor's actual experience. Daily performance provides the most precise TWR; monthly uses approximations like Modified Dietz. Benchmarks (primary, blended, custom) must be tracked at the same frequency as portfolio returns.

9. Billing and Fee Calculation

Fee structures: AUM-based (flat or tiered/breakpoint), flat/retainer, performance-based (qualified clients only), and blended. Billing frequency: quarterly (most common), monthly, or annual. Advance billing requires proration; arrears billing delays revenue recognition. Billable AUM determination requires clear policies on included/excluded assets and household aggregation. Fee deduction via direct debit (most common) or invoice. Revenue tracking covers client, advisor, model, and strategy dimensions.

10. Custodian Integration and Data Feeds

Custodian integration provides the data backbone: positions, transactions, cash, cost basis, corporate actions, and new accounts flow from custodian to PMS; trade instructions and fee invoices flow from PMS to custodian. Integration methods: proprietary batch feeds (CSV/XML), FIX protocol, APIs, and third-party aggregators. Feed timing: EOD batch (most common), intraday updates, and real-time streaming. Multi-custodian management requires data normalization, consolidated views, custodian-specific trade routing, and separate reconciliation. Custodian transitions (e.g., TD Ameritrade to Schwab) require account mapping, feed migration, and historical data transfer.

Worked Examples

See references/examples.md for three end-to-end worked examples — a PMS migration for a growing RIA, a UMA/sleeve implementation for HNW clients, and a reconciliation break investigation. Load it when the user needs a full scenario walkthrough.

Show full SKILL.md (674 more words)Show less

Common Pitfalls

  1. Treating the PMS as the official record. The custodian, not the PMS, maintains the legally authoritative record of client assets. When discrepancies exist, the custodian record governs. Firms that rely solely on PMS data without reconciliation risk reporting incorrect positions and performance.

  2. Neglecting daily reconciliation. Firms that reconcile weekly or monthly allow breaks to compound, making root-cause diagnosis much harder. A corporate action missed on Monday may cause cascading errors in performance, billing, and rebalancing throughout the week.

  3. Over-engineering drift thresholds. Setting drift bands too tight (e.g., 1% absolute) generates excessive trading, increasing costs and tax drag. Setting bands too loose (e.g., 10% absolute) allows portfolios to deviate significantly from the intended risk profile. Calibrate thresholds based on asset class volatility and client tax sensitivity.

  4. Ignoring wash sale rules across accounts. Tax-loss harvesting in one account while purchasing substantially identical securities in another account with the same tax ID disallows the loss. The PMS must monitor wash sale windows across all accounts for a client or household.

  5. Stale held-away data. Aggregated held-away data that has not refreshed in weeks or months can lead to materially incorrect total-household allocation views and flawed planning recommendations. Implement alerts for stale connections and establish a process for client re-authentication.

  6. Inconsistent model governance. Allowing advisors to freely modify firm models without oversight creates style drift and compliance risk. Establish clear policies on which model elements advisors can customize and require documentation of deviations.

  7. Cost basis discrepancies between PMS and custodian. The PMS and custodian may calculate cost basis differently, especially after corporate actions, transfers, or wash sale adjustments. If the firm relies on PMS cost basis for tax-loss harvesting decisions but the custodian reports different basis to the IRS (Form 1099-B), clients may face unexpected tax consequences.

  8. Billing on stale or unreconciled data. Calculating fees on PMS positions that have not been reconciled against the custodian may result in over- or under-billing. Always reconcile before running billing.

  9. Failing to test custodian feed changes. Custodians periodically update their data feed formats. Firms that do not monitor for format changes or test in a staging environment before production risk silent data-import failures.

  10. Overlooking performance calculation methodology. Reporting MWR when TWR is appropriate (or vice versa) can mislead clients or violate GIPS standards. Understand when each methodology is appropriate and clearly label which method is used in client-facing reports.

Cross-References

  • asset-allocation (wealth-management plugin) — PMS implements the strategic and tactical asset allocation defined in the client's investment policy. Model portfolios in the PMS are the operational expression of asset allocation decisions.
  • rebalancing (wealth-management plugin) — The PMS rebalancing engine applies rebalancing theory (threshold-based, calendar-based, opportunistic) to live client portfolios. The rebalancing skill defines the theory; this skill covers the system implementation.
  • tax-efficiency (wealth-management plugin) — PMS tax-loss harvesting, wash sale monitoring, and tax-aware rebalancing apply the tax-efficiency principles defined in the tax-efficiency skill to operational workflows.
  • performance-metrics (wealth-management plugin) — The PMS calculates the return metrics (TWR, MWR, alpha, Sharpe ratio) defined in the performance-metrics skill. That skill defines the math; this skill covers how the PMS implements the calculations.
  • performance-reporting (wealth-management plugin) — The PMS generates the underlying performance data that feeds client-facing performance reports. The reporting skill covers presentation and communication; this skill covers calculation and data infrastructure.
  • gips-compliance (compliance plugin) — PMS composite construction and performance calculation must satisfy GIPS requirements for firms that claim compliance. The GIPS skill defines the standards; this skill covers the PMS configuration needed to meet them.
  • order-management-advisor (advisory-practice plugin) — The OMS receives trade lists generated by the PMS. This skill covers trade list generation; the OMS skill covers order routing, execution, and allocation.
  • financial-planning-integration (advisory-practice plugin) — The PMS current portfolio (including held-away aggregation) feeds financial planning tools for projections and scenario analysis.
  • fee-billing (advisory-practice plugin) — The PMS fee engine handles billing calculations described here. The fee-billing skill covers the broader billing operations workflow including invoicing, collections, and revenue recognition.
  • client-reporting-delivery (advisory-practice plugin) — PMS performance data, portfolio holdings, and asset allocation feeds the client reporting and delivery workflow.

© 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 2 other files (references) in plugins/advisory-practice/skills/portfolio-management-systems of JoelLewis/finance_skills.

  • SKILL.md
  • references/examples.md
  • references/platform-details.md

Open the folder on GitHubat commit 5c498ea

Compare with similar skills

Portfolio Management Systems 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.

Portfolio Management Systems compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Portfolio Management Systems this skillJoelLewis/finance_skills206—~3.3kAutomated safety check: PassMIT
Clari Core Workflow Ajeremylongshore/tons-of-skills-marketplace2.8k—~1kAutomated safety check: PassMIT
Salesloft Core Workflow Bjeremylongshore/tons-of-skills-marketplace2.8k—~961Automated safety check: PassMIT
Insurance Brokerage Agency Billing Configureforcedotcom/sf-skills1.1k—~5.8kAutomated safety check: PassApache-2.0
Agentforce Bot Upgradeforcedotcom/sf-skills1.1k—~3.6kAutomated safety check: PassApache-2.0
Sync Upstreamnyaruka/phonenumbers1.6k—~2.8kAutomated safety check: PassMIT

Similar skills

  • Clari Core Workflow A

    jeremylongshore/tons-of-skills-marketplace

    Build a Clari forecast-export pipeline with reconciliation, schema controls, and warehouse lineage.

    2.8k GitHub stars~1k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Salesloft Core Workflow B

    jeremylongshore/tons-of-skills-marketplace

    Reconcile Salesloft cadence membership state and engagement counts with an incremental, restartable read workflow.

    2.8k GitHub stars~961 tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Configure end-to-end Agency Billing on a Salesforce FSC Insurance Brokerage org via dispatch MCP calls.

    1.1k GitHub stars~5.8k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Agentforce Bot Upgrade

    forcedotcom/sf-skills

    A skill your agent uses to Upgrade Einstein Bots into Agentforce agents end-to-end in a single pass, orchestrating per-bot Agent Spec generation, planner reconciliation across bots…

    1.1k GitHub stars~3.6k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Sync Upstream

    nyaruka/phonenumbers

    Sync this Go port with a new upstream google/libphonenumber release — regenerate the embedded metadata and reconcile the ported Java logic.

    1.6k GitHub stars~2.8k tokensUpdated 8 days ago
    Business, Finance & HRAuto-check passed
  • Radiology Table

    huang-sir1/radiology-skills

    Create/audit editable publication tables with source reconciliation; not figures or statistical inference.

    1.9k GitHub stars~1.3k tokensUpdated 20 days ago
    Business, Finance & HRAuto-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 Portfolio Management Systems

What does Portfolio Management Systems do?

Select, configure, and operate portfolio management systems for advisory firms, covering model portfolios, UMA/sleeve management, drift monitoring, rebalancing, and custodian data feeds. Portfolio Management Systems is an agent skill from JoelLewis/finance_skills. Select, configure, and operate portfolio management systems for advisory firms, covering model portfolios, UMA/sleeve management, drift monitoring, rebalancing, and custodian data feeds.

When should I use Portfolio Management Systems?

Portfolio Management Systems fits situations like: the user asks about choosing a PMS platform; distributing model portfolios; implementing UMA; sleeve-based management.

How do I install Portfolio Management Systems in Claude Code?

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

How do I install Portfolio Management Systems in Codex?

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

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

What does Portfolio Management Systems need to run?

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

Does Portfolio Management Systems 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 Portfolio Management Systems 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 Portfolio Management Systems use?

Portfolio Management Systems 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 Portfolio Management Systems use?

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

What are the alternatives to Portfolio Management Systems?

Skills that share tags, products or a category with Portfolio Management Systems: Clari Core Workflow A (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), Salesloft Core Workflow B (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), Insurance Brokerage Agency Billing Configure (forcedotcom/sf-skills, 1.1k stars) and Agentforce Bot Upgrade (forcedotcom/sf-skills, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Portfolio Management Systems?

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.