Agent skill

Fixed Income Municipal

by JoelLewis in JoelLewis/finance_skills

Analyze municipal bonds including tax-equivalent yield calculations, GO vs revenue bond evaluation, and muni credit analysis.

MITAuto-check passedBusiness, Finance & HR

Install Fixed Income Municipal

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

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

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

At a glance

Analyze municipal bonds including tax-equivalent yield calculations, GO vs revenue bond evaluation, and muni credit analysis.

  • The user asks about municipal 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
  • Tax-exempt income

What it does

Fixed Income Municipal is an agent skill from JoelLewis/finance_skills. Analyze municipal bonds including tax-equivalent yield calculations, GO vs revenue bond evaluation, and muni credit analysis. Use when the user asks about municipal bonds, tax-exempt income, tax-equivalent yield, AMT bonds, callable bonds, yield-to-worst on munis, or muni credit quality. Also trigger when users mention 'muni bonds', 'tax-free bonds', 'state tax exemption', 'general obligation', 'revenue bonds', 'Build America Bonds', 'muni yield ratio', 'de minimis rule', or ask whether munis make sense for their…

Its SKILL.md is about 1.9k 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_municipal.py`).

It sits in Business, Finance & HR, covering Tax preparation. 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 municipal bonds
  • Tax-exempt income
  • Tax-equivalent yield
  • Yield-to-worst on munis

Example prompts

  • “muni bonds”
  • “tax-free bonds”
  • “state tax exemption”
  • “/fixed-income-municipal”

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 Municipal loads about 1.9k tokens when it runs. Until then it costs about 139 tokens; SKILL.md has 914 words of instructions outside code blocks.

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

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). 914 words, ~1,877 tokens.

Download SKILL.mdSave it as .claude/skills/fixed-income-municipal/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
fixed-income-municipal
description
Analyze municipal bonds including tax-equivalent yield calculations, GO vs revenue bond evaluation, and muni credit analysis. Use when the user asks about municipal bonds, tax-exempt income, tax-equivalent yield, AMT bonds, callable bonds, yield-to-worst on munis, or muni credit quality. Also trigger when users mention 'muni bonds', 'tax-free bonds', 'state tax exemption', 'general obligation', 'revenue bonds', 'Build America Bonds', 'muni yield ratio', 'de minimis rule', or ask whether munis make sense for their tax bracket.

Fixed Income — Municipal

Core Concepts

General Obligation (GO) Bonds

Backed by the full faith, credit, and taxing power of the issuing municipality. The issuer pledges to use any available revenue source (property tax, income tax, sales tax) to repay bondholders. GO bonds typically require voter approval and are considered safer due to the broad taxing pledge.

Revenue Bonds

Backed solely by the revenue generated from a specific project or source — toll roads (toll collections), water/sewer systems (utility fees), hospitals (patient revenue), airports (landing fees, terminal rents). Revenue bonds typically carry higher yields than GO bonds of comparable maturity and credit quality because of the narrower revenue pledge.

Tax-Equivalent Yield (TEY)

The core calculation for comparing municipal bonds to taxable alternatives:

Federal only: TEY = Muni Yield / (1 - federal_marginal_rate)

Federal + state (for in-state munis): TEY = Muni Yield / (1 - federal_rate - state_rate × (1 - federal_rate))

This converts a tax-exempt yield to the pre-tax yield a taxable bond would need to offer to match the muni's after-tax income.

Note: the state_rate × (1 - federal_rate) term assumes state income tax is fully deductible against federal tax. For taxpayers at or above the SALT deduction cap (or taking the standard deduction), state tax provides no incremental federal deduction, and the formula simplifies to TEY = Muni Yield / (1 - federal_rate - state_rate) — the combined formula above understates the in-state muni's advantage for capped itemizers and overstates the precision of the comparison generally. Check the client's actual SALT position before choosing the formula.

Alternative Minimum Tax (AMT)

Certain private activity bonds generate interest that is subject to AMT. For taxpayers subject to AMT, the tax advantage of these bonds is reduced. AMT-subject bonds typically trade at slightly higher yields to compensate. Non-AMT munis (governmental purpose bonds) are not affected.

Muni Credit Analysis

GO bonds: evaluate tax base diversity and trends, debt burden ratios (debt per capita, debt/assessed value), fund balance as % of expenditures, economic base (population, employment), pension/OPEB obligations.

Revenue bonds: evaluate debt service coverage ratio (DSCR = net revenue / annual debt service), rate covenants, additional bonds tests, demand analysis, and reserve fund adequacy.

De Minimis Tax Rule

Discount bonds purchased below a threshold (typically par minus 0.25% per year to maturity) may lose tax-exempt status on the discount portion — the gain is taxed as ordinary income rather than being tax-exempt. This affects the after-tax return calculation for discount munis.

Muni Yield Ratios

Muni yield / Treasury yield. Historically this ratio averages approximately 80% for AAA munis. Ratios above 80-85% suggest munis are cheap relative to Treasuries; below 70% suggests they are rich. The ratio varies with supply/demand, tax policy expectations, and credit conditions.

Build America Bonds (BABs)

Taxable municipal bonds created under the 2009 stimulus. The federal government subsidizes 35% of interest cost. Expired for new issuance after 2010 but outstanding BABs continue to trade. They allowed issuers to access the broader taxable bond market.

Pre-Refunded/Escrowed Bonds

When an issuer advance-refunds a callable bond, it places US Treasuries in escrow sufficient to pay remaining coupons and the call price. These defeased bonds are effectively AAA-quality and trade at very tight spreads.

Key Formulas

FormulaExpressionUse Case
TEY (federal only)Muni Yield / (1 - federal_rate)Compare muni to taxable bond
TEY (federal + state)Muni Yield / (1 - fed_rate - state_rate × (1 - fed_rate))In-state muni comparison
DSCRNet Revenue / Annual Debt ServiceRevenue bond credit quality
De Minimis ThresholdPar - 0.25% × years to maturityTax treatment of discount munis
Muni Yield RatioMuni Yield / Treasury YieldRelative value assessment
Show full SKILL.md (343 more words)Show less

Worked Examples

Example 1: Tax-Equivalent Yield with Federal and State Tax

Given: Muni yield = 3.5%, federal marginal rate = 37%, state marginal rate = 5% Calculate: Tax-equivalent yield for an in-state bond Solution: TEY = 3.5% / (1 - 0.37 - 0.05 × (1 - 0.37)) TEY = 3.5% / (1 - 0.37 - 0.05 × 0.63) TEY = 3.5% / (1 - 0.37 - 0.0315) TEY = 3.5% / 0.5985 TEY = 5.85%

A taxable bond would need to yield 5.85% to match the after-tax income of this 3.5% muni for this taxpayer. The state tax benefit adds approximately 29bp of value compared to the federal-only TEY of 5.56%.

Example 2: GO vs Revenue Bond Comparison

Given: Same issuer, same maturity (10 years). GO bond yields 3.2%, revenue bond (water/sewer) yields 3.6%. DSCR on revenue bond = 1.8x. Calculate: Which bond offers better value? Solution: The revenue bond yields 40bp more than the GO bond. The DSCR of 1.8x is well above the typical 1.25x minimum for investment grade, indicating strong coverage. Water/sewer is an essential service with stable demand. The 40bp additional yield compensates for the narrower revenue pledge, but the strong coverage ratio suggests the credit risk is modest. For investors comfortable with revenue bond structures, the 40bp pickup may represent good relative value.

Common Pitfalls

  • Forgetting state tax benefits for in-state bonds — the combined federal+state TEY can be meaningfully higher than federal-only
  • AMT implications for high-income investors — private activity bond interest may trigger AMT liability
  • De minimis rule on discount munis — gains on deep-discount munis may be taxed as ordinary income
  • Confusing call provisions — many munis are callable at par after 10 years; always check yield-to-worst

Cross-References

  • time-value-of-money (core plugin): present value and discounting fundamentals
  • fixed-income-sovereign (wealth-management plugin): yield curve context and duration concepts
  • fixed-income-corporate (wealth-management plugin): comparing muni spreads to corporate spreads
  • tax-efficiency (wealth-management plugin): muni bonds as a primary tax management tool

Running the Script

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

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_municipal.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-municipal of JoelLewis/finance_skills.

  • SKILL.md
  • scripts/fixed_income_municipal.py

Open the folder on GitHubat commit 5c498ea

Compare with similar skills

Fixed Income Municipal 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 Municipal compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fixed Income Municipal this skillJoelLewis/finance_skills206—~1.9kAutomated safety check: PassMIT
Itr Walakaranb192/itr-wala871—~3.6kAutomated safety check: PassMIT
Tax Filingrobbalian/claude-tax-filing174—~2.5kAutomated safety check: PassNone
India Itr CopilotLoki200399/india-itr-copilot147—~2.4kAutomated safety check: PassMIT
Consumption Taxkazukinagata/shinkoku365—~1.8kAutomated safety check: PassMIT
Beancount Optionsbex-co/beancount-io297—~3.7kAutomated safety check: PassMIT

Similar skills

  • Itr Wala

    karanb192/itr-wala

    File Indian income tax returns (ITR) for FY 2025-26 / AY 2026-27.

    871 GitHub stars~3.6k tokensUpdated 7 days ago
    Business, Finance & HRAuto-check passed
  • Tax Filing

    robbalian/claude-tax-filing

    Prepare and fill federal and state tax return PDF forms. An agent skill from robbalian/claude-tax-filing.

    174 GitHub stars~2.5k tokensUpdated 5 mo ago
    Business, Finance & HRAuto-check passed
  • India Itr Copilot

    Loki200399/india-itr-copilot

    Documents-first copilot for preparing Indian Income Tax Returns (ITR-1/2/3/4, any assessment year).

    147 GitHub stars~2.4k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Consumption Tax

    kazukinagata/shinkoku

    This skill should be used when the user needs to calculate consumption tax (消費税) or determine their tax method (2割特例, 簡易課税, or 本則課税).

    365 GitHub stars~1.8k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Beancount Options

    bex-co/beancount-io

    Record a described options trade or lifecycle event as validated Beancount transactions through bea, after review and confirmation.

    297 GitHub stars~3.7k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Invoice Organizer

    davila7/claude-code-templates

    Automatically organizes invoices and receipts for tax preparation by reading messy files, extracting key information, renaming them consistently, and sorting them into logical folders.

    33k GitHub starsUsed in 12 repos~2.9k tokens
    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 Fixed Income Municipal

What does Fixed Income Municipal do?

Analyze municipal bonds including tax-equivalent yield calculations, GO vs revenue bond evaluation, and muni credit analysis. Fixed Income Municipal is an agent skill from JoelLewis/finance_skills. Analyze municipal bonds including tax-equivalent yield calculations, GO vs revenue bond evaluation, and muni credit analysis.

When should I use Fixed Income Municipal?

Fixed Income Municipal fits situations like: the user asks about municipal bonds; tax-exempt income; tax-equivalent yield; yield-to-worst on munis.

How do I install Fixed Income Municipal in Claude Code?

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

How do I install Fixed Income Municipal in Codex?

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

Can I use Fixed Income Municipal 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-municipal -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-municipal, .gemini/skills/fixed-income-municipal, .github/skills/fixed-income-municipal and .opencode/skills/fixed-income-municipal in your project.

What does Fixed Income Municipal need to run?

Going by SKILL.md and its folder, Fixed Income Municipal 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 Municipal 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 Municipal 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 Municipal use?

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

About 1.9k tokens (SKILL.md is roughly 7.5k 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 Municipal?

Skills that share tags, products or a category with Fixed Income Municipal: Itr Wala (karanb192/itr-wala, 871 stars), Tax Filing (robbalian/claude-tax-filing, 174 stars), India Itr Copilot (Loki200399/india-itr-copilot, 147 stars) and Consumption Tax (kazukinagata/shinkoku, 365 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fixed Income Municipal?

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.