Agent skill

Time Value Of Money

by JoelLewis in JoelLewis/finance_skills

Calculate present value, future value, NPV, IRR for projects and loans, loan payments, and amortization schedules across all compounding conventions.

MITAuto-check passedBusiness, Finance & HR

Install Time Value Of Money

skills CLI
$ npx skills add JoelLewis/finance_skills --skill time-value-of-money -a claude-code

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

GitHub CLI
$ gh skill install JoelLewis/finance_skills time-value-of-money --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/core/skills/time-value-of-money .claude/skills/time-value-of-money && 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
time-value-of-money
GitHub stars
206
Token cost
~2.5k tokens
SKILL.md length
1,109 words
Files
2 (incl. scripts)
Skills in repo
91
Repo updated
First seen
Licence
MIT

At a glance

Calculate present value, future value, NPV, IRR for projects and loans, loan payments, and amortization schedules across all compounding conventions.

  • The user asks about discounting cash flows
  • SKILL.md covers Core Concepts, Key Formulas, Worked Examples and Common Pitfalls, plus 2 more sections
  • Runs Python scripts from its folder; calls uv and python3
  • Valuing an annuity

What it does

Time Value Of Money is an agent skill from JoelLewis/finance_skills. Calculate present value, future value, NPV, IRR for projects and loans, loan payments, and amortization schedules across all compounding conventions. Use when the user asks about discounting cash flows, valuing an annuity or perpetuity, comparing investments with different timing, building a mortgage amortization table, evaluating whether a project is worth pursuing, or solving for the rate that equates cash flows (project IRR, loan IRR, yield on an investment). Also trigger when users mention 'what is it worth…

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/time_value_of_money.py`).

It sits in Business, Finance & HR, covering Real estate and Pricing strategy. 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 discounting cash flows
  • Valuing an annuity
  • Comparing investments with different timing
  • Building a mortgage amortization table

Example prompts

  • “what is it worth today”
  • “how much will I have in 20 years”
  • “monthly payment on a loan”
  • “/time-value-of-money”

Requirements

  • Python 3

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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • uv
    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    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

Time Value Of Money loads about 2.5k tokens when it runs. Until then it costs about 225 tokens; SKILL.md has 1,109 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~225
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); the scripts in this folder are not scanned.

SKILL.md

The full file from JoelLewis/finance_skills at commit 5c498ea, republished under its MIT licence (© JoelLewis). 1,109 words, ~2,455 tokens.

Download SKILL.mdSave it as .claude/skills/time-value-of-money/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
time-value-of-money
description
Calculate present value, future value, NPV, IRR for projects and loans, loan payments, and amortization schedules across all compounding conventions. Use when the user asks about discounting cash flows, valuing an annuity or perpetuity, comparing investments with different timing, building a mortgage amortization table, evaluating whether a project is worth pursuing, or solving for the rate that equates cash flows (project IRR, loan IRR, yield on an investment). Also trigger when users mention 'what is it worth today', 'how much will I have in 20 years', 'monthly payment on a loan', 'discount rate', 'Gordon growth model', 'effective annual rate', 'continuous compounding', or ask how to compare a lump sum versus a stream of payments. For portfolio money-weighted return (dollar-weighted IRR on an investor's contributions and withdrawals), use return-calculations instead.

Time Value of Money

Core Concepts

Future Value (FV)

The value of a present sum after earning interest for n periods at rate r per period.

$$FV = PV \times (1 + r)^n$$

Future value grows exponentially with time, which is the mathematical basis of compound interest.

Present Value (PV)

The current worth of a future sum, discounted back at rate r for n periods. This is the inverse of future value.

$$PV = \frac{FV}{(1 + r)^n}$$

Present value is the cornerstone of all valuation: a dollar today is worth more than a dollar tomorrow because of the opportunity cost of capital.

Compounding Conventions

Interest can compound at different frequencies. The nominal annual rate r_nom compounded m times per year produces different effective yields.

Discrete compounding (m times per year):

$$FV = PV \times \left(1 + \frac{r_{nom}}{m}\right)^{m \times t}$$

Continuous compounding:

$$FV = PV \times e^{r \times t}$$

Effective Annual Rate (EAR):

$$EAR = \left(1 + \frac{r_{nom}}{m}\right)^m - 1$$

For continuous compounding: EAR = e^(r_nom) - 1

Common frequencies:

Frequencym
Annual1
Semi-annual2
Quarterly4
Monthly12
Daily365
Continuousinfinity
Ordinary Annuity

A series of equal payments made at the end of each period for n periods.

Present Value:

$$PV = PMT \times \frac{1 - (1 + r)^{-n}}{r}$$

Future Value:

$$FV = PMT \times \frac{(1 + r)^n - 1}{r}$$

Annuity Due

A series of equal payments made at the beginning of each period. Each cash flow is one period closer than in an ordinary annuity, so values are scaled by (1 + r).

Present Value:

$$PV = PMT \times \frac{1 - (1 + r)^{-n}}{r} \times (1 + r)$$

Future Value:

$$FV = PMT \times \frac{(1 + r)^n - 1}{r} \times (1 + r)$$

Growing Annuity

A finite series of payments that grow at a constant rate g per period, where g != r.

Present Value:

$$PV = \frac{PMT}{r - g} \times \left[1 - \left(\frac{1 + g}{1 + r}\right)^n\right]$$

This is widely used in equity valuation (e.g., multi-stage dividend discount models) and salary/pension projections.

Perpetuity

An infinite stream of equal payments.

$$PV = \frac{PMT}{r}$$

Growing Perpetuity

An infinite stream of payments growing at constant rate g, where g < r for convergence.

$$PV = \frac{PMT}{r - g}$$

This is the Gordon Growth Model when applied to dividends.

Net Present Value (NPV)

The sum of all discounted cash flows, including the initial investment. A positive NPV indicates value creation.

$$NPV = \sum_{t=0}^{T} \frac{CF_t}{(1 + r)^t}$$

Typically, CF_0 is a negative outflow (initial investment), and subsequent CF_t are inflows.

Internal Rate of Return (IRR)

The discount rate r that makes the NPV of all cash flows exactly zero.

$$0 = \sum_{t=0}^{T} \frac{CF_t}{(1 + r)^t}$$

IRR is solved numerically (Newton-Raphson or bisection) since there is no closed-form solution for general cash flow streams. For conventional cash flows (one sign change), a unique IRR exists.

Amortization

Each payment on an amortizing loan is split into an interest component and a principal component:

  • Interest portion: Interest_t = Balance_{t-1} * r
  • Principal portion: Principal_t = PMT - Interest_t
  • Remaining balance: Balance_t = Balance_{t-1} - Principal_t

Over time, the interest portion decreases and the principal portion increases.

Key Formulas

FormulaExpressionUse Case
Future ValueFV = PV * (1 + r)^nCompound a lump sum forward
Present ValuePV = FV / (1 + r)^nDiscount a future lump sum
EAR(1 + r_nom/m)^m - 1Compare rates across compounding frequencies
Continuous FVFV = PV * e^(r*t)Continuous compounding
Ordinary Annuity PVPMT * [1 - (1+r)^(-n)] / rLoan payments, lease valuation
Annuity Due PVPMT * [1 - (1+r)^(-n)] / r * (1+r)Rent, insurance (paid in advance)
Growing Annuity PVPMT/(r-g) * [1 - ((1+g)/(1+r))^n]Salary streams, growing dividends
Perpetuity PVPMT / rPreferred stock, consol bonds
Growing Perpetuity PVPMT / (r - g)Gordon Growth Model
NPVsum(CF_t / (1+r)^t)Project/investment evaluation
IRRsolve: sum(CF_t / (1+r)^t) = 0Return metric for uneven cash flows

Worked Examples

Example 1: Monthly Mortgage Payment

Given: A $300,000 mortgage at a 6.5% annual interest rate, fixed for 30 years, with monthly payments (ordinary annuity).

Calculate: The monthly payment amount.

Solution:

First, convert the annual rate to a monthly rate and years to months:

r_monthly = 0.065 / 12 = 0.00541667
n = 30 * 12 = 360 months

Using the ordinary annuity present value formula, solve for PMT:

PV = PMT * [1 - (1 + r)^(-n)] / r

300,000 = PMT * [1 - (1.00541667)^(-360)] / 0.00541667

Compute the annuity factor:

(1.00541667)^360 = 6.99179
(1.00541667)^(-360) = 0.143010
1 - 0.143010 = 0.856990
0.856990 / 0.00541667 = 158.2108

Solve for PMT:

PMT = 300,000 / 158.2108 = $1,896.20

The monthly mortgage payment is $1,896.20.

Over 30 years, total payments = 360 * $1,896.20 = $682,632, meaning total interest paid is $682,632 - $300,000 = $382,632.

Show full SKILL.md (439 more words)Show less
Example 2: NPV of a Project with Uneven Cash Flows

Given: A project requires an initial investment of $50,000 and produces the following cash flows:

  • Year 1: $12,000
  • Year 2: $15,000
  • Year 3: $18,000
  • Year 4: $22,000
  • Year 5: $25,000

The required rate of return (discount rate) is 10%.

Calculate: The NPV and whether the project should be accepted.

Solution:

Discount each cash flow to present value:

PV(CF_0) = -50,000 / (1.10)^0 = -50,000.00
PV(CF_1) =  12,000 / (1.10)^1 =  10,909.09
PV(CF_2) =  15,000 / (1.10)^2 =  12,396.69
PV(CF_3) =  18,000 / (1.10)^3 =  13,523.67
PV(CF_4) =  22,000 / (1.10)^4 =  15,026.30
PV(CF_5) =  25,000 / (1.10)^5 =  15,523.03

Sum all present values:

NPV = -50,000.00 + 10,909.09 + 12,396.69 + 13,523.67 + 15,026.30 + 15,523.03
NPV = +$17,378.78

Since NPV is positive ($17,378.78), the project creates value and should be accepted. It earns more than the 10% required rate of return.

To find the IRR, we would solve for the rate where NPV = 0. Numerically, the IRR for this cash flow stream is approximately 21.2% (21.18%), well above the 10% hurdle rate.

Common Pitfalls

  • Mismatching rate and period frequency: if payments are monthly, the discount rate must be a monthly rate. Divide the annual nominal rate by 12, do not take the 12th root of (1 + annual rate) unless converting from EAR.
  • Forgetting the sign convention for cash flows in IRR: outflows (investments) must be negative and inflows (returns) positive, or vice versa, but the convention must be consistent. Incorrect signs produce meaningless IRR results.
  • Confusing nominal vs effective rates: a 12% nominal rate compounded monthly produces an EAR of 12.68%, not 12%. Always clarify the compounding basis.
  • Off-by-one errors in annuity due vs ordinary annuity: an annuity due shifts all payments one period earlier. Forgetting the (1 + r) adjustment factor will undervalue annuity-due streams.
  • Multiple IRR solutions with non-conventional cash flows: when cash flows change sign more than once (e.g., initial outflow, inflows, then a large terminal outflow), Descartes' rule allows up to as many positive real IRR solutions as there are sign changes. In such cases, use NPV profiling or the Modified IRR (MIRR) instead.

Running the Script

scripts/time_value_of_money.py implements every formula above as static methods on a TimeValueOfMoney class (present_value, future_value, npv, irr, annuity_pv, annuity_fv, growing_annuity_pv, perpetuity_pv, fisher_rate, continuous_compounding) plus an AmortizationSchedule class.

  • Run: uv run scripts/time_value_of_money.py (PEP 723 inline metadata; stdlib-only, no third-party dependencies), or simply python3 scripts/time_value_of_money.py.
  • Bare invocation (or --verify) prints a demo of all methods and asserts the worked-example values above (Example 1 mortgage payment = $1,896.20; Example 2 NPV = $17,378.78 and IRR = 21.18%), exiting nonzero on any mismatch.
  • --help lists the available methods and import usage.
  • For programmatic use, import rather than run: from time_value_of_money import TimeValueOfMoney, AmortizationSchedule, then call e.g. TimeValueOfMoney.npv(...).

Cross-References

  • return-calculations (core plugin): CAGR is a special case of compound growth; portfolio MWR uses the same NPV=0 framework and lives there
  • statistics-fundamentals (core plugin): Discount rate estimation often relies on regression (CAPM beta) and distributional assumptions

© 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 (scripts) in plugins/core/skills/time-value-of-money of JoelLewis/finance_skills.

  • SKILL.md
  • scripts/time_value_of_money.py

Open the folder on GitHubat commit 5c498ea

Compare with similar skills

Time Value Of Money 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.

Time Value Of Money compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Time Value Of Money this skillJoelLewis/finance_skills206—~2.5kAutomated safety check: PassMIT
Thue Tncn Vietnamdotanminh/thue-tncn-vietnam241—~2.8kAutomated safety check: PassNone
Apartment Finderhanzili/hanzi-browse177—~2.1kAutomated safety check: PassCustom licence
Realestate Commercialzubair-trabzada/ai-realestate-claude179—~3.2kAutomated safety check: PassMIT
Vet PRetewiah/awesome-real-estate375—~1.5kAutomated safety check: PassCC0-1.0
Realestate Comparezubair-trabzada/ai-realestate-claude179—~3.7kAutomated safety check: PassMIT

Similar skills

  • Thue Tncn Vietnam

    dotanminh/thue-tncn-vietnam

    A skill your agent uses when user asks about Vietnamese personal income tax (TNCN), tax finalization (quyet toan), dependent deductions (giam tru gia canh), freelancer/KOL/online seller tax, eTax…

    241 GitHub stars~2.8k tokensUpdated 3 mo ago
    Business, Finance & HRAuto-check passed
  • Apartment Finder

    hanzili/hanzi-browse

    Search for apartments across multiple real estate platforms, compare listings side by side, and help submit inquiries or applications.

    177 GitHub stars~2.1k tokensUpdated 5 mo ago
    Business, Finance & HRAuto-check passed
  • Realestate Commercial

    zubair-trabzada/ai-realestate-claude

    Commercial Property Analysis — NOI, cap rate, expense ratio, tenant mix, vacancy, debt coverage, replacement cost, and lease analysis with Commercial Score (0-100)

    179 GitHub stars~3.2k tokensUpdated 5 mo ago
    Business, Finance & HRAuto-check passed
  • Vet PR

    etewiah/awesome-real-estate

    Rigorous checklist for triaging PRs on the awesome-real-estate list.

    375 GitHub stars~1.5k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Realestate Compare

    zubair-trabzada/ai-realestate-claude

    Side-by-Side Property Comparison — takes two addresses and compares across price, specs, rental income, neighborhood, and investment potential with a winner per category and overall recommendation

    179 GitHub stars~3.7k tokensUpdated 5 mo ago
    Business, Finance & HRAuto-check passed
  • Taichung Land Parcel Query

    h30190/HJPLUS_Taiwan_Architect_KB

    This skill should be used when an architect receives just an address or lot number (地號) for a site in Taichung City, Taiwan, and needs the land's basic data — zoning, registered land area, land…

    158 GitHub stars~1.9k tokensUpdated 3 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 Time Value Of Money

What does Time Value Of Money do?

Calculate present value, future value, NPV, IRR for projects and loans, loan payments, and amortization schedules across all compounding conventions. Time Value Of Money is an agent skill from JoelLewis/finance_skills. Calculate present value, future value, NPV, IRR for projects and loans, loan payments, and amortization schedules across all compounding conventions.

When should I use Time Value Of Money?

Time Value Of Money fits situations like: the user asks about discounting cash flows; valuing an annuity; comparing investments with different timing; building a mortgage amortization table.

How do I install Time Value Of Money in Claude Code?

Run `npx skills add JoelLewis/finance_skills --skill time-value-of-money -a claude-code`. Or copy the skill folder (plugins/core/skills/time-value-of-money in JoelLewis/finance_skills) into .claude/skills/time-value-of-money in your project. Claude Code loads it when a task matches its description.

How do I install Time Value Of Money in Codex?

Run `npx skills add JoelLewis/finance_skills --skill time-value-of-money -a codex`. Or copy the skill folder (plugins/core/skills/time-value-of-money in JoelLewis/finance_skills) into .agents/skills/time-value-of-money in your project. Codex loads it when a task matches its description.

Can I use Time Value Of Money 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 time-value-of-money -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/time-value-of-money, .gemini/skills/time-value-of-money, .github/skills/time-value-of-money and .opencode/skills/time-value-of-money in your project.

What does Time Value Of Money need to run?

Going by SKILL.md and its folder, Time Value Of Money needs Python for the scripts in its folder and the command-line tools its instructions call (uv and python3). Our summary lists: Python 3.

Does Time Value Of Money access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Time Value Of Money 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Time Value Of Money use?

Time Value Of Money 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 Time Value Of Money use?

About 2.5k tokens (SKILL.md is roughly 9.8k 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 Time Value Of Money?

Skills that share tags, products or a category with Time Value Of Money: Thue Tncn Vietnam (dotanminh/thue-tncn-vietnam, 241 stars), Apartment Finder (hanzili/hanzi-browse, 177 stars), Realestate Commercial (zubair-trabzada/ai-realestate-claude, 179 stars) and Vet PR (etewiah/awesome-real-estate, 375 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Time Value Of Money?

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.