Agent skill

Fixed Income Sovereign

by JoelLewis in JoelLewis/finance_skills

Analyze US Treasury securities and interest rate risk: bond pricing, yield curve construction, duration, convexity, TIPS, and forward/spot rate analysis.

MITAuto-check passedBusiness, Finance & HR

Install Fixed Income Sovereign

skills CLI
$ npx skills add JoelLewis/finance_skills --skill fixed-income-sovereign -a claude-code

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

GitHub CLI
$ gh skill install JoelLewis/finance_skills fixed-income-sovereign --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/fixed-income-sovereign .claude/skills/fixed-income-sovereign && 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
fixed-income-sovereign
GitHub stars
206
Token cost
~1.8k tokens
SKILL.md length
900 words
Files
2 (incl. scripts)
Skills in repo
91
Repo updated
First seen
Licence
MIT

At a glance

Analyze US Treasury securities and interest rate risk: bond pricing, yield curve construction, duration, convexity, TIPS, and forward/spot rate analysis.

  • The user asks about Treasury bonds
  • SKILL.md covers Core Concepts, Key Formulas, Worked Examples and Common Pitfalls, plus 2 more sections
  • Runs Python scripts from its folder; calls uv, python3 and python
  • Yield curve construction

What it does

Fixed Income Sovereign is an agent skill from JoelLewis/finance_skills. Analyze US Treasury securities and interest rate risk: bond pricing, yield curve construction, duration, convexity, TIPS, and forward/spot rate analysis. Use when the user asks about Treasury bonds, yield curve construction, interest rate risk, duration, convexity, TIPS, or breakeven inflation rates. Also trigger when users mention 'T-bills', 'T-notes', 'bond pricing', 'yield to maturity', 'inverted yield curve', 'forward rates', 'spot rates', 'DV01', 'real yields', or ask how bonds react to interest rate changes.

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

It sits in Business, Finance & HR. It works with React. 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 Treasury bonds
  • Yield curve construction
  • Interest rate risk
  • Breakeven inflation rates

Example prompts

  • “T-bills”
  • “T-notes”
  • “bond pricing”
  • “/fixed-income-sovereign”

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
    • python

    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

Fixed Income Sovereign loads about 1.8k tokens when it runs. Until then it costs about 136 tokens; SKILL.md has 900 words of instructions outside code blocks.

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

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). 900 words, ~1,840 tokens.

Download SKILL.mdSave it as .claude/skills/fixed-income-sovereign/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
fixed-income-sovereign
description
Analyze US Treasury securities and interest rate risk: bond pricing, yield curve construction, duration, convexity, TIPS, and forward/spot rate analysis. Use when the user asks about Treasury bonds, yield curve construction, interest rate risk, duration, convexity, TIPS, or breakeven inflation rates. Also trigger when users mention 'T-bills', 'T-notes', 'bond pricing', 'yield to maturity', 'inverted yield curve', 'forward rates', 'spot rates', 'DV01', 'real yields', or ask how bonds react to interest rate changes.

Fixed Income — Sovereign

Scope: US Treasuries and rates analytics. Sovereign credit risk — emerging market debt, default analysis, country risk spreads — is out of scope for this skill.

Core Concepts

Bond Pricing

The price of a bond is the present value of its future cash flows:

P = sum(t=1 to n) [C / (1+y)^t] + F / (1+y)^n

where C = coupon payment per period, y = yield to maturity per period, F = face value, n = total number of periods. For semi-annual bonds, divide the annual coupon by 2 and the annual yield by 2, and double the number of years to get n.

Yield to Maturity (YTM)

The discount rate y that solves the bond pricing equation — the single rate that equates the bond's market price to the present value of all future cash flows. Assumes reinvestment of coupons at the YTM rate. It is the standard yield measure for bonds.

Current Yield

Current Yield = Annual Coupon / Price. A simple income measure that ignores capital gains/losses and the time value of money.

Yield Curve: Spot Rates, Forward Rates, Par Curve

The spot curve gives zero-coupon yields for each maturity. The par curve gives coupon rates at which bonds would price at par. Forward rates are implied future rates derived from spot rates. The three curves contain equivalent information and can be derived from one another.

Bootstrapping the Spot Curve

Extract spot (zero-coupon) rates from par yields by starting at the shortest maturity and working outward. Each step uses previously derived spot rates to solve for the next spot rate.

Forward Rate

The implied rate between two future dates derived from spot rates:

f(t1,t2) = [(1+s_t2)^t2 / (1+s_t1)^t1]^(1/(t2-t1)) - 1

where s_t1 and s_t2 are spot rates for maturities t1 and t2.

Duration (Macaulay)

The weighted average time to receive cash flows, where weights are the present value of each cash flow as a proportion of the bond's price:

D_mac = (1/P) × sum(t × CF_t / (1+y)^t)

Measured in years. Longer maturity, lower coupon, and lower yield all increase duration.

Modified Duration

D_mod = D_mac / (1 + y/m)

where m = number of coupon periods per year. Gives the approximate percentage price change for a 1 percentage point change in yield: dP/P ≈ -D_mod × dy.

Dollar Duration (DV01)

The dollar change in price for a 1 basis point change in yield:

DV01 ≈ -D_mod × P × 0.0001

Used for hedging — match DV01 exposures to immunize a portfolio against parallel rate shifts.

Convexity

Measures the curvature of the price-yield relationship (second derivative):

C = (1/P) × sum(t(t+1) × CF_t / (1+y)^(t+2))

For option-free bonds, convexity is always positive — duration alone overstates losses and understates gains.

Price Change Approximation

ΔP/P ≈ -D_mod × Δy + 0.5 × Convexity × (Δy)²

The convexity term is a correction that becomes important for large yield changes.

TIPS (Treasury Inflation-Protected Securities)

Principal adjusts with CPI. The coupon rate is fixed but applied to the inflation-adjusted principal. Real yield = TIPS yield. Breakeven inflation = nominal Treasury yield - TIPS real yield. TIPS have a deflation floor that protects par value at maturity.

Key Rate Duration

Sensitivity to specific points on the yield curve (e.g., 2yr, 5yr, 10yr, 30yr). Allows analysis of non-parallel yield curve shifts such as steepening, flattening, or butterfly moves. Sum of key rate durations equals effective duration.

Show full SKILL.md (377 more words)Show less

Key Formulas

FormulaExpressionUse Case
Bond PriceP = sum C/(1+y)^t + F/(1+y)^nPrice from yield
Current YieldAnnual Coupon / PriceSimple income measure
Forward Ratef(t1,t2) = [(1+s_t2)^t2 / (1+s_t1)^t1]^(1/(t2-t1)) - 1Implied future rate
Macaulay Duration(1/P) × sum(t × CF_t / (1+y)^t)Weighted avg time to cash flows
Modified DurationD_mac / (1 + y/m)% price sensitivity to yield
DV01D_mod × P × 0.0001Dollar price change per 1bp
Convexity(1/P) × sum(t(t+1) × CF_t / (1+y)^(t+2))Curvature of price-yield curve
Price ChangeΔP/P ≈ -D_mod×Δy + 0.5×Convexity×(Δy)²Estimate price impact of rate move

Worked Examples

Example 1: Price a 5-Year 4% Semi-Annual Coupon Bond at 5% YTM

Given: Face = $1,000, coupon = 4% (semi-annual), YTM = 5%, maturity = 5 years Calculate: Bond price Solution: Semi-annual coupon = $1,000 × 4% / 2 = $20 Semi-annual yield = 5% / 2 = 2.5% Number of periods = 5 × 2 = 10 P = $20 × [(1 - (1.025)^(-10)) / 0.025] + $1,000 / (1.025)^10 P = $20 × 8.7521 + $1,000 × 0.7812 P = $175.04 + $781.20 = $956.24

The bond trades at a discount ($956.24 < $1,000) because the coupon rate (4%) is below the market yield (5%).

Example 2: Modified Duration and Price Change Estimate

Given: A bond with Macaulay duration = 4.5 years, YTM = 5% (semi-annual), price = $956.24, convexity = 22.5 Calculate: Estimated price change for a +50bp rate increase Solution: D_mod = 4.5 / (1 + 0.05/2) = 4.5 / 1.025 = 4.39 years ΔP/P ≈ -4.39 × 0.005 + 0.5 × 22.5 × (0.005)² ΔP/P ≈ -0.02195 + 0.000281 = -0.02167 = -2.167% ΔP ≈ -2.167% × $956.24 = -$20.72 New price ≈ $956.24 - $20.72 = $935.52

Duration alone would estimate -2.195%; the convexity correction reduces the estimated loss by about 3bp.

Common Pitfalls

  • Confusing Macaulay and modified duration — Macaulay is in years, modified gives price sensitivity
  • Ignoring convexity for large yield changes — duration alone overstates losses and understates gains
  • Day count conventions (30/360 vs actual/actual) — Treasuries use actual/actual, corporates use 30/360
  • Clean price vs dirty price (accrued interest) — quoted prices exclude accrued interest, but settlement requires paying it

Cross-References

  • time-value-of-money (core plugin): discounting and present value fundamentals
  • fixed-income-corporate (wealth-management plugin): credit spreads over the sovereign curve
  • fixed-income-municipal (wealth-management plugin): muni-to-Treasury yield ratios
  • asset-allocation (wealth-management plugin): bonds as an asset class in portfolio construction

Running the Script

bash
uv run scripts/fixed_income_sovereign.py            # run the demo (uses PEP 723 inline deps)
uv run scripts/fixed_income_sovereign.py --verify   # check demo outputs against the worked examples (exit 1 on mismatch)
python3 scripts/fixed_income_sovereign.py            # alternative (requires: pip install numpy scipy)

The demo prints the calculations covered above; its values match the worked examples in this skill. Run --help for a list of the classes and functions. For programmatic use, import the module rather than running it — the demo only executes under python fixed_income_sovereign.py.

© 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/wealth-management/skills/fixed-income-sovereign of JoelLewis/finance_skills.

  • SKILL.md
  • scripts/fixed_income_sovereign.py

Open the folder on GitHubat commit 5c498ea

Compare with similar skills

Fixed Income Sovereign 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.

Fixed Income Sovereign compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fixed Income Sovereign this skillJoelLewis/finance_skills206—~1.8kAutomated safety check: PassMIT
Build Resume Portfolio Sitetao943/build-resume-portfolio-site195—~5.8kAutomated safety check: PassNone
Flyai X402alextitonis/fly.ai141—~1.6kAutomated safety check: PassMIT
Discord Readerhimself65/finance-skills3.4k—~1.8kAutomated safety check: PassMIT
Widget Creatormitchdenny/hex1b179—~7.6kAutomated safety check: PassMIT
Databricks App Designdatabricks/databricks-agent-skills345—~1.8kAutomated safety check: PassCustom licence

Similar skills

  • Build Resume Portfolio Site

    tao943/build-resume-portfolio-site

    A skill your agent uses when turning resume materials and an optional job description into verified, approved content and a runnable React + Vite resume or portfolio site, or when redesigning an…

    195 GitHub stars~5.8k tokensUpdated 10 days ago
    Business, Finance & HRAuto-check passed
  • Flyai X402

    alextitonis/fly.ai

    Buy single answers from fly.ai's pay-per-request API, a few cents each over x402 (USDG on Robinhood Chain or USDC on Base) - the fly desk model's read of a Polymarket market, a TimesFM forecast for…

    141 GitHub stars~1.6k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Discord Reader

    himself65/finance-skills

    Read Discord for financial research through opencli connected to the Discord desktop app: servers, channels, members, recent messages in the active channel, and message search.

    3.4k GitHub stars~1.8k tokensUpdated 6 days ago
    Business, Finance & HRAuto-check passed
  • Widget Creator

    mitchdenny/hex1b

    Step-by-step guide for creating new widgets in the Hex1b TUI library.

    179 GitHub stars~7.6k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Databricks App Design

    databricks/databricks-agent-skills

    Official

    Design the UX of custom-code Databricks Apps (AppKit/React) data screens — KPI/overview pages, reports, charts, tables, and Genie/chat data assistants — mapped to concrete AppKit components.

    345 GitHub stars~1.8k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Curviate Engage

    davila7/claude-code-templates

    Create and engage with LinkedIn content using the Curviate CLI.

    33k GitHub stars~3.8k tokensUpdated yesterday
    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

Works with

Questions about Fixed Income Sovereign

What does Fixed Income Sovereign do?

Analyze US Treasury securities and interest rate risk: bond pricing, yield curve construction, duration, convexity, TIPS, and forward/spot rate analysis. Fixed Income Sovereign is an agent skill from JoelLewis/finance_skills. Analyze US Treasury securities and interest rate risk: bond pricing, yield curve construction, duration, convexity, TIPS, and forward/spot rate analysis.

When should I use Fixed Income Sovereign?

Fixed Income Sovereign fits situations like: the user asks about Treasury bonds; yield curve construction; interest rate risk; breakeven inflation rates.

How do I install Fixed Income Sovereign in Claude Code?

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

How do I install Fixed Income Sovereign in Codex?

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

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

What does Fixed Income Sovereign need to run?

Going by SKILL.md and its folder, Fixed Income Sovereign needs Python for the scripts in its folder and the command-line tools its instructions call (uv, python3 and python). Our summary lists: Python 3.

Does Fixed Income Sovereign 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 Fixed Income Sovereign 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 Fixed Income Sovereign use?

Fixed Income Sovereign 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 Fixed Income Sovereign use?

About 1.8k tokens (SKILL.md is roughly 7.4k 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 Fixed Income Sovereign?

Skills that share tags, products or a category with Fixed Income Sovereign: Build Resume Portfolio Site (tao943/build-resume-portfolio-site, 195 stars), Flyai X402 (alextitonis/fly.ai, 141 stars), Discord Reader (himself65/finance-skills, 3.4k stars) and Widget Creator (mitchdenny/hex1b, 179 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fixed Income Sovereign?

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.