modeling-bond-valuations

Calculates bond pricing with duration, convexity, OAS, and Z-spread analysis. Use when pricing bonds, calculating risk metrics, or evaluating relative value.

11 stars

Best use case

modeling-bond-valuations is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Calculates bond pricing with duration, convexity, OAS, and Z-spread analysis. Use when pricing bonds, calculating risk metrics, or evaluating relative value.

Teams using modeling-bond-valuations should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/modeling-bond-valuations/SKILL.md --create-dirs "https://raw.githubusercontent.com/CaseMark/skills/main/skills/finance/modeling-bond-valuations/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/modeling-bond-valuations/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How modeling-bond-valuations Compares

Feature / Agentmodeling-bond-valuationsStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Calculates bond pricing with duration, convexity, OAS, and Z-spread analysis. Use when pricing bonds, calculating risk metrics, or evaluating relative value.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Modeling Bond Valuations

## When To Use

- Pricing a bond (fixed-rate, floating-rate, zero-coupon, callable, putable, or amortizing) from first principles or relative to benchmarks
- Calculating duration (Macaulay, modified, effective) and convexity for portfolio risk management
- Computing OAS or Z-spread to evaluate credit-adjusted relative value versus comparable issues
- Running scenario/shock analysis on rate moves, curve shifts, or credit migration
- Comparing bonds across sectors or maturities on a spread basis for trade idea generation

## Inputs To Gather

- **Bond terms**: CUSIP/ISIN, coupon rate, coupon frequency, maturity date, day-count convention (30/360, ACT/ACT, ACT/360), par value, settlement date
- **Embedded options**: Call/put schedule with dates and strike prices; make-whole spread if applicable
- **Benchmark curve**: Treasury par/spot/forward curve or swap curve (source and as-of date)
- **Credit inputs**: Credit rating, sector, issuer spread history, comparable issue spreads
- **Market data**: Current market price or yield, accrued interest, repo rate (for carry analysis)
- **Volatility assumption**: Interest rate vol model or surface if pricing options (e.g., lognormal OAS model vol in bps)

## Workflow

1. **Build the cash flow schedule**
   - Map coupon dates using the stated frequency and day-count convention
   - For amortizing bonds, construct the principal repayment schedule
   - For floaters, project coupon resets from the forward curve plus quoted spread

2. **Bootstrap or source the discount curve**
   - Use Treasury spot rates (strip curve) or swap zero rates as the risk-free benchmark
   - Interpolate intermediate maturities via cubic spline or piecewise linear methods
   - Document curve source, snapshot date/time, and interpolation method

3. **Compute base valuation**
   - **Price from yield**: Discount each cash flow at the bond's YTM; sum present values; add accrued interest for dirty price
   - **Z-spread**: Solve iteratively for the constant spread over the spot curve that equates discounted cash flows to the observed market price
   - **OAS (for bonds with optionality)**: Use a binomial or Monte Carlo interest rate model; calibrate the tree/sim to the benchmark curve and vol surface; solve for the spread that prices the bond to market after accounting for embedded option exercise [VERIFY: confirm vol model and calibration parameters match firm convention]

4. **Calculate risk metrics**
   - **Modified duration**: −(1/P) × dP/dy, computed analytically or via a ±1 bp parallel shift
   - **Effective duration** (for callable/putable): Use the OAS model to reprice under ±25–50 bp parallel curve shifts; ED = (P₋ − P₊) / (2 × P₀ × Δy)
   - **Convexity**: (P₋ + P₊ − 2P₀) / (P₀ × Δy²), using the same shift size
   - **Key-rate durations**: Shift individual tenor points (2y, 5y, 10y, 30y) by ±25 bp, holding others constant; report sensitivity at each node
   - **DV01 / BPV**: Dollar change per $1 million face for a 1 bp yield change

5. **Run relative value and scenario analysis**
   - Compare OAS or Z-spread to sector medians, rating-tier comps, and issuer's own curve
   - Stress-test with parallel shifts (±50, ±100, ±200 bp), curve steepening/flattening (2s10s ±50 bp), and credit spread widening (+50, +100 bp)
   - Compute carry and roll-down over 1m/3m/6m horizons using forward rates
   - Flag rich/cheap signals: current spread vs. 6-month and 12-month historical range

6. **Validate outputs**
   - Cross-check computed price against Bloomberg/vendor price (tolerance ≤ 1/32 for Treasuries, ≤ ¼ point for corporates)
   - Verify duration and convexity fall within expected ranges for the bond's tenor and coupon
   - Confirm OAS is positive for investment-grade issues and directionally consistent with credit tier
   - Sense-check carry/roll-down against the shape of the forward curve

## Output

Deliver a structured valuation summary containing:

- **Bond identification**: Issuer, CUSIP/ISIN, coupon, maturity, call features
- **Pricing table**: Clean price, dirty price, accrued interest, YTM, YTW (yield-to-worst for callables)
- **Spread metrics**: Z-spread, OAS, G-spread, I-spread (where applicable)
- **Risk metrics**: Modified/effective duration, convexity, DV01, key-rate duration profile
- **Relative value**: Spread vs. comps table, historical spread percentile, rich/cheap assessment
- **Scenario matrix**: Price and spread impact under each stress scenario
- **Carry/roll-down**: Projected total return components over stated horizons
- **Assumptions log**: Curve source, vol model, day-count, settlement, interpolation method

## Quality Checks

- Confirm day-count convention matches the bond's market standard (e.g., 30/360 for US corporates, ACT/ACT for Treasuries) [VERIFY]
- Ensure settlement date reflects T+1 or T+2 convention per market [VERIFY]
- Validate that the yield-to-worst is computed across all call dates, not just the first
- Check that OAS model calibration reprices on-the-run benchmarks to within 0.5 bp
- Verify accrued interest calculation matches the ex-dividend convention for the market
- Confirm that key-rate duration contributions sum approximately to effective duration
- Flag any negative OAS on investment-grade bonds as a potential data or model error
- Mark all externally sourced vol assumptions and spread comps with retrieval dates

Related Skills

managing-transplant-evaluations

11
from CaseMark/skills

Guides transplant candidacy evaluation with organ-specific criteria and listing documentation. Use when evaluating transplant candidates, documenting listing criteria, or coordinating transplant workups.

managing-medication-use-evaluations

11
from CaseMark/skills

Structures medication use evaluations with criteria development, data collection, and intervention tracking. Use when conducting MUEs, evaluating prescribing patterns, or measuring medication use quality.

managing-fertility-evaluations

11
from CaseMark/skills

Structures infertility workup with ovarian reserve testing, semen analysis, and treatment algorithms. Use when evaluating infertility, ordering fertility workup, or managing reproductive planning.

managing-disability-evaluations

11
from CaseMark/skills

Structures psychiatric disability assessments with functional limitations and work capacity documentation. Use when evaluating psychiatric disability, documenting functional limitations, or completing disability forms.

managing-digital-health-evaluations

11
from CaseMark/skills

Evaluates digital health tools and apps with clinical evidence assessment and integration planning. Use when evaluating health apps, assessing digital therapeutics, or planning digital health integration.

conducting-psychiatric-evaluations

11
from CaseMark/skills

Structures comprehensive psychiatric evaluation with MSE, diagnostic formulation, and risk assessment. Use when performing psychiatric assessments, documenting mental status exams, or creating diagnostic formulations.

conducting-pre-operative-evaluations

11
from CaseMark/skills

Structures pre-surgical risk assessment using ACC/AHA guidelines with cardiac and pulmonary clearance. Use when performing preop evaluations, assessing surgical risk, or providing medical clearance.

conducting-forensic-evaluations

11
from CaseMark/skills

Structures forensic psychiatric evaluations for competency, insanity, and civil commitment proceedings. Use when performing forensic evaluations, assessing competency, or documenting forensic opinions.

conducting-capacity-evaluations

11
from CaseMark/skills

Assesses medical decision-making capacity with Appelbaum criteria documentation. Use when evaluating decision-making capacity, documenting capacity assessments, or determining informed consent ability.

modeling-sum-of-parts-valuations

11
from CaseMark/skills

Builds SOTP valuations for conglomerates and multi-segment companies with segment-appropriate methodologies. Use when valuing diversified companies, calculating conglomerate discounts, or modeling segment breakups.

modeling-revenue-forecasts

11
from CaseMark/skills

Builds bottom-up revenue models from segment-level drivers with assumption documentation. Use when forecasting revenue, modeling growth drivers, or building segment-level projections.

modeling-portfolio-company-returns

11
from CaseMark/skills

Builds PE return models with entry/exit multiples, leverage analysis, and value creation attribution. Use when modeling PE returns, calculating IRR/MOIC, or attributing value creation drivers.