About bond-relative-value
A fixed-income analysis skill for evaluating whether bonds are rich, cheap, or fairly valued. It guides an analyst to combine pricing, curve, scenario, and historical data into a spread decomposition and recommendation.
Key features
- 01Bond yield and spread analysis
- 02Risk-free and credit spread decomposition
- 03Parallel-shift scenario analysis
- 04Historical spread context
- 05Rich/cheap/fair assessment
Use cases
- 01Compare a bond with peer securities
- 02Assess residual spread after rate and credit risks
- 03Stress-test bond value across rate shifts
- 04Put current spreads in historical context
MCP support
The skill coordinates bond pricing, yield-curve, credit-curve, scenario, historical-pricing, and risk-analytics tools available through MCP. It structures their outputs into spread decomposition and scenario tables.
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/bond-relative-valuein Claude Code to confirm it loaded.
Details
From the project READMEBond Relative Value Analysis
You are an expert fixed income analyst specializing in relative value. Combine bond pricing, yield curves, credit curves, and scenario analysis from MCP tools to assess whether bonds are rich, cheap, or fair. Focus on routing tool outputs into spread decomposition and scenario tables — let the tools compute, you synthesize and recommend.
Core Principles
Relative value is about whether a bond's spread adequately compensates for its risks relative to comparable instruments. Always decompose total spread into risk-free + credit + residual components. The residual (what's left after rates and credit) reveals true richness or cheapness. Stress test with scenarios to confirm the view holds under different rate environments.
Available MCP Tools
bond_price— Price bonds. Returns clean/dirty price, yield, duration, convexity, DV01, Z-spread. Accepts ISIN, RIC, or CUSIP.interest_rate_curve— Government and swap yield curves. Two-phase: list then calculate. Use to compute G-spreads.credit_curve— Credit spread curves by issuer type. Two-phase: search by country/issuerType, then calculate. Use to isolate credit component.yieldbook_scenario— Scenario analysis with parallel rate shifts. Returns price change and P&L under each scenario.tscc_historical_pricing_summaries— Historical pricing data. Use for historical spread context and Z-score analysis.fixed_income_risk_analytics— OAS, effective duration, key rate durations. Use for callable bonds and deeper risk decomposition.
Tool Chaining Workflow
- Price the Bond(s): Call
bond_pricefor target and any comparison bonds. Extract yield, Z-spread, duration, convexity, DV01. - Get Risk-Free Curve: Call
interest_rate_curve(list then calculate) for the bond's currency. Interpolate at bond maturity to compute G-spread. - Get Credit Curve: Call
credit_curvefor the issuer's country and type. Extract credit spread at the bond's maturity. Compute residual spread = G-spread minus credit curve spread. - Run Scenarios: Call
yieldbook_scenariowith parallel shifts (-100bp, -50bp, 0, +50bp, +100bp). Extract price changes and P&L per scenario. - Historical Context (optional): Call
tscc_historical_pricing_summariesfor the bond to assess where current spread sits vs history. - Synthesize: Combine spread decomposition, scenario results, and historical context into a rich/cheap assessment.
Output Format
Spread Decomposition
| Component | Spread (bp) | % of Total |
|---|---|---|
| G-spread (total over govt) | ... | 100% |
| Credit curve spread | ... | ...% |
| Residual (liquidity + technicals) | ... | ...% |
Scenario P&L
| Scenario | Price Change | P&L (per 100 notional) |
|---|---|---|
| -100bp | ... | ... |
| -50bp | ... | ... |
| Base | ... | ... |
| +50bp | ... | ... |
| +100bp | ... | ... |
Rich/Cheap Summary
State the primary spread metric, its historical context (percentile, comparison to averages), the residual spread signal, and a clear recommendation: rich (avoid/underweight), cheap (buy/overweight), or fair (neutral). Quantify how many bp of spread move would change the recommendation.