Agent skill

Investment Policy

by JoelLewis in JoelLewis/finance_skills

Construct comprehensive Investment Policy Statements governing return objectives, risk tolerance, and portfolio constraints.

MITAuto-check passedBusiness, Finance & HR

Install Investment Policy

skills CLI
$ npx skills add JoelLewis/finance_skills --skill investment-policy -a claude-code

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

GitHub CLI
$ gh skill install JoelLewis/finance_skills investment-policy --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/wealth-management/skills/investment-policy .claude/skills/investment-policy && 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
investment-policy
GitHub stars
206
Token cost
~2.5k tokens
SKILL.md length
1,172 words
Files
1
Skills in repo
91
Repo updated
First seen
Licence
MIT

At a glance

Construct comprehensive Investment Policy Statements governing return objectives, risk tolerance, and portfolio constraints.

  • Works in 6 steps: Time horizon: 20 years to retirement +… → At retirement, need $100K × (1.025)^20 =… → Required nest egg at 65 (25-year payout,… → …
  • The user asks about building an IPS
  • SKILL.md covers Core Concepts, Key Formulas, Worked Examples and Common Pitfalls, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Investment Policy is an agent skill from JoelLewis/finance_skills. 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…

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

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

When your agent uses it

  • The user asks about building an IPS
  • Setting return objectives
  • Assessing risk tolerance
  • Defining investment constraints

Example prompts

  • “investment plan”
  • “policy portfolio”
  • “risk capacity vs willingness”
  • “/investment-policy”

Workflow steps

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

  1. Time horizon: 20 years to retirement + 25 years in retirement = two-stage horizon.
  2. At retirement, need $100K × (1.025)^20 = $163,862/year in nominal terms.
  3. Required nest egg at 65 (25-year payout, assuming the retirement portfolio earns ~5% real, roughly 7.5% nominal at 2.5% inflation): the…
  4. 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%…
  5. If the client also contributes $30K/year, the required return falls to essentially zero. Return needs alone do not compel an equity-heavy…
  6. Allocation logic: ability to take risk is high (20-year accumulation horizon, assets large relative to the goal), so willingness governs…

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

Investment Policy loads about 2.5k tokens when it runs. Until then it costs about 141 tokens; SKILL.md has 1,172 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~141
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k

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,172 words, ~2,498 tokens.

Download SKILL.mdSave it as .claude/skills/investment-policy/SKILL.md (or your agent's skills folder).
name
investment-policy
description
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.

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

FormulaExpressionUse Case
Required nominal returnR_nom = spending_rate + inflation + feesEndowment/foundation return target
Required return (goal-based)Solve: PV(assets) = Σ [CF_t / (1+R)^t]Individual required return
Real return from nominalR_real ≈ R_nom - inflationConverting between real and nominal
Spending amount (rolling avg)Spend = rate × (1/3)(AUM_t + AUM_{t-1} + AUM_{t-2})Endowment annual distribution
Rebalancing triggerw_actual - w_target

Worked Examples

Show full SKILL.md (595 more words)Show less
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:

  1. Time horizon: 20 years to retirement + 25 years in retirement = two-stage horizon.
  2. At retirement, need $100K × (1.025)^20 = $163,862/year in nominal terms.
  3. 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).
  4. 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%.
  5. If the client also contributes $30K/year, the required return falls to essentially zero. Return needs alone do not compel an equity-heavy portfolio.
  6. 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:

  1. Annual spending = 5% × $50M = $2.5M (assuming stable AUM at $50M).
  2. To maintain purchasing power, the endowment must grow by at least inflation: 2.5%.
  3. Required nominal return = spending rate + inflation + fees = 5.0% + 2.5% + 0.5% = 8.0%.
  4. This implies a growth-oriented allocation (e.g., 70% equity, 20% fixed income, 10% alternatives).
  5. 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

© 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

Just SKILL.md in plugins/wealth-management/skills/investment-policy of JoelLewis/finance_skills.

Open the folder on GitHubat commit 5c498ea

Compare with similar skills

Investment Policy 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.

Investment Policy compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Investment Policy this skillJoelLewis/finance_skills206—~2.5kAutomated safety check: PassMIT
Technical Analysttradermonty/claude-trading-skills3k4 repos~4.6kAutomated safety check: PassMIT
Theme Detectortradermonty/claude-trading-skills3k2 repos~4.9kAutomated safety check: PassMIT
Creating Financial ModelsChen-zexi/open-ptc-agent7293 repos~1.3kAutomated safety check: PassMIT
Stock APIzhangxiangliang/stock-api2k—~507Automated safety check: PassMIT
Itr Walakaranb192/itr-wala871—~3.6kAutomated safety check: PassMIT

Similar skills

  • Technical Analyst

    tradermonty/claude-trading-skills

    This skill should be used when analyzing weekly price charts for stocks, stock indices, cryptocurrencies, or forex pairs.

    3k GitHub starsUsed in 4 repos~4.6k tokens
    Business, Finance & HRAuto-check passed
  • Theme Detector

    tradermonty/claude-trading-skills

    Detect and analyze trending market themes across sectors. An agent skill from tradermonty/claude-trading-skills.

    3k GitHub starsUsed in 2 repos~4.9k tokens
    Business, Finance & HRAuto-check passed
  • Creating Financial Models

    Chen-zexi/open-ptc-agent

    This skill provides an advanced financial modeling suite with DCF analysis, sensitivity testing, Monte Carlo simulations, and scenario planning for investment decisions

    729 GitHub starsUsed in 3 repos~1.3k tokens
    Business, Finance & HRAuto-check passed
  • Stock API

    zhangxiangliang/stock-api

    Fetch real-time stock quotes, K-line (candlestick) history, and search symbols for China A-shares, Hong Kong, and US markets.

    2k GitHub stars~507 tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Itr Wala

    karanb192/itr-wala

    File Indian income tax returns (ITR) for FY 2025-26 / AY 2026-27.

    871 GitHub stars~3.6k tokensUpdated 7 days ago
    Business, Finance & HRAuto-check passed
  • Tushare Data

    zillionare/zillionare

    面向中文自然语言的 Tushare 数据研究技能。用于把“看看这只股票最近怎么样”“帮我查财报趋势”“最近哪个板块最强”“北向资金在买什么”“给我导出一份行情数据”这类请求,转成可执行的数据获取、清洗、对比、筛选、导出与简要分析流程。适用于 A 股、指数、ETF/基金、财务、估值、资金流、公告新闻、板块概念与宏观数据等研究场景。

    322 GitHub starsUsed in 2 repos~2.3k tokens
    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 Investment Policy

What does Investment Policy do?

Construct comprehensive Investment Policy Statements governing return objectives, risk tolerance, and portfolio constraints. Investment Policy is an agent skill from JoelLewis/finance_skills. Construct comprehensive Investment Policy Statements governing return objectives, risk tolerance, and portfolio constraints.

When should I use Investment Policy?

Investment Policy fits situations like: the user asks about building an IPS; setting return objectives; assessing risk tolerance; defining investment constraints.

How do I install Investment Policy in Claude Code?

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

How do I install Investment Policy in Codex?

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

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

What does Investment Policy need to run?

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

Does Investment Policy 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 Investment Policy 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 Investment Policy use?

Investment Policy 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 Investment Policy use?

About 2.5k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Investment Policy?

Skills that share tags, products or a category with Investment Policy: Technical Analyst (tradermonty/claude-trading-skills, 3k stars), Theme Detector (tradermonty/claude-trading-skills, 3k stars), Creating Financial Models (Chen-zexi/open-ptc-agent, 729 stars) and Stock API (zhangxiangliang/stock-api, 2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Investment Policy?

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.