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.
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
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/modeling-bond-valuations/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How modeling-bond-valuations Compares
| Feature / Agent | modeling-bond-valuations | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/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
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
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
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
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
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
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
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
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
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
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
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
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.