@v587d/capital-generation 2.10.1 → 2.11.0

package/selected-skills/financeskills/skills/inventory-costing/SKILL.md

@@ -1,80 +0,0 @@
----
-name: inventory-costing
-description: When the user wants to value inventory, choose or apply costing methods, or handle write-downs. Also use when the user mentions "FIFO," "weighted average cost," "standard cost," "NRV," "lower of cost and NRV," "inventory write-down," "obsolescence provision," "absorption of overheads into inventory," or "cycle count adjustments."
-metadata:
-  version: 1.0.0
----
-
-# Inventory Costing (IAS 2 / ASC 330)
-
-You are a Cost Accountant. Your goal is to value inventory correctly: right cost formula, right overhead absorption, and disciplined write-downs to net realizable value.
-
-## Initial Assessment
-
-1. **Inventory Profile**
-   - Raw materials, WIP, finished goods, spares/consumables, goods in transit (check shipping terms).
-   - Costing method in use: FIFO, weighted average (periodic vs. moving), standard cost, retail method. (LIFO: US GAAP only, prohibited under IFRS.)
-
-2. **Cost Components**
-   - Purchase cost net of discounts/rebates + import duties + non-recoverable taxes + freight-in.
-   - Conversion costs: direct labor + variable overhead + fixed overhead absorbed at NORMAL capacity.
-   - Excluded: abnormal waste, storage of finished goods, selling costs, admin overhead, FX losses.
-
----
-
-## Costing Framework
-
-### Cost Formula Mechanics
-- **FIFO**: oldest costs to COGS; inventory at recent costs. Rising prices → higher inventory, lower COGS.
-- **Weighted average (moving)**: recompute average after each receipt: `new avg = (qty_old × avg_old + qty_in × cost_in)/(qty_old + qty_in)`.
-- Same formula for all inventories of similar nature and use (IAS 2.25–26) — entity-wide consistency by class.
-
-### Standard Costing Bridge
-Standards permitted if they approximate actual: variances must be analyzed (variance-analysis skill) and material variances PRORATED back into inventory/COGS at period end — expensing all favorable variances while capitalizing unfavorable is a classic earnings-management flag.
-
-### Fixed Overhead Absorption (the audit battleground)
-Rate = budgeted fixed production overhead / NORMAL capacity. Low production → unabsorbed overhead expensed immediately (never inflate unit costs); abnormally high production → decrease the rate (never over-absorb).
-
-### Lower of Cost and NRV
-`NRV = estimated selling price − costs to complete − costs to sell`
-Item-by-item (or similar-item groups); raw materials written down only if the finished product they feed is itself below cost (replacement cost as proxy). Reversals required under IFRS when NRV recovers (to original cost ceiling); prohibited under US GAAP (except LIFO/retail re-measurement nuances).
-
----
-
-## Technical Analysis Steps
-
-1. **Recompute with code**: cost formula application, absorption rates, NRV tests.
-2. **Obsolescence provision matrix**: aging × movement (e.g., no movement 6/12/24 months → 25/50/100% provision), overridden by item-level evidence; validate the matrix annually against actual scrappage outcomes.
-3. **Count adjustments**: book-to-physical differences investigated above threshold, shrinkage trend analysis (forensic-accounting if pattern emerges).
-
----
-
-## Output Format
-
-### Inventory Valuation Memo
-
-**Method & Inputs**: formula, absorption basis, normal capacity stated.
-
-**Computation**: valuation schedule by category with code-verified math.
-
-**NRV/Obsolescence**: items tested, write-downs proposed, provision matrix output.
-
-**Entries**: adjustment JEs (journal-entry format).
-
----
-
-## Scripts
-- [calculate.py](./scripts/calculate.py): Deterministic functions for this skill's core computations. Run `python3 scripts/calculate.py` to self-test; import the functions instead of doing mental math.
-
----
-
-## References
-- [Costing Worked Examples](./references/costing-examples.md): FIFO vs. weighted average, absorption, and NRV calculations.
-
----
-
-## Related Skills
-- **variance-analysis**: Standard cost variances feeding inventory valuation.
-- **product-profitability**: Unit costs flow into margin analysis.
-- **journal-entry**: For adjustment entries.
-- **forensic-accounting**: Shrinkage and count-fraud patterns.

package/selected-skills/financeskills/skills/inventory-costing/references/costing-examples.md

@@ -1,31 +0,0 @@
-# Inventory Costing Worked Examples
-
-## 1. FIFO vs. Weighted Average (same data)
-Purchases: 100 units @ 10; 100 @ 12; 100 @ 15. Sold: 220 units.
-- **FIFO**: COGS = 100×10 + 100×12 + 20×15 = 2,500. Ending inventory = 80×15 = 1,200.
-- **Periodic weighted avg**: avg = 3,700/300 = 12.333. COGS = 220 × 12.333 = 2,713. Ending = 80 × 12.333 = 987.
-- Check: COGS + ending = 3,700 total cost in both methods. Always prove this identity.
-
-## 2. Moving Average With Interleaved Sales
-Start 100 @ 10 (avg 10). Sell 50 → COGS 500, remain 50 @ 10. Buy 100 @ 13 → avg = (500 + 1,300)/150 = 12.00. Sell 100 → COGS 1,200, remain 50 @ 12.
-Moving average is path-dependent — recomputation must follow transaction order, which is why backdated transactions corrupt it.
-
-## 3. Fixed Overhead Absorption at Normal Capacity
-Budgeted FOH 1,200,000; normal capacity 100,000 units → rate 12/unit.
-Actual production 80,000 units → absorbed 960,000; **240,000 unabsorbed → straight to COGS/P&L**, units still carry 12 each. Producing 130,000 units → rate drops to 1,200,000/130,000 = 9.23; never absorb more than actual FOH.
-
-## 4. NRV Test
-Finished good: cost 50; selling price 54; selling costs 6 → NRV 48 → **write down 2/unit**.
-Raw material feeding it: cost 20, replacement 17. Write down ONLY because the finished product is already below cost; use replacement cost 17 as NRV proxy → write down 3.
-
-## 5. Obsolescence Matrix (calibrate to actual outcomes)
-| Last movement | Provision % |
-|---|---|
-| < 6 months | 0 |
-| 6–12 months | 25 |
-| 12–24 months | 50 |
-| > 24 months | 100 |
-Overrides: contracted future use → release; engineering change notices → 100% immediately regardless of age. Backtest yearly: of items provided 50% last year, what % were actually used vs. scrapped?
-
-## 6. Goods in Transit Cut-Off
-FOB shipping point, shipped Dec 28, received Jan 3 → BUYER's inventory at Dec 31 (and the payable). FOB destination → seller's until delivery. Match the freight terms report to the cut-off accrual every close.

package/selected-skills/financeskills/skills/investment-analysis/EXAMPLE.md

@@ -1,21 +0,0 @@
-# Worked Example - investment-analysis
-
-## Ask
-
-> Is Tesla a good buy at $170? Its P/E is 45 and revenue growth is slowing. Can you run a quick valuation?
-
-## What a correct response contains
-
-Should identify the need for a DCF or Multiples analysis. Should discuss the high P/E (45) relative to slowing revenue growth. Should identify key drivers for Tesla (Deliveries, FSD, Margins). Should provide an Investment Memo structure with a target price or recommendation range.
-
-## File-driven variant
-
-With fixture(s) `evals/files/project_cashflows.csv`:
-
-> Evaluate the project in the attached cash-flow file (evals/files/project_cashflows.csv) at a 10% hurdle: NPV, IRR, payback period, and profitability index. Recommend accept/reject with reasoning.
-
-Expected: NPV $267,946; IRR 21.9%; payback 2.5 years; PI 1.27. Accept (IRR > hurdle, NPV > 0).
-
-## Compute, don't estimate
-
-All figures above come from [`scripts/calculate.py`](./scripts/calculate.py) - import its functions rather than doing arithmetic in prose.

package/selected-skills/financeskills/skills/investment-analysis/SKILL.md

@@ -1,82 +0,0 @@
----
-name: investment-analysis
-description: When the user wants to evaluate the potential profitability and viability of an investment opportunity. Also use when the user mentions "stock valuation," "DCF model," "NPV calculation," "IRR analysis," "buy or sell," "investment thesis," "margin of safety," or "equity research." Use this for stocks, real estate, and private equity.
-metadata:
-  version: 1.1.0
----
-
-# Investment Analysis
-
-You are an Equity Research Analyst. Your goal is to determine the intrinsic value of an asset and provide a clear investment recommendation based on a margin of safety.
-
-## Initial Assessment
-
-1. **Asset Context**
-   - Publicly traded company, private entity, or real estate?
-   - What is the current market price?
-   - What is the investor's time horizon?
-
-2. **Data Availability**
-   - Do we have 5-10 years of historical financials?
-   - Do we have analyst consensus or management guidance?
-
----
-
-## Analysis Framework
-
-### Priority Order
-1. **Fundamental Analysis** (Understanding the business model and moats).
-2. **Financial Modeling** (Building the DCF or LBO model).
-3. **Relative Valuation** (Comparing Multiples - P/E, EV/EBITDA).
-4. **Risk Assessment** (Identifying the "Bear Case").
-5. **Investment Thesis** (Synthesizing findings into a recommendation).
-
----
-
-## Technical Analysis Steps
-
-### 1. Business Model Review
-- Identify the "Moat" (Brand, Network Effect, Cost Advantage).
-- Analyze the competitive landscape and market share trends.
-
-### 2. Discounted Cash Flow (DCF)
-- Forecast Free Cash Flow (FCF) for 5-10 years.
-- Determine the Weighted Average Cost of Capital (WACC).
-- Calculate the Terminal Value using the perpetuity growth method or exit multiple.
-
-### 3. Multiples Analysis
-- Compare the target's P/E, P/S, and EV/EBITDA to historical averages and industry peers.
-
----
-
-## Output Format
-
-### Investment Memo Structure
-
-**Executive Summary**
-- Recommendation (Buy/Hold/Sell).
-- Target Price and Upside/Downside percentage.
-- The "One Sentence" Thesis.
-
-**Detailed Analysis**
-- **Valuation**: Breakdown of DCF assumptions and output.
-- **Moat Analysis**: Qualitative assessment of competitive advantage.
-- **Risks**: Key factors that could invalidate the thesis.
-
----
-
-## Scripts
-- [calculate.py](./scripts/calculate.py): Deterministic functions for this skill's core computations. Run `python3 scripts/calculate.py` to self-test; import the functions instead of doing mental math.
-
----
-
-## References
-- [Valuation Methodologies](./references/valuation-guide.md): Standard practices for DCF and Multiples.
-- [Moat Identification](./references/competitive-advantage.md): How to assess business quality.
-
----
-
-## Related Skills
-- **financial-analysis**: For the baseline audit of historical numbers.
-- **risk-assessment**: For deeper dive into the downside scenarios.
-- **budget-forecast**: For building the 5-10 year projection used in the DCF.

package/selected-skills/financeskills/skills/investment-analysis/references/competitive-advantage.md

@@ -1,31 +0,0 @@
-# Competitive Advantage: Identifying Moats
-
-Why some companies earn high returns on capital for decades while others fail.
-
-## 🏛️ The Five Types of Moats (Morningstar Framework)
-
-### 1. Network Effect
-The value of a service increases as more people use it (e.g., Visa, Facebook, Microsoft Windows).
-
-### 2. Intangible Assets
-Brands, patents, or regulatory licenses that allow a company to charge more or block competitors (e.g., Coca-Cola, Disney, Pfizer).
-
-### 3. Cost Advantage
-Producing goods or services at a lower cost than competitors due to scale, location, or unique processes (e.g., Walmart, Amazon, Geico).
-
-### 4. Switching Costs
-The time, money, or emotional cost of moving to a competitor is too high (e.g., Oracle Database, ERP systems, Bank accounts).
-
-### 5. Efficient Scale
-A market is so small that it only supports 1-2 profitable players; a new entrant would make everyone unprofitable (e.g., Regional airports, Pipeline companies).
-
----
-
-## 🔍 Evidence of a Moat
-- Consistent **Return on Invested Capital (ROIC)** > **WACC**.
-- Stable or growing **Market Share**.
-- **Pricing Power** (Ability to raise prices without losing customers).
-
-## 🔗 Sources
-- [Morningstar: The Five Sources of Economic Moats](https://www.morningstar.com/articles/932358/the-five-sources-of-economic-moats)
-- [Pat Dorsey: The Little Book that Builds Wealth](https://www.goodreads.com/book/show/2358514.The_Little_Book_that_Builds_Wealth)

package/selected-skills/financeskills/skills/investment-analysis/references/valuation-guide.md

@@ -1,29 +0,0 @@
-# Valuation Guide: DCF & Multiples
-
-Standard methodologies for determining the intrinsic and relative value of a business.
-
-## 🏛️ Discounted Cash Flow (DCF)
-The DCF is a "First Principles" valuation based on the present value of future cash flows.
-
-### The Formula
-`Value = Σ [FCF_t / (1 + WACC)^t]`
-- **FCF**: Free Cash Flow (Cash from Ops - CapEx).
-- **WACC**: Weighted Average Cost of Capital (Discount rate).
-- **t**: Time period.
-
-### Key Assumptions
-- **Terminal Growth Rate**: Usually 2-3% (aligned with long-term GDP growth).
-- **Discount Rate**: Reflects the riskiness of the cash flows.
-
----
-
-## 🔍 Relative Valuation (Multiples)
-Comparing a company to its peers or its own historical history.
-
-- **P/E (Price-to-Earnings)**: Most common for profitable companies.
-- **EV/EBITDA**: Used for capital-intensive industries; accounts for debt.
-- **P/S (Price-to-Sales)**: Used for high-growth companies with no net income.
-
-## 🔗 Sources
-- [Aswath Damodaran: Valuation Site](http://pages.stern.nyu.edu/~adamodar/)
-- [Investopedia: Discounted Cash Flow](https://www.investopedia.com/terms/d/dcf.asp)

package/selected-skills/financeskills/skills/journal-entry/EXAMPLE.md

@@ -1,21 +0,0 @@
-# Worked Example - journal-entry
-
-## Ask
-
-> We received legal services worth $25,000 in June but the invoice won't arrive until July. Prepare the June entry.
-
-## What a correct response contains
-
-Dr Legal/Professional Fees 25,000 / Cr Accrued Liabilities 25,000, flagged auto-reversing in July, with documentation basis (engagement letter, work confirmation).
-
-## File-driven variant
-
-With fixture(s) `evals/files/draft_entries.csv`:
-
-> Review the attached draft journal entries (evals/files/draft_entries.csv) before posting. Validate each entry balances, flag any malformed lines, and state which entries are safe to post.
-
-Expected: JE-101 and JE-103 are valid. JE-102 is out of balance by $450 (17,500 vs 17,050 - transposition). JE-104 has a line with both a debit and credit (invalid form) - net effect balances but the entry must be re-drafted. Only JE-101 and JE-103 post as-is.
-
-## Compute, don't estimate
-
-All figures above come from [`scripts/calculate.py`](./scripts/calculate.py) - import its functions rather than doing arithmetic in prose.

package/selected-skills/financeskills/skills/journal-entry/SKILL.md

@@ -1,94 +0,0 @@
----
-name: journal-entry
-description: When the user wants to prepare, review, or document a journal entry with proper debits, credits, and support. Also use when the user mentions "book an accrual," "post a JE," "adjusting entry," "prepaid amortization," "payroll entry," "reclass," or "reversing entry."
-metadata:
-  version: 1.0.0
----
-
-# Journal Entry Preparation
-
-You are a Senior GL Accountant. Your goal is to produce journal entries that are correct in debit/credit logic, properly supported, and ready to survive both review and audit.
-
-## Initial Assessment
-
-1. **Entry Context**
-   - What economic event is being recorded, and in which period does it belong?
-   - Entry type: accrual, deferral, depreciation/amortization, reclass, correction, revaluation, or non-routine.
-   - Auto-reversing next period? Recurring or one-time?
-
-2. **Support & Authority**
-   - Source documents available (invoice, contract, calculation schedule, payroll register).
-   - Approval threshold and who must sign.
-
----
-
-## Entry Framework
-
-### Debit/Credit Mechanics
-- Assets & expenses increase with DEBITS; liabilities, equity, and revenue increase with CREDITS.
-- Every entry balances. Multi-line entries: validate Σdebits = Σcredits before anything else.
-
-### Standard Entry Patterns
-| Event | Entry |
-|---|---|
-| Expense accrual | Dr Expense / Cr Accrued Liability (reverse next period) |
-| Prepaid amortization | Dr Expense / Cr Prepaid Asset |
-| Depreciation | Dr Depreciation Expense / Cr Accumulated Depreciation |
-| Deferred revenue release | Dr Deferred Revenue / Cr Revenue |
-| Payroll | Dr Salary Expense + Dr Employer Burden / Cr Cash + Cr Withholding Liabilities + Cr Pension Payable |
-| Bad debt provision | Dr Impairment Expense / Cr Allowance for ECL |
-| Error correction | Reverse the wrong entry in full, then post correctly — never post net differences |
-
----
-
-## Technical Analysis Steps
-
-### 1. Period Assignment
-Match the entry to the period the economics occurred (cut-off). For corrections of prior periods, assess materiality: immaterial → current period; material → prior-period restatement treatment.
-
-### 2. Account Selection
-Use the chart of accounts hierarchy; never invent accounts. Question any entry touching suspense/clearing accounts — they need a clearance plan.
-
-### 3. Documentation Standard
-Every JE carries: description (what + why + period), preparer, calculation support, source documents, approval per delegation-of-authority matrix.
-
----
-
-## Output Format
-
-### Journal Entry Package
-
-**Entry Header**
-- Date, period, entity, currency, auto-reverse flag, JE type.
-
-**Entry Lines**
-- Account | Account Name | Debit | Credit | Line memo | Cost center.
-
-**Support Summary**
-- Basis of calculation, source documents, and assumptions.
-
-**Review Checklist**
-- Balanced? Correct period? Correct accounts? Support attached? Approval obtained?
-
----
-
-## Scripts
-- [calculate.py](./scripts/calculate.py): Deterministic functions for this skill's core computations. Run `python3 scripts/calculate.py` to self-test; import the functions instead of doing mental math.
-
----
-
-## References
-- [Entry Patterns Cookbook](./references/entry-patterns.md): Worked entries for the 15 most common close scenarios.
-
----
-
-## Assets
-- [journal-entry-template.md](./assets/journal-entry-template.md): JE voucher with approval fields.
-
----
-
-## Related Skills
-- **close-management**: For where each entry type fits in the close calendar.
-- **automated-reconciliation**: Entries often originate from reconciling items.
-- **revenue-recognition**: For the revenue entries' measurement logic.
-- **deferred-tax**: For the tax entries on temporary differences.

package/selected-skills/financeskills/skills/journal-entry/assets/journal-entry-template.md

@@ -1,21 +0,0 @@
-# Journal Entry Voucher
-
-**JE #:** {number} | **Date:** {posting date} | **Period:** {period} | **Type:** {accrual / reversal / standard / adjusting}
-
-| Line | Account code | Account name | Dr | Cr | Memo |
-|---|---|---|---|---|---|
-| 1 | | | | | |
-| 2 | | | | | |
-| | | **Totals (must be equal)** | **{x}** | **{x}** | |
-
-**Business purpose:** {1-2 sentences - why this entry exists}
-
-**Support:** {invoice / contract / calculation reference}
-
-**Reversal:** {auto-reverses on {date} / not applicable}
-
-Prepared by: AI agent (scripts/calculate.py validate_entry passed: {y/n})
-Reviewed by: ____________  Approved by: ____________
-
----
-*AI-prepared entry - requires human review and approval before posting.*

package/selected-skills/financeskills/skills/journal-entry/references/entry-patterns.md

@@ -1,51 +0,0 @@
-# Journal Entry Patterns Cookbook
-
-All examples balance and state their reversal behavior.
-
-## 1. AP Accrual (service received, no invoice)
-Dr Professional Fees 5,000 / Cr Accrued Liabilities 5,000 — auto-reverse WD1 next period.
-
-## 2. Payroll (gross-to-net)
-Dr Salaries Expense 10,000; Dr Employer Pension Expense 1,000
-Cr Net Pay Payable 7,800; Cr PAYE Payable 2,200; Cr Pension Payable (employee 8% + employer 10% on relevant emoluments under Nigerian PRA 2014, adjust per jurisdiction) 1,000
-
-## 3. Prepaid Insurance (annual premium 12,000 paid 1 March)
-At payment: Dr Prepaid Insurance 12,000 / Cr Cash 12,000
-Monthly: Dr Insurance Expense 1,000 / Cr Prepaid Insurance 1,000
-
-## 4. Depreciation (asset 60,000, 5-yr straight line, no residual)
-Monthly: Dr Depreciation Expense 1,000 / Cr Accumulated Depreciation 1,000
-
-## 5. Deferred Revenue Release (annual SaaS 24,000 billed upfront)
-At billing: Dr AR 24,000 / Cr Deferred Revenue 24,000
-Monthly: Dr Deferred Revenue 2,000 / Cr Revenue 2,000
-
-## 6. Unbilled (Accrued) Revenue
-Dr Contract Asset–Unbilled AR 8,000 / Cr Revenue 8,000; reclass to AR on invoicing.
-
-## 7. Bad Debt / ECL Provision Top-Up
-Dr Impairment Loss 3,500 / Cr Allowance for ECL 3,500. Write-off: Dr Allowance / Cr AR (P&L only if allowance insufficient).
-
-## 8. FX Revaluation (USD payable, NGN books, rate moved against you)
-Dr FX Loss 150,000 / Cr Accounts Payable 150,000 — monetary items at closing rate (IAS 21).
-
-## 9. Inventory Adjustment After Count
-Shortage: Dr Inventory Shrinkage Expense / Cr Inventory. NRV write-down: Dr COGS (or separate line) / Cr Inventory Allowance.
-
-## 10. Accrued Interest on Borrowing
-Dr Interest Expense (EIR basis) / Cr Accrued Interest Payable; payment clears the payable.
-
-## 11. Lease (IFRS 16, monthly)
-Dr Interest Expense X; Dr Lease Liability Y / Cr Cash (X+Y). Separately: Dr ROU Depreciation / Cr Accumulated Depreciation–ROU.
-
-## 12. Correction (expense posted to wrong cost center, same P&L account)
-Dr Expense (CC-200) / Cr Expense (CC-100) — memo references original JE number.
-
-## 13. Reclass Short-Term Portion of Debt
-Dr Long-Term Debt / Cr Current Portion of LTD — every close.
-
-## 14. Bonus Accrual (estimated, year-to-date true-up method)
-Dr Bonus Expense / Cr Accrued Bonus = (expected annual bonus × months elapsed/12) − accrued to date.
-
-## 15. Dividend Declaration
-Dr Retained Earnings / Cr Dividends Payable at declaration; payment clears the liability. (Withholding tax: Cr WHT Payable for the withheld portion at payment.)

package/selected-skills/financeskills/skills/lbo-modeling/EXAMPLE.md

@@ -1,21 +0,0 @@
-# Worked Example - lbo-modeling
-
-## Ask
-
-> We want to buy a company for $100M (10x EBITDA). We are using $60M in debt and $40M in equity. If we exit in 5 years at the same multiple, what's our IRR?
-
-## What a correct response contains
-
-Should calculate the entry EBITDA ($10M). Should identify the need for cash flow projections to pay down debt. Should explain that if debt is paid down, the equity value at exit increases even if the multiple stays the same. Should provide an LBO Analysis Summary structure.
-
-## File-driven variant
-
-With fixture(s) `evals/files/lbo_assumptions.xlsx`:
-
-> Run the LBO described in the attached assumptions workbook (evals/files/lbo_assumptions.xlsx). Compute entry EV, debt and sponsor equity, exit EBITDA and EV, exit equity value, MOIC and IRR. Debt is a bullet (no paydown); ignore cash generation.
-
-Expected: Entry EV $400m, debt $240m, equity $160m. Exit EBITDA $73.5m, exit EV $588m, exit equity $348m. MOIC 2.17x, IRR 16.8%.
-
-## Compute, don't estimate
-
-All figures above come from [`scripts/calculate.py`](./scripts/calculate.py) - import its functions rather than doing arithmetic in prose.

package/selected-skills/financeskills/skills/lbo-modeling/SKILL.md

@@ -1,88 +0,0 @@
----
-name: lbo-modeling
-description: When the user wants to model a Leveraged Buyout (LBO) for private equity analysis. Also use when the user mentions "private equity model," "debt capacity analysis," "exit IRR," "MOIC calculation," "sources and uses," or "entry multiple."
-metadata:
-  version: 1.0.0
----
-
-# LBO Modeling
-
-You are a Private Equity Associate. Your goal is to determine if a company is a viable LBO candidate by modeling debt repayment, cash flow generation, and exit returns (IRR/MOIC).
-
-## Initial Assessment
-
-1. **Transaction Context**
-   - What is the Entry Multiple (e.g., 10x EBITDA)?
-   - What is the estimated Exit Multiple?
-   - What is the target holding period (usually 3-7 years)?
-
-2. **Financing Assumptions**
-   - How much debt can the company support (Debt/EBITDA)?
-   - What are the interest rates for different tranches (Senior, Mezzanine)?
-
-3. **Operations & Growth**
-   - What is the projected EBITDA growth?
-   - What are the ongoing CapEx requirements?
-
----
-
-## LBO Framework
-
-### Priority Order
-1. **Sources & Uses** (Calculating the total purchase price and how it's funded).
-2. **Operations Forecast** (Projecting Revenue to Free Cash Flow).
-3. **Debt Schedule** (Modeling the mandatory and optional repayment of debt).
-4. **Returns Analysis** (Calculating Internal Rate of Return (IRR) and Multiple of Invested Capital (MOIC)).
-5. **Sensitivity Analysis** (Testing returns against entry/exit multiples and growth rates).
-
----
-
-## Technical Modeling Steps
-
-### 1. Sources & Uses Table
-- **Uses**: Purchase Equity, Refinance Existing Debt, Transaction Fees.
-- **Sources**: New Debt, Sponsor Equity.
-
-### 2. Cash Flow for Debt Service (CFADS)
-- Calculate EBITDA -> Less Taxes -> Less Interest -> Less CapEx -> Less Δ Working Capital.
-- This represents the cash available to pay down principal.
-
-### 3. IRR Calculation
-- `IRR = (Exit Proceeds / Entry Equity)^(1/n) - 1`.
-- MOIC (Multiple of Money) = `Exit Proceeds / Entry Equity`.
-
----
-
-## Output Format
-
-### LBO Analysis Summary
-
-**The Deal**
-- Total Transaction Value.
-- Equity Contribution vs. Debt Funding.
-
-**The Returns (Base Case)**
-- **IRR**: (e.g., 22.5%).
-- **MOIC**: (e.g., 2.4x).
-- Exit Date: (e.g., Year 5).
-
-**Returns Matrix**
-- Table showing IRR across different Exit Multiples and Revenue Growth scenarios.
-
----
-
-## Scripts
-- [calculate.py](./scripts/calculate.py): Sources & uses, cash sweep debt schedule, and IRR/MoM functions. Run with `python3 scripts/calculate.py` to self-test; import the functions for actual computations.
-
----
-
-## References
-- [LBO Modeling Standards](./references/lbo-best-practices.md): Industry conventions.
-- [Debt Tranches Explained](./references/debt-structures.md): Senior vs. Subordinated.
-
----
-
-## Related Skills
-- **investment-analysis**: For the baseline business quality assessment.
-- **financial-analysis**: For auditing the EBITDA sustainability.
-- **risk-assessment**: For evaluating the bankruptcy risk of high leverage.

package/selected-skills/financeskills/skills/lbo-modeling/references/debt-structures.md

@@ -1,22 +0,0 @@
-# LBO Debt Structures
-
-## Typical Capital Stack (top = paid first)
-| Tranche | Leverage | Pricing (indicative) | Features |
-|---|---|---|---|
-| Revolver | undrawn at close | SOFR + 200–350 | Liquidity backstop; springing covenant |
-| Term Loan A | with TLB, 0.5–1.5x | SOFR + 250–350 | Bank-held, 5–10% annual amortization |
-| Term Loan B | 3–4.5x cumulative | SOFR + 350–500, 0–0.5% floor | Institutional, 1% amort, covenant-lite common |
-| Senior Notes / High Yield | +1–2x | Fixed 7–10% | No amort, call protection (NC-2/3) |
-| Mezzanine / PIK | +0.5–1x | 11–14% cash+PIK | Warrants sometimes attached |
-| Sponsor Equity | 40–60% of capital | — | Residual claim |
-
-## Key Terms to Model
-- **Amortization**: TLA meaningful; TLB 1%/yr; notes bullet.
-- **Cash sweep / ECF sweep**: % of excess cash flow, often leverage-ratcheted.
-- **PIK toggle**: interest accrues to principal — compounds against the exit equity.
-- **Call protection**: HY non-call periods and premiums (e.g., 105/102.5/100) matter for refi scenarios.
-- **Covenants**: maintenance (leverage, coverage — tested quarterly, TLA/revolver) vs. incurrence (HY). Model headroom ≥ 15–25% cushion to projections.
-- **OID & financing fees**: amortize into interest expense (effective yield); add cash cost at close.
-
-## Structuring Logic
-More TLA/amortizing debt = faster deleveraging, better IRR from paydown but tighter covenants. More HY/PIK = flexibility, higher cost, returns lean on growth. Match amortization burden to FCF stability of the business.

package/selected-skills/financeskills/skills/lbo-modeling/references/lbo-best-practices.md

@@ -1,27 +0,0 @@
-# LBO Modeling Best Practices
-
-## Model Architecture (order matters)
-1. Transaction assumptions: entry EV (multiple × LTM EBITDA), sources & uses, fees.
-2. Debt schedule with mandatory amortization + cash sweep.
-3. Integrated 3-statement projection (or EBITDA-to-FCF bridge for quick models).
-4. Exit: exit multiple × exit-year EBITDA → equity proceeds → IRR/MoM.
-5. Sensitivities: entry/exit multiple grid, leverage grid, growth/margin grid.
-
-## Sources & Uses Discipline
-- Uses: equity purchase price + refinanced debt + transaction fees (2–3% of EV) + financing fees (2–3% of debt, capitalized and amortized).
-- Sources: each debt tranche + sponsor equity + management rollover. Must balance to the dollar.
-- Minimum cash to balance sheet — never fund the deal to zero cash.
-
-## Cash Sweep Mechanics
-`FCF available = EBITDA − cash interest − cash taxes − capex − ΔNWC − mandatory amort`
-Sweep order: revolver first, then tranches by seniority (check covenants — some TLBs have 50%/25%/0% ECF sweep tiers by leverage).
-
-## Returns Math
-- `MoM = Exit equity / Entry equity`; `IRR = MoM^(1/years) − 1` for single-flow deals.
-- Value creation bridge at exit: EBITDA growth + multiple expansion + debt paydown = total equity gain. Attribute every deal — if returns are mostly multiple expansion, the thesis is market beta.
-- Target: 20–25% IRR / 2.0–3.0x MoM over 5 years.
-
-## Sanity Checks
-- Leverage: 4–6x total debt/EBITDA typical; interest coverage (EBITDA/cash interest) ≥ 2x in all projection years.
-- Credit stats improve over hold or the model has a problem.
-- Circularity (interest ↔ cash) — use opening-balance interest convention or iterative solve; document which.

package/selected-skills/financeskills/skills/lease-accounting/EXAMPLE.md

@@ -1,21 +0,0 @@
-# Worked Example - lease-accounting
-
-## Ask
-
-> We signed a 5-year office lease: 10,000,000 NGN per year paid annually in arrears, IBR 18%, no incentives, no restoration. Compute the initial lease liability and ROU asset and give me year-1 entries.
-
-## What a correct response contains
-
-Liability = PV of 5 payments of 10M at 18% = ~31,272,000 NGN. ROU = same. Year 1: interest = ~5,629,000, payment 10M reduces liability to ~26,901,000; ROU depreciation = ~6,254,400/yr straight-line.
-
-## File-driven variant
-
-With fixture(s) `evals/files/lease_portfolio.csv`:
-
-> Using the attached lease portfolio (evals/files/lease_portfolio.csv) — payments annual in arrears, no renewal options, commencement today — measure each lease liability and right-of-use asset at commencement under IFRS 16, and compute total year-1 interest expense and straight-line depreciation. Produce a commencement summary table and the initial journal entry.
-
-Expected: Liabilities: L-01 $1,025,049, L-02 $689,597, L-03 $194,383; total $1,909,029 (ROU assets equal liabilities here). Year-1 interest $144,416; year-1 depreciation $339,805.
-
-## Compute, don't estimate
-
-All figures above come from [`scripts/calculate.py`](./scripts/calculate.py) - import its functions rather than doing arithmetic in prose.