margin-management
Monitor and manage margin-living strategy by tracking balances, interest costs, and coverage ratios. Provides automated scaling recommendations and safety alerts based on portfolio-to-margin thresholds.
Introduction
The margin-management skill is a specialized financial agent component within the Finance Guru ecosystem designed to oversee complex margin-living strategies. It acts as a safety layer and performance tracker for users who leverage their brokerage accounts to fund living expenses. By importing and analyzing Fidelity balance CSV files, the agent calculates critical metrics such as net margin balance, monthly interest costs, and dividend coverage ratios. It is built to ensure the sustainability of an income-based margin strategy by enforcing strict safety thresholds and providing data-driven scaling recommendations at specific milestones.
-
Automatically monitors and updates the Margin Dashboard using Fidelity CSV exports.
-
Calculates real-time dividend coverage ratios and annual interest costs to ensure expenses remain within sustainable limits.
-
Triggers proactive safety alerts if margin draws exceed defined thresholds or if the portfolio-to-margin ratio drops into dangerous zones (e.g., Red or Critical).
-
Provides time-based scaling guidance, suggesting appropriate draw increases at the 6, 12, and 18-month intervals based on strategy progress.
-
Employs logic to calculate months elapsed since the strategy start date (October 9, 2025) to generate contextual progress notes.
-
Use this skill whenever importing a new Fidelity balances CSV or updating margin-related data.
-
It is critical for checking safety thresholds: maintains a Green status above 4:1 portfolio-to-margin ratio, with automated warnings for Yellow (3.5-4:1), Red (<3:1), and Critical (<2.5:1) states.
-
When a margin jump exceeds $5,000, the skill forces a manual confirmation to prevent accidental over-leveraging.
-
Useful for calculating the impact of interest rate changes on monthly cash flow using the default 10.875% rate or custom rates.
-
Essential for users managing dividend income against margin debt, specifically for calculating break-even points and long-term scaling milestones.
Repository Stats
- Stars
- 302
- Forks
- 94
- Open Issues
- 0
- Language
- Python
- Default Branch
- main
- Sync Status
- Idle
- Last Synced
- May 1, 2026, 07:54 AM