margin-management

2
0
Source

Update Margin Dashboard with Fidelity balance data and calculate margin-living strategy metrics. Monitors margin balance, interest costs, coverage ratios, and scaling thresholds. Triggers safety alerts for large draws and provides time-based scaling recommendations. Use when updating margin, balances, coverage ratio, or margin strategy analysis.

Install

mkdir -p .claude/skills/margin-management && curl -L -o skill.zip "https://mcp.directory/api/skills/download/3974" && unzip -o skill.zip -d .claude/skills/margin-management && rm skill.zip

Installs to .claude/skills/margin-management

About this skill

Margin Management

Purpose

Monitor and manage margin-living strategy by tracking margin balances, interest costs, dividend coverage ratios, and portfolio-to-margin safety thresholds. Provides data-driven scaling recommendations based on strategy milestones.

When to Use

Use this skill when:

  • Importing new Fidelity balances CSV
  • Updating margin balance or interest rate
  • Calculating coverage ratio (dividends ÷ interest)
  • User mentions: "margin dashboard", "margin balance", "coverage ratio", "margin strategy"
  • Assessing margin scaling decisions
  • Checking safety thresholds

Core Workflow

1. Read Fidelity Balances CSV

Location: notebooks/updates/Balances_for_Account_{account_id}.csv

Key Fields to Extract:

Balance,Day change
Total account value,228809.41,3447.61      → Portfolio Value
Margin buying power,193919.92,-4667.04
Net debit,-2992.70,-2191.14                 → Margin Balance (abs value)
Margin interest accrued this month,1.12,    → Monthly Interest (actual)

Calculations:

  • Margin Balance: Absolute value of "Net debit" = $2,992.70
  • Interest Rate: Default 10.875% (Fidelity $1k-$24.9k tier) unless specified
  • Monthly Interest Cost: Balance × Rate ÷ 12 = $2,992.70 × 0.10875 ÷ 12 = $27.11

2. Safety Check: Margin Jump Alert

Rule: If new margin balance > previous balance + $5,000, STOP

Reason: Large draws should be intentional per margin-living strategy

Example:

Previous: $2,992.70
Current: $9,500.00 (+$6,507.30) → 🚨 ALERT - Confirm intentional draw

Action:

  • Alert user immediately
  • Show diff: "Margin increased by $6,507 - Confirm this was intentional"
  • Wait for user confirmation before proceeding

3. Add Entry to Margin Dashboard

Insert new row with:

  • Date: Current date (use date +"%Y-%m-%d")
  • Margin Balance: From Balances CSV (Net debit absolute value)
  • Interest Rate: 10.875% (or updated rate from CSV if available)
  • Monthly Interest Cost: Calculate (Balance × Rate ÷ 12)
  • Notes: Auto-generate based on elapsed time since Oct 9, 2025

Example Entry:

Date: 2025-11-11
Margin Balance: $2,992.70
Interest Rate: 10.875%
Monthly Interest Cost: $27.11
Notes: Month 1 - Building foundation, on track per strategy

Notes Generation Logic:

months_elapsed = (current_date - datetime(2025, 10, 9)).days // 30

if months_elapsed < 6:
    note = f"Month {months_elapsed} - Building foundation, on track per strategy"
elif months_elapsed < 12:
    note = f"Month {months_elapsed} - Approaching Month 6 milestone"
elif months_elapsed < 18:
    note = f"Month {months_elapsed} - Approaching break-even milestone"
else:
    note = f"Month {months_elapsed} - Mature strategy, monitor scaling"

4. Update Summary Section

Recalculate Dashboard Metrics:

Current Margin Balance

= Latest entry from Margin Dashboard
Example: $2,992.70

Monthly Interest Cost

= Latest calculated cost
Example: $27.11/month

Annual Interest Cost

= Monthly Interest Cost × 12
Example: $27.11 × 12 = $325.32/year

Dividend Income (from Dividend Tracker)

= Pull from Dividend Tracker "TOTAL EXPECTED DIVIDENDS"
Example: $2,847.32/month

Coverage Ratio

= Dividend Income ÷ Monthly Interest Cost
Formula: =IFERROR(Dividends / Interest, 0)
Example: $2,847.32 ÷ $27.11 = 105.0x 🟢

Fix #DIV/0! if margin balance = $0:

Before: =B10 / B11  (causes #DIV/0! when margin = 0)
After: =IFERROR(B10 / B11, 0)  (returns 0 when no margin)

5. Calculate Strategy Metrics

Portfolio-to-Margin Ratio

= Total account value ÷ Margin Balance
Example: $228,809.41 ÷ $2,992.70 = 76.5:1 🟢🟢🟢

Safety Thresholds:

  • 🟢 Green: Ratio > 4.0:1 (target - healthy margin usage)
  • 🟡 Yellow: Ratio 3.5-4.0:1 (warning - pause scaling)
  • 🔴 Red: Ratio < 3.0:1 (alert - stop draws, inject business income)
  • Critical: Ratio < 2.5:1 (emergency - inject $30k+, consider selling)

Current Draw vs Fixed Expenses

Current monthly draw: $4,500 (fixed expenses only)
Target: Start with $4,500, scale to $6,213, $8,000, $10,000 based on data

6. Scaling Alerts (Time-Based)

Strategy Start Date: October 9, 2025

Calculate months elapsed:

from datetime import datetime
start = datetime(2025, 10, 9)
current = datetime.now()
months_elapsed = (current - start).days // 30

Month 6 Alert (April 2026)

📊 MONTH 6 MILESTONE CHECK:
✅ Dividends: $2,847/month (need $2,000+)
✅ Portfolio-to-Margin Ratio: 76.5:1 (need 4:1+)
✅ Dividend Growth: On track

🎯 RECOMMENDATION: Scale margin draw to $6,213/month (add mortgage)
- Current: $4,500 (fixed expenses only)
- New: $6,213 (fixed + mortgage)
- Safety margin: Excellent

Month 12 Alert (October 2026)

📊 MONTH 12 BREAK-EVEN CHECK:
Expected Dividends: $4,500+/month (goal: break-even with margin interest)
✅ IF achieved: Consider scaling to $8,000/month (add some variable expenses)
⚠️ IF not: Hold at $6,213, assess strategy

Month 18 Alert (April 2027)

📊 MONTH 18 MATURE STRATEGY CHECK:
Expected Dividends: $7,000+/month
Expected Margin: Declining (dividends paying down debt)
✅ IF achieved: Consider scaling to $10,000/month (most variable expenses)
⚠️ IF not: Hold current level, reassess timeline

7. Alert Thresholds

Generate alerts based on conditions:

Green (Healthy)

✅ Ratio > 4:1 AND dividends covering interest
Status: On track, continue per strategy

Yellow (Caution)

⚠️ Ratio 3.5-4:1 OR dividend coverage declining
Action: Pause scaling, monitor weekly

Red (Alert)

🚨 Ratio < 3:1 OR dividend cuts detected
Action: STOP draws, inject $20k business income

Critical (Emergency)

⛔ Ratio < 2.5:1 OR margin call risk
Action: STOP draws, inject $30k+ business income, consider selling hedge (SQQQ)

Critical Rules

WRITABLE Columns (Margin Dashboard)

  • ✅ Date (Column A)
  • ✅ Margin Balance (Column B)
  • ✅ Interest Rate (Column C)
  • ✅ Monthly Interest Cost (Column D - calculated but writeable)
  • ✅ Notes (Column E)

SACRED Formulas (NEVER TOUCH)

  • ❌ Coverage Ratio (unless adding IFERROR wrapper)
  • ❌ Summary section totals (unless fixing #DIV/0!)

Margin Strategy Philosophy

Core Principle: Confidence-based scaling, not time-based mandates

Decision Framework:

  1. Data-driven: Decisions backed by actual dividend income, not projections
  2. Safety-first: Never scale if ratio drops below 3.5:1
  3. Business income as insurance: Available $22k/month, not primary strategy
  4. Monte Carlo backstop: 98.5% of scenarios used business income at some point

Business Income Backstop

Available: $22,000/month from business operations

Usage Scenarios:

  1. Margin call (ratio < 3:1): MUST USE business income immediately
  2. ⚠️ Market correction (20-30% drop): OPTIONAL - assess need
  3. 🎯 Acceleration (reach FI faster): OPTIONAL - strategic choice

Current Philosophy: Insurance policy only, not active strategy component

Example Calculations

Scenario 1: Month 1 (Current State)

Portfolio Value: $228,809.41
Margin Balance: $2,992.70
Ratio: 76.5:1 🟢🟢🟢

Monthly Interest: $27.11
Dividend Income: $2,847.32
Coverage: 105.0x 🟢

Status: Excellent - building foundation

Scenario 2: Month 6 (Projected)

Portfolio Value: $280,000 (projected with W2 contributions)
Margin Balance: $25,000 (scaled to $6,213/month draw)
Ratio: 11.2:1 🟢

Monthly Interest: $227
Dividend Income: $4,500 (projected)
Coverage: 19.8x 🟢

Status: Healthy - on track for break-even

Scenario 3: Month 15 (Break-Even)

Portfolio Value: $350,000
Margin Balance: $50,000 (scaled to $8,000/month draw)
Ratio: 7.0:1 🟢

Monthly Interest: $453
Dividend Income: $6,800
Coverage: 15.0x 🟢

Status: Break-even achieved, dividends > interest

Google Sheets Integration

Spreadsheet ID: Read from fin-guru/data/user-profile.yamlgoogle_sheets.portfolio_tracker.spreadsheet_id

Use the mcp__gdrive__sheets tool:

// STEP 1: Read Spreadsheet ID from user profile
// Load fin-guru/data/user-profile.yaml
// Extract: google_sheets.portfolio_tracker.spreadsheet_id

// STEP 2: Read Margin Dashboard
mcp__gdrive__sheets(
    operation: "spreadsheets.values.get",
    params: {
        spreadsheetId: SPREADSHEET_ID,  // from user-profile.yaml
        range: "Margin Dashboard!A2:E50"
    }
)

// STEP 3: Add new margin entry
mcp__gdrive__sheets(
    operation: "spreadsheets.values.update",
    params: {
        spreadsheetId: SPREADSHEET_ID,  // from user-profile.yaml
        range: "Margin Dashboard!A2:E2",
        valueInputOption: "USER_ENTERED",
        requestBody: {
            values: [[date, balance, rate, monthly_cost, notes]]
        }
    }
)

Agent Permissions

Margin Specialist (Write-enabled):

  • Can add new entries to Margin Dashboard
  • Can update margin balance, rate, cost
  • Can generate scaling alerts
  • CANNOT modify summary formulas (without formula-protection skill)

Builder (Write-enabled):

  • Can repair broken formulas (#DIV/0!)
  • Can update summary section calculations
  • Can add new metrics

All Other Agents (Read-only):

  • Market Researcher, Quant Analyst, Strategy Advisor
  • Can read margin data for analysis
  • Cannot write to spreadsheet
  • Must defer to Margin Specialist or Builder

Reference Files

For complete strategy details, see:

  • Margin Strategy: fin-guru-private/fin-guru/strategies/active/margin-living-master-strategy.md
  • Portfolio Strategy: fin-guru-private/fin-guru/strategies/active/portfolio-master-strategy.md
  • User Profile: fin-guru/data/user-profile.yaml
  • Spreadsheet Architecture: fin-guru/data/spreadsheet-architecture.md

Pre-Flight Checklist

Before updating Margin Dashboard:

  • Fidelity Balances CSV is latest by date
  • CSV is in notebooks/updates/ directory
  • Margin Dashboard sheet exists in Google Sheets
  • Previous margin balance known (for jump detection)
  • Dividend Tracker is up-to-date (for coverage ratio)
  • Current date retrieved via date command

Example Scenario

Trigger: User downloads new Fidelity balances CSV

Agent workflow:

  1. ✅ Read Balances CSV - Portfolio: $228,809.41, Margin: $2,992.70
  2. ✅ Safety check - Previous: $0, Current: $2,992.70 (+$2,992.70 < $5k threshold) - PASS
  3. ✅ Calculate metrics:
    • Monthly interest: $27.11
    • Portfolio-to-margin ratio: 76.5:1
    • Coverage ratio: 105.0x (dividends ÷ interest)
  4. ✅ Add entry to Margin Dashboard:
    • Date: 2025-11-11
    • Balance: $2,992.70
    • Rate: 10.875%
    • Cost: $27.11
    • Notes: "Month 1 - Building foundation, on track"
  5. ✅ Update summary section:
    • Current balance: $2,992.70
    • Monthly cost: $27.11
    • Annual cost: $325.32
    • Dividend income: $2,847.32
    • Coverage: 105.0x
  6. ✅ Generate status: "🟢 Excellent health - Ratio 76.5:1, Coverage 105x"
  7. ✅ LOG: "Updated Margin Dashboard - Month 1, $2,992.70 balance, 76.5:1 ratio"

Skill Type: Domain (workflow guidance) Enforcement: BLOCK (financial risk critical) Priority: Critical Line Count: < 400 (following 500-line rule) ✅

More by AojdevStudio

View all →

portfoliosyncing

AojdevStudio

Import and sync broker CSV portfolio data to Google Sheets DataHub. Supports multiple brokers (Fidelity, Schwab, Vanguard, etc.). USE WHEN user mentions import broker data OR sync portfolio OR update positions OR CSV import OR portfolio-sync OR working with Portfolio_Positions CSVs. Handles position updates, SPAXX/margin validation, safety checks, and formula protection.

220

formula-protection

AojdevStudio

Prevent accidental modification of sacred spreadsheet formulas in Google Sheets Portfolio Tracker. Blocks edits to GOOGLEFINANCE formulas, calculated columns, and total rows. Allows only IFERROR wrappers, fixing broken references, and expanding ranges. Triggers on update formula, modify column, fix errors, or any attempt to edit formula-based cells.

00

retirement-syncing

AojdevStudio

Sync retirement account data from Vanguard and Fidelity CSV exports to Google Sheets DataHub. Handles multiple accounts, aggregates holdings by ticker, and updates quantities in retirement section (rows 46-62). Triggers on sync retirement, update retirement, vanguard sync, 401k update, IRA sync, or working with notebooks/retirement-accounts/ files.

30

financereport

AojdevStudio

Generate institutional-quality PDF analysis reports for stocks and ETFs. USE WHEN user mentions generate report, create pdf, stock analysis, ticker report, watchlist analysis, OR regenerate reports. Includes VGT-style headers, embedded charts, portfolio sizing, and Perplexity sentiment integration.

200

transactionsyncing

AojdevStudio

Import Fidelity transaction history CSV into Google Sheets with smart categorization. USE WHEN user mentions "sync transactions", "import transactions", "transaction history", OR wants to import Fidelity History CSV. Routes debit card purchases to Expense Tracker with auto-categorization.

40

montecarlo

AojdevStudio

Run Monte Carlo simulations for Finance Guru portfolio strategy. USE WHEN user mentions monte carlo OR run simulation OR stress test portfolio OR probability analysis OR income projections OR margin safety analysis. Supports 4-layer portfolio (Growth, Income, Hedge, GOOGL) with auto-detection of current values from Fidelity CSV.

00

You might also like

flutter-development

aj-geddes

Build beautiful cross-platform mobile apps with Flutter and Dart. Covers widgets, state management with Provider/BLoC, navigation, API integration, and material design.

302793

drawio-diagrams-enhanced

jgtolentino

Create professional draw.io (diagrams.net) diagrams in XML format (.drawio files) with integrated PMP/PMBOK methodologies, extensive visual asset libraries, and industry-standard professional templates. Use this skill when users ask to create flowcharts, swimlane diagrams, cross-functional flowcharts, org charts, network diagrams, UML diagrams, BPMN, project management diagrams (WBS, Gantt, PERT, RACI), risk matrices, stakeholder maps, or any other visual diagram in draw.io format. This skill includes access to custom shape libraries for icons, clipart, and professional symbols.

233431

godot

bfollington

This skill should be used when working on Godot Engine projects. It provides specialized knowledge of Godot's file formats (.gd, .tscn, .tres), architecture patterns (component-based, signal-driven, resource-based), common pitfalls, validation tools, code templates, and CLI workflows. The `godot` command is available for running the game, validating scripts, importing resources, and exporting builds. Use this skill for tasks involving Godot game development, debugging scene/resource files, implementing game systems, or creating new Godot components.

220301

nano-banana-pro

garg-aayush

Generate and edit images using Google's Nano Banana Pro (Gemini 3 Pro Image) API. Use when the user asks to generate, create, edit, modify, change, alter, or update images. Also use when user references an existing image file and asks to modify it in any way (e.g., "modify this image", "change the background", "replace X with Y"). Supports both text-to-image generation and image-to-image editing with configurable resolution (1K default, 2K, or 4K for high resolution). DO NOT read the image file first - use this skill directly with the --input-image parameter.

226237

ui-ux-pro-max

nextlevelbuilder

"UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 8 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient."

176201

rust-coding-skill

UtakataKyosui

Guides Claude in writing idiomatic, efficient, well-structured Rust code using proper data modeling, traits, impl organization, macros, and build-speed best practices.

167173

Stay ahead of the MCP ecosystem

Get weekly updates on new skills and servers.