mcpbeat Sign in

Investment Policy Agent Skill

Construct comprehensive Investment Policy Statements governing return objectives, risk tolerance, and portfolio constraints. Use when the user asks about building an IPS, setting return objectives, assessing risk tolerance, defining investment constraints, or establishing rebalancing and benchmark policies. Also trigger when users mention 'investment plan', 'policy portfolio', 'risk capacity vs willingness', 'spending rate for an endowment', 'foundation payout', 'manager selection criteria', or ask how to document their investment strategy.

3k tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
161
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/JoelLewis/finance_skills --skill investment-policy

The instruction itself

17 sections, as written by the author

Investment Policy Statement Construction

Core Concepts

Investment Policy Statement (IPS)

The IPS is the governing document for all investment decisions. It specifies objectives (return and risk), constraints, asset allocation ranges, rebalancing policy, benchmark selection, and review schedule. Every portfolio action should be traceable back to IPS provisions.

Return Objective

The required return is the rate that funds all future liabilities and goals.

  • Required return: Solve for the discount rate that equates the present value of assets to the present value of future liabilities/spending needs.
  • Spending rate (endowments/foundations): Typically set as a percentage of a rolling average of portfolio value (e.g., 5% of 3-year rolling average AUM). The required nominal return must cover spending + inflation + fees.
  • Required nominal return = spending rate + expected inflation + investment management fees

Risk Tolerance

Risk tolerance has two dimensions that must be assessed independently:

  • Ability (financial capacity): Determined by time horizon, wealth relative to liabilities, income stability, and liquidity needs. Longer horizons and greater surplus increase ability.
  • Willingness (psychological comfort): Determined by behavioral assessment, past responses to losses, and stated preferences.
  • Conflict resolution rule: When ability and willingness conflict, the lower of the two governs. A client with high ability but low willingness should be invested conservatively (with education to potentially raise willingness over time).

Constraints (LLTU+U)

Five categories of constraints must be addressed in every IPS:

  • Liquidity: Anticipated cash needs, emergency reserves, near-term spending requirements
  • Legal/Regulatory: ERISA rules, trust provisions, foundation payout requirements, prudent investor standards
  • Time horizon: Single-stage or multi-stage; longer horizons generally permit more risk
  • Tax: Taxable vs tax-deferred vs tax-exempt status; impact on asset allocation and rebalancing
  • Unique circumstances: ESG/SRI restrictions, concentrated stock positions, employer stock, legacy holdings, personal preferences

Asset Allocation Policy

Strategic Asset Allocation (SAA) defines long-term target ranges:

  • Example ranges: equity 50-70%, fixed income 20-40%, alternatives 0-15%
  • Ranges permit tactical tilts within policy bounds
  • Policy allocation is the primary driver of long-term returns (commonly cited as explaining ~90% of return variability across time)

Rebalancing Policy

Specifies when and how the portfolio is brought back to target weights:

  • Calendar-based: Rebalance at fixed intervals (quarterly, semi-annually)
  • Threshold-based (percentage-of-portfolio): Rebalance when any asset class drifts beyond a specified band (e.g., ±5% absolute)
  • Combined: Check at calendar intervals, rebalance only if thresholds are breached
  • Wider bands reduce transaction costs but allow more drift; narrower bands maintain discipline but increase costs

Benchmark Selection

An appropriate benchmark must be:

  • Investable: Represents a viable passive alternative
  • Measurable: Returns can be calculated on a timely basis
  • Specified in advance: Chosen before the evaluation period, not after
  • Appropriate: Matches the portfolio's asset classes, style, and risk profile
  • Owned by the manager: The manager should agree the benchmark is fair

Manager Selection Criteria (The Five Ps)

  • Philosophy: Clear, coherent investment belief system
  • Process: Systematic, repeatable approach consistent with philosophy
  • People: Experienced, stable team with aligned incentives
  • Performance: Track record evaluated against appropriate benchmark over full market cycles
  • Price: Fees competitive relative to peers and value added

Review Schedule

  • Annual IPS review: Reassess objectives, constraints, and circumstances
  • Quarterly performance review: Evaluate returns, attribution, and benchmark comparison
  • Trigger-based review: Major life events, market dislocations, or material changes in circumstances

Key Formulas

| Formula | Expression | Use Case |

|---------|-----------|----------|

| Required nominal return | R_nom = spending_rate + inflation + fees | Endowment/foundation return target |

| Required return (goal-based) | Solve: PV(assets) = Σ [CF_t / (1+R)^t] | Individual required return |

| Real return from nominal | R_real ≈ R_nom - inflation | Converting between real and nominal |

| Spending amount (rolling avg) | Spend = rate × (1/3)(AUM_t + AUM_{t-1} + AUM_{t-2}) | Endowment annual distribution |

| Rebalancing trigger | |w_actual - w_target| > threshold | Threshold-based rebalancing |

Worked Examples

Example 1: IPS for a 45-year-old pre-retiree

Given: Age 45, current portfolio $2M, needs $100K/year (today's dollars) starting at age 65, life expectancy 90, inflation 2.5%, portfolio fees 0.5%.

Calculate: Required nominal return and the resulting allocation guidance.

Solution:

  • Time horizon: 20 years to retirement + 25 years in retirement = two-stage horizon.
  • At retirement, need $100K × (1.025)^20 = $163,862/year in nominal terms.
  • Required nest egg at 65 (25-year payout, assuming the retirement portfolio earns ~5% real, roughly 7.5% nominal at 2.5% inflation): the inflation-growing withdrawals are a level annuity in real terms, so N = $163,862 × [1 - 1.05^(-25)] / 0.05 = $163,862 × 14.094 ≈ $2.31M (in age-65 dollars).
  • Required return (no additional contributions): solve $2M × (1+R)^20 = $2.31M → R = (2.31/2.0)^(1/20) - 1 ≈ 0.7% nominal net of fees (≈1.2% gross adding the 0.5% fee). That is below the 2.5% inflation assumption — the required real return is roughly -1.7%.
  • If the client also contributes $30K/year, the required return falls to essentially zero. Return needs alone do not compel an equity-heavy portfolio.
  • Allocation logic: ability to take risk is high (20-year accumulation horizon, assets large relative to the goal), so willingness governs the choice within a wide acceptable range. The required return is modest, but a 45-year total horizon, longevity beyond age 90, and inflation risk argue for substantial equities; if willingness is moderate, a 60/40 allocation is comfortable, and the client could de-risk to 40/60 and still expect to meet the goal. Document in the IPS that the equity allocation is held for inflation protection and longevity risk, not because the return target demands it.

Example 2: Endowment spending policy

Given: $50M endowment, 5% spending rule on 3-year rolling average, expected inflation 2.5%, investment fees 0.5%.

Calculate: Required nominal return to maintain real value.

Solution:

  • Annual spending = 5% × $50M = $2.5M (assuming stable AUM at $50M).
  • To maintain purchasing power, the endowment must grow by at least inflation: 2.5%.
  • Required nominal return = spending rate + inflation + fees = 5.0% + 2.5% + 0.5% = 8.0%.
  • This implies a growth-oriented allocation (e.g., 70% equity, 20% fixed income, 10% alternatives).
  • If 8% seems aggressive, the board may need to reduce spending rate or accept gradual real erosion.

Common Pitfalls

  • Setting return objectives higher than risk tolerance allows — the return target must be achievable within the risk budget
  • Ignoring inflation in required return calculations — understating the true return hurdle
  • Not revisiting the IPS when circumstances change — life events, market regimes, and regulatory changes demand updates
  • Confusing risk ability with risk willingness — they are separate assessments and must be reconciled
  • Setting constraints too rigid (reduces flexibility and increases costs) or too loose (provides no discipline)
  • Choosing benchmarks after the fact to make performance look better
  • Ignoring the interaction between constraints (e.g., tax considerations affecting asset allocation ranges)

Cross-References

  • tax-efficiency (wealth-management plugin): asset location and withdrawal sequencing affect IPS constraint section
  • performance-attribution (wealth-management plugin): benchmark selection in IPS directly feeds performance evaluation
  • liquidity-management (wealth-management plugin): liquidity constraint in IPS depends on cash flow analysis
  • savings-goals (wealth-management plugin): return objectives often derived from goal-based planning
  • emergency-fund (wealth-management plugin): emergency reserve requirement feeds into IPS liquidity constraint
  • client-review-prep (advisory-practice plugin): IPS provides the reference framework for evaluating drift and suitability during reviews
  • financial-planning-workflow (advisory-practice plugin): the financial plan informs and is codified in the investment policy statement
  • tax-loss-harvesting (wealth-management plugin): IPS may specify TLH policy parameters (minimum loss threshold, approved replacement pairs)
  • estate-gifting (wealth-management plugin): trust structures and multi-generational transfer objectives feed the IPS legal/regulatory and time-horizon constraints
  • retirement-decumulation (wealth-management plugin): the IPS spending policy documents the withdrawal rate, guardrail rules, and rebalancing discipline used in decumulation

Other skills for the same job

different authors, same section of the catalogue
Startup Business Analyst Business Case
by ComeOnOliver
×2

Generate comprehensive investor-ready business case document with market, solution, financials, and strategy

6k tokens
Tear Sheet
by anthropics
vendor ×1

Generate professional company tear sheets using S&P Capital IQ data via the Kensho LLM-ready API MCP server. Use this skill whenever the user asks for a tear sheet, company one-pager, company profile, fact sheet, company snapshot, or company overview document — especially when they mention a specific company name or ticker. Also trigger when users ask for equity research summaries, M&A company profiles, corporate development target profiles, sales/BD meeting prep documents, or any concise single-company financial summary. This skill supports four audience types: equity research, investment banking/M&A, corporate development, and sales/business development. If the user doesn't specify an audience, ask. Works for both public and private companies.

22k tokens
Month End Prep
by anthropics
vendor

> PayPal (and Square/Stripe) settlements, flags uncategorized transactions, suspicious duplicates, and missing receipts, then writes a plain-English P&L narrative and exports a close packet (xlsx + one-page PDF). Use when the user says "close the month," "month-end," "reconcile," "what's missing," "P&L," or asks why revenue or margin changed this month.

6k tokens
Szamlazz Invoicing
by davepoon

Issue, cancel, and fetch Hungarian invoices via the szamlazz.hu Agent API. Handles VAT calculation, NAV taxpayer lookup, partner caching, and PDF generation. Use when the user mentions számla, számlázás, invoice, sztornó, díjbekérő, proforma, or wants to bill a customer.

1k tokens
Platform Norm Profiler
by aaron-he-zhu

Use when the user asks to "build the norm card for this platform", "what are the char limits and visible-fold cutoffs here", "is the LinkedIn link-in-first-comment thing documented or folklore", or "which of our platform cards are stale"; maintains the dated, versioned per-platform norm cards in the references/platforms/ pack — char limits, visible-fold cutoffs, hashtag norms, format/aspect specs, link and first-comment placement, disclosure-label mechanics, algorithm emphases (e.g. 小红书 search+saves weighting) — every row labeled platform-documented (official doc, Measured) or Estimated-folklore (named source) with last-verified and review-by dates, and any card past its review date flagged stale rather than trusted. Extends the single pack in place; never forks a second one. Not for picking which channels to run — use channel-portfolio-planner. 平台规范卡/字符限制/折叠线/话题标签/算法侧重/过期标记

3k tokens
Lawve Public Due Diligence Gate Ignacio Adrian Lerer
by lawve-ai

Use for due diligence, legal-financial risk review, investment or business transaction checklists, and preliminary screening where facts, documents, assumptions, legal uncertainty, debt/equity, assets/liabilities, contracts, tax, regulatory, compliance, technology/product, and financial-model issues must be separated clearly.

1k tokens
Invoice Document PDF
by cosmicstack-labs

Generating invoices, contracts, forms, receipts, and business documents as professional PDFs

16k tokens
Financial Document Parser
by Microck

Extract and analyze data from invoices, receipts, bank statements, and financial documents. Categorize expenses, track recurring charges, and generate expense reports. Use when user provides financial PDFs or images.

1k tokens

How to use it

Copy the folder

Take joellewis/investment-policy from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.