@v587d/capital-generation 2.10.2 → 2.11.0

package/selected-skills/financeskills/skills/esg-reporting/SKILL.md

@@ -1,79 +0,0 @@
----
-name: esg-reporting
-description: When the user wants to prepare, audit, or analyze Environmental, Social, and Governance (ESG) reports. Also use when the user mentions "sustainability reporting," "carbon footprint audit," "governance transparency," "SASB standards," "TCFD alignment," or "non-financial disclosure."
-metadata:
-  version: 1.0.0
----
-
-# ESG Reporting
-
-You are an ESG Specialist. Your goal is to quantify and disclose non-financial metrics that impact long-term enterprise value and stakeholder trust.
-
-## Initial Assessment
-
-1. **Reporting Standards**
-   - SASB (Sustainability Accounting Standards Board)?
-   - GRI (Global Reporting Initiative)?
-   - TCFD (Task Force on Climate-related Financial Disclosures)?
-
-2. **Materiality**
-   - Which ESG factors are "material" for this specific industry? (e.g., Water usage for semiconductors vs. Data privacy for software).
-
-3. **Data Sources**
-   - Utility bills, HR diversity logs, Board composition records, Carbon emissions data.
-
----
-
-## ESG Framework
-
-### Priority Order
-1. **Materiality Assessment** (Identifying what to measure).
-2. **Data Ingestion** (Collecting environmental and social metrics).
-3. **Gap Analysis** (Comparing current performance to industry benchmarks).
-4. **Disclosure Preparation** (Drafting the non-financial statement).
-
----
-
-## Technical ESG Steps
-
-### 1. Scope 1, 2, & 3 Emissions
-- **Scope 1**: Direct emissions from company-owned sources.
-- **Scope 2**: Indirect emissions from purchased energy.
-- **Scope 3**: All other indirect emissions in the value chain (Suppliers/Users).
-
-### 2. Social Metric Calculation
-- Calculate gender pay gaps, diversity ratios in management, and employee turnover rates.
-
-### 3. Governance Audit
-- Review board independence, executive compensation alignment with sustainability goals, and anti-corruption policies.
-
----
-
-## Output Format
-
-### ESG Performance Report
-
-**Scorecard**
-- Key Performance Indicators (KPIs) vs. Targets.
-- Alignment rating with SASB/GRI.
-
-**The Findings**
-- Environmental impact summary (Carbon/Waste/Water).
-- Social impact summary (Human Capital/Community).
-- Governance summary (Ethics/Transparency).
-
-**Actionable Goals**
-- Roadmaps for emission reductions or diversity improvements.
-
----
-
-## References
-- [SASB Materiality Map](./references/sasb-map.md): Industry-specific materiality.
-- [Carbon Accounting 101](./references/ghg-protocol.md): Scope 1/2/3 definitions.
-
----
-
-## Related Skills
-- **audit-checklist**: For auditing the accuracy of ESG data.
-- **financial-analysis**: To see if ESG risks impact the financial bottom line.
-- **investment-analysis**: To factor ESG scores into the investment thesis.

package/selected-skills/financeskills/skills/esg-reporting/references/ghg-protocol.md

@@ -1,22 +0,0 @@
-# GHG Protocol Essentials
-
-## The Three Scopes
-- **Scope 1 — direct**: owned/controlled sources: combustion (generators, fleet, gas processing), process emissions, fugitives (flaring, venting, methane leaks — dominant in oil & gas), refrigerants.
-- **Scope 2 — purchased energy**: electricity, steam, heat. Report BOTH location-based (grid average factor) and market-based (contractual instruments/RECs/PPAs).
-- **Scope 3 — value chain**: 15 categories; materiality varies wildly. O&G: category 11 (use of sold products) is typically 80%+ of total footprint. Banks: category 15 (financed emissions, PCAF methodology).
-
-## Calculation Basics
-`Emissions (tCO2e) = Activity data × Emission factor × GWP`
-- Factors: IPCC, national inventories, IEA grid factors, API Compendium (O&G).
-- GWP: use AR5/AR6 100-year values consistently (CH4 ≈ 28–30, N2O ≈ 265–273).
-- Hierarchy of data quality: measured/metered > calculated (fuel × factor) > estimated (spend-based). Spend-based Scope 3 is a screening tool, not a reporting-grade method.
-
-## Organizational Boundaries
-Choose and disclose: equity share vs. operational control vs. financial control. O&G joint ventures swing the inventory massively depending on this choice — align it with financial consolidation where possible.
-
-## Common Errors
-1. Netting renewables purchases against the location-based figure.
-2. Double counting: a generator's diesel in both Scope 1 (combustion) and Scope 3 (fuel upstream — that part belongs in category 3).
-3. Missing fugitives/flaring — in upstream oil & gas these can exceed combustion.
-4. Recalculating the base year only when convenient (need a structural-change policy with threshold, e.g., 5%).
-5. Mixing GWP vintages across years without restating.

package/selected-skills/financeskills/skills/esg-reporting/references/sasb-map.md

@@ -1,25 +0,0 @@
-# SASB / ISSB Industry Mapping
-
-## Framework Landscape (post-consolidation)
-SASB standards now sit under the ISSB (IFRS Foundation). IFRS S1 (general sustainability disclosures) and IFRS S2 (climate) reference SASB metrics as the industry-specific layer. TCFD is absorbed into IFRS S2. GRI remains the impact/multi-stakeholder framework — dual reporting (ISSB for investors + GRI for stakeholders) is the common pattern.
-
-## SASB's 77 Industries → 5-Factor Materiality
-Each industry standard selects from: Environment / Social capital / Human capital / Business model & innovation / Leadership & governance. Examples:
-
-| Industry | Most Material Topics (illustrative) |
-|---|---|
-| Oil & Gas E&P | GHG emissions, water management, biodiversity, community relations, reserves valuation & capex resilience, critical incident management |
-| Commercial Banks | Data security, access & affordability, financed emissions, business ethics, systemic risk management |
-| Insurance | ESG integration in investments, physical risk exposure, policyholder transparency |
-| Software/IT | Energy of data centers, data privacy, employee recruitment/diversity, IP & competitive behavior |
-| Food & Beverage | Energy/water, packaging, ingredient sourcing, health & nutrition, labor |
-
-## Building the Disclosure Map
-1. Classify the entity into SASB industry (SICS code); diversified groups map per segment.
-2. Pull that industry's disclosure topics + quantitative metrics + activity metrics.
-3. Gap-assess current data availability per metric; classify ready / partial / absent.
-4. Overlay IFRS S2 climate requirements: governance, strategy, risk management, metrics & targets, Scope 1-2 (Scope 3 with relief provisions), scenario analysis.
-5. Map each metric to an owner and a system of record — disclosure without data lineage fails assurance.
-
-## Assurance Trajectory
-Limited assurance on GHG (ISSA 5000) is becoming the baseline; build audit-trail discipline (methodology memos, evidence retention) from day one.

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

@@ -1,21 +0,0 @@
-# Worked Example - financial-analysis
-
-## Ask
-
-> Can you analyze these Q3 financials? Revenue: $120M, COGS: $40M, OpEx: $30M, Net Income: $35M. Cash: $50M, Current Liabilities: $25M.
-
-## What a correct response contains
-
-Should perform data normalization and calculate key ratios. Should identify Gross Margin (66.7%), Operating Margin (41.7%), and Net Margin (29.2%). Should calculate Current Ratio (2.0) and assess liquidity. Should check for profitability health and solvency. Output should follow the structured report format: Executive Summary, Detailed Findings (Profitability, Liquidity, Solvency), and Recommendations.
-
-## File-driven variant
-
-With fixture(s) `evals/files/financial_statements.csv`:
-
-> Using the attached two-year financial statements (evals/files/financial_statements.csv), compute the FY2025 liquidity, profitability, and leverage ratios (use average balances where appropriate), flag any deterioration vs FY2024, and produce your standard analysis memo.
-
-Expected: Current ratio 2.00, quick ratio 1.27, net margin 8.6%, ROE (avg equity) 24.7%, DSO (avg AR) 60 days, D/E 0.84, revenue growth 20%. Should flag AR growing ~40% against 20% revenue growth (DSO deterioration) and the quick ratio near/below 1.
-
-## 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/financial-analysis/SKILL.md

@@ -1,108 +0,0 @@
----
-name: financial-analysis
-description: When the user wants to perform a deep dive into a company's financial performance. Also use when the user mentions "10-K review," "quarterly earnings," "profitability audit," "ratio analysis," "balance sheet health," "cash flow analysis," "EBITDA margin," "financial statement audit," "how is this company doing," or "analyze these financials." Use this even if the user just says "look at these numbers" — start with a structured analysis.
-metadata:
-  version: 1.2.0
----
-
-# Financial Analysis
-
-You are a Senior Financial Analyst. Your goal is to extract, analyze, and interpret financial data to provide a comprehensive view of an entity's financial health.
-
-## Initial Assessment
-
-**Check for corporate context first:**
-If `./projects/context.md` or similar files exist, read them before asking questions. Use that context and only ask for information not already covered.
-
-Before analyzing, understand:
-
-1. **Entity Context**
-   - Public or private company?
-   - Industry (SaaS, Manufacturing, FinTech, etc.)
-   - Reporting currency and period (Q3 2023, FY 2024).
-
-2. **Source Data**
-   - Do we have the Big 3? (Income Statement, Balance Sheet, Cash Flow).
-   - Are we using GAAP, IFRS, or a local standard?
-
-3. **Goal of Analysis**
-   - General health check?
-   - Valuation prep?
-   - Liquidity/Solvency focus?
-
----
-
-## Analysis Framework
-
-### Priority Order
-1. **Data Extraction & Normalization** (Ensure the numbers are clean and comparable).
-2. **Profitability Analysis** (Is the business model working?).
-3. **Liquidity & Solvency** (Can they pay their bills?).
-4. **Efficiency Ratios** (How well are assets being used?).
-5. **Trend & Anomaly Detection** (What's changing and why?).
-
----
-
-## Technical Analysis Steps
-
-### 1. Data Normalization
-- Extract Revenue, COGS, OpEx, Net Income.
-- Identify non-recurring items (one-time charges, gains/losses).
-- Calculate Adjusted EBITDA if applicable.
-
-### 2. Ratio Calculation
-- **Liquidity**: Current Ratio, Quick Ratio, Days Sales Outstanding (DSO).
-- **Profitability**: Gross Margin, Operating Margin, Net Margin, ROE.
-- **Solvency**: Debt-to-Equity, Interest Coverage Ratio.
-
-### 3. Trend Analysis (Horizontal Analysis)
-- Calculate Year-over-Year (YoY) and Quarter-over-Quarter (QoQ) growth rates.
-- Identify acceleration or deceleration in key metrics.
-
-### 4. Anomaly Detection
-- Flag any line item with a variance > 15% without clear footnote explanation.
-- Check for "Earnings Management" red flags (e.g., revenue growing faster than cash flow).
-
----
-
-## Output Format
-
-### Financial Analysis Report Structure
-
-**Executive Summary**
-- Overall Health Rating (e.g., "Strong," "Stable," "Concerning").
-- Top 3 critical findings.
-
-**Detailed Findings**
-- **Profitability**: Analysis of margins and earnings quality.
-- **Liquidity**: Assessment of short-term cash position.
-- **Solvency**: Long-term debt profile and coverage.
-- **Anomalies**: List of flagged items requiring clarification.
-
-**Recommendations**
-1. Immediate operational improvements.
-2. Financial restructuring needs.
-3. Questions for management.
-
----
-
-## Scripts
-- [calculate.py](./scripts/calculate.py): Ratio calculations with DuPont decomposition and zero-division safety. Run with `python3 scripts/calculate.py` to self-test; import the functions for actual computations.
-
----
-
-## References
-- [Ratio Definitions](./references/ratio-definitions.md): Standard formulas used in this skill.
-- [IFRS vs GAAP](./references/accounting-standards.md): Key differences affecting analysis.
-
----
-
-## Assets
-- [analysis-memo-template.md](./assets/analysis-memo-template.md): Standard memo structure for the final output.
-
----
-
-## Related Skills
-- **investment-analysis**: For valuing the company based on this analysis.
-- **risk-assessment**: For deeper dive into the solvency/default risks.
-- **budget-forecast**: For projecting future performance based on trends.

package/selected-skills/financeskills/skills/financial-analysis/assets/analysis-memo-template.md

@@ -1,31 +0,0 @@
-# Financial Analysis Memo
-
-**Entity:** {entity} | **Period:** {period} | **Prepared:** {date} | **Currency:** {ccy}
-
-## Executive Summary
-{2-4 sentences: overall health, the one number that matters most, the key risk.}
-
-## Ratio Dashboard
-| Category | Metric | {prior} | {current} | Trend | Benchmark |
-|---|---|---|---|---|---|
-| Liquidity | Current ratio | | | | |
-| Liquidity | Quick ratio | | | | |
-| Profitability | Gross margin | | | | |
-| Profitability | Net margin | | | | |
-| Profitability | ROE (avg equity) | | | | |
-| Efficiency | DSO / DIO / DPO | | | | |
-| Leverage | Debt / Equity | | | | |
-| Coverage | Interest coverage | | | | |
-
-## Key Findings
-1. {Finding - quantified, with cause}
-2. {Finding}
-
-## Red Flags
-- {Anything deteriorating faster than revenue, covenant proximity, quality-of-earnings issues}
-
-## Recommended Actions
-1. {Action - owner - timeframe}
-
----
-*Calculations verified by code ({script reference}). AI-prepared analysis - review by a qualified professional before relying on it.*

package/selected-skills/financeskills/skills/financial-analysis/references/accounting-standards.md

@@ -1,45 +0,0 @@
-# Accounting Standards: IFRS vs US GAAP
-
-Detailed comparison of the two primary financial reporting frameworks. Understanding these differences is critical for accurate financial analysis and normalization.
-
-## 🏛️ Framework Overview
-
-### IFRS (International Financial Reporting Standards)
-- **Governance**: International Accounting Standards Board (IASB).
-- **Usage**: Used in 140+ countries (EU, Canada, Australia, most of Africa).
-- **Philosophy**: Principles-based. Focuses on the "substance over form" of a transaction.
-
-### US GAAP (Generally Accepted Accounting Principles)
-- **Governance**: Financial Accounting Standards Board (FASB).
-- **Usage**: Mandatory for all US public companies.
-- **Philosophy**: Rules-based. Highly detailed with specific guidance for various industries.
-
----
-
-## 🔍 Key Differences
-
-### 1. Inventory Valuation
-- **IFRS**: LIFO (Last-In-First-Out) is prohibited. Only FIFO and Weighted Average are allowed.
-- **GAAP**: LIFO is allowed and commonly used for tax benefits.
-- **Impact**: Using LIFO in a period of rising prices results in higher COGS and lower net income compared to FIFO.
-
-### 2. Revaluation of Assets
-- **IFRS**: Allows the revaluation of assets (PPE, Intangibles) to fair value if it can be measured reliably.
-- **GAAP**: Revaluation is generally prohibited (assets are carried at historical cost).
-
-### 3. Development Costs
-- **IFRS**: Development costs can be capitalized if certain criteria are met (future economic benefit).
-- **GAAP**: Development costs are generally expensed as incurred (except for certain software development costs).
-
-### 4. Statement of Cash Flows
-- **Interest Paid**: 
-  - IFRS: Can be Operating or Financing.
-  - GAAP: Must be Operating.
-- **Dividends Received**:
-  - IFRS: Can be Operating or Investing.
-  - GAAP: Must be Operating.
-
-## 🔗 Sources
-- [IASB Official Standards](https://www.ifrs.org/issued-standards/)
-- [FASB Official Guidance](https://www.fasb.org/standards/)
-- [PwC: IFRS and US GAAP: Similarities and Differences](https://www.pwc.com/us/en/services/audit-assurance/accounting-advisory/ifrs-us-gaap-comparison.html)

package/selected-skills/financeskills/skills/financial-analysis/references/ratio-definitions.md

@@ -1,14 +0,0 @@
-# Financial Ratio Definitions
-
-### Liquidity Ratios
-- **Current Ratio**: Current Assets / Current Liabilities. Measures ability to pay short-term obligations.
-- **Quick Ratio**: (Current Assets - Inventory) / Current Liabilities. A more stringent liquidity test.
-
-### Profitability Ratios
-- **Gross Margin**: (Revenue - COGS) / Revenue. Percentage of revenue exceeding cost of goods sold.
-- **Net Margin**: Net Income / Revenue. The "bottom line" profitability.
-- **ROE (Return on Equity)**: Net Income / Shareholders' Equity. How effectively management uses equity to generate profit.
-
-### Solvency Ratios
-- **Debt-to-Equity**: Total Liabilities / Shareholders' Equity. The company's financial leverage.
-- **Interest Coverage**: EBIT / Interest Expense. Ability to pay interest on outstanding debt.

package/selected-skills/financeskills/skills/fixed-asset-accounting/EXAMPLE.md

@@ -1,21 +0,0 @@
-# Worked Example - fixed-asset-accounting
-
-## Ask
-
-> We bought a generator: invoice 12,000,000 NGN, delivery 400,000, installation 600,000, staff training 250,000, 10-year life, 1,000,000 residual, straight-line. What do we capitalize and what's annual depreciation?
-
-## What a correct response contains
-
-Capitalize 13,000,000 (invoice + delivery + installation); expense training 250,000. Annual depreciation = (13,000,000 - 1,000,000)/10 = 1,200,000.
-
-## File-driven variant
-
-With fixture(s) `evals/files/asset_register.xlsx`:
-
-> Compute year-1 depreciation for each asset in the attached register (evals/files/asset_register.xlsx) using the stated method, and total the charge. The mould has a 200,000-unit life and produced 35,000 units this year.
-
-Expected: Press $20,000 (SL); trucks $40,000 (DDB y1); mould $17,500 (UoP); total $77,500.
-
-## 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/fixed-asset-accounting/SKILL.md

@@ -1,78 +0,0 @@
----
-name: fixed-asset-accounting
-description: When the user wants to account for property, plant and equipment or intangibles — capitalization, depreciation, disposals, impairment, or the fixed asset register. Also use when the user mentions "capitalize vs expense," "useful life," "componentization," "asset disposal," "impairment test," "CIP/WIP transfer," or "fixed asset rollforward."
-metadata:
-  version: 1.0.0
----
-
-# Fixed Asset Accounting (IAS 16 / IAS 36 / ASC 360)
-
-You are a Fixed Assets Accountant. Your goal is to keep the asset register accurate: capitalize what qualifies, depreciate it sensibly, catch impairments, and account for disposals cleanly.
-
-## Initial Assessment
-
-1. **Transaction Type**
-   - Acquisition, self-construction (CIP), subsequent expenditure, disposal/retirement, impairment indicator, or register maintenance.
-
-2. **Policy Inputs**
-   - Capitalization threshold, useful life table by asset class, residual value conventions, depreciation methods, componentization policy.
-
----
-
-## Accounting Framework
-
-### Capitalization Decision
-Capitalize: purchase price + directly attributable costs to bring the asset to working condition (delivery, installation, testing net of sample proceeds rules, professional fees, irrecoverable taxes) + initial restoration estimate (aro-computation). Borrowing costs on qualifying assets (IAS 23). 
-Expense: training, relocation, admin overhead, abnormal waste, repairs/maintenance. Subsequent expenditure: capitalize only if it enhances future benefits beyond original standard (capacity, life, quality) — otherwise repair expense.
-
-### Depreciation
-- Methods: straight-line `(cost − residual)/life`, reducing balance, units of production (E&P, mining equipment).
-- Start when AVAILABLE for use (not when used); stop at derecognition or held-for-sale.
-- **Componentization (IAS 16)**: depreciate significant parts separately (aircraft engines vs. frame; plant turnarounds; building roof/lifts/shell).
-- Annual review of life, residual, method = change in ESTIMATE (prospective, never restate).
-
-### Impairment (IAS 36)
-Indicators (external: market decline, rates, obsolescence; internal: damage, idle, restructuring, underperformance) → test: `Recoverable amount = max(fair value − costs of disposal, value in use)`; impair carrying amount down to it. CGU level if no standalone cash flows. Reversals allowed under IFRS (not goodwill, not US GAAP).
-
-### Disposal
-`Gain/(loss) = proceeds − carrying amount`; derecognize cost AND accumulated depreciation. Held-for-sale (IFRS 5): stop depreciating, measure at lower of carrying and FV−CTS.
-
----
-
-## Technical Analysis Steps
-
-1. **Register integrity**: rollforward (opening + additions − disposals − depreciation ± impairment ± transfers = closing) must tie to GL control accounts; CIP aging review for stalled projects that should be tested for impairment.
-2. **Compute with code**: depreciation schedules, gain/loss on disposal, impairment math.
-3. **Physical verification cycle**: existence testing rotation, ghost-asset write-off protocol.
-
----
-
-## Output Format
-
-### Fixed Asset Memo / Schedule
-
-**Conclusion**: capitalize/expense decision or disposal/impairment outcome with standard reference.
-
-**Computation**: depreciation schedule or gain/loss calculation.
-
-**Entries**: full journal entries (journal-entry format).
-
-**Register Impact**: rollforward line movement.
-
----
-
-## 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
-- [Useful Life Benchmarks](./references/useful-life-guide.md): Typical lives, componentization and policy guidance by asset class.
-
----
-
-## Related Skills
-- **aro-computation**: Restoration cost capitalized into the asset.
-- **journal-entry**: For the entries this skill produces.
-- **deferred-tax**: Tax-vs-book depreciation creates temporary differences.
-- **lease-accounting**: ROU assets follow similar depreciation logic.

package/selected-skills/financeskills/skills/fixed-asset-accounting/references/useful-life-guide.md

@@ -1,30 +0,0 @@
-# Useful Life Benchmarks and Policy Guidance
-
-## Typical Useful Lives (calibrate to entity experience — these are starting points)
-| Asset Class | Life (years) | Method Notes |
-|---|---|---|
-| Buildings — shell | 30–50 | Straight-line; componentize |
-| Buildings — roof, HVAC, lifts | 10–20 | Separate components |
-| Leasehold improvements | Shorter of life and lease term | Include reasonably certain renewals only |
-| Plant & machinery (general) | 8–15 | SL or UoP if usage-driven wear |
-| Oil & gas production facilities | Field life | Units of production on proved developed reserves |
-| Pipelines | 20–40 | SL; integrity-driven component reviews |
-| Motor vehicles | 4–6 | Residual values meaningful — set and review |
-| IT hardware | 3–5 | Zero residual typical |
-| Servers/network infra | 4–6 | Hyperscalers have stretched to 6 — follow entity evidence |
-| Office furniture & fittings | 5–10 | — |
-| Software (purchased/internally developed) | 3–7 | Amortize from go-live; cloud config costs usually EXPENSED (SaaS arrangements — IFRIC agenda decision) |
-
-## Componentization Triggers
-Component is "significant" if its cost is a meaningful share (rule of thumb ≥ 10–20%) of the asset AND its life differs materially. Classic mandatory cases: aircraft (frame/engines/interiors), vessels (hull/dry-docking), refineries and plants (turnaround/overhaul costs capitalized as a component, depreciated to next turnaround).
-
-## Residual Values
-Use only with credible disposal markets (vehicles, aircraft, some plant). Review annually; residual ≥ carrying amount → depreciation stops. Document the evidence (auction data, dealer quotes).
-
-## Estimate Change Mechanics (prospective)
-New annual depreciation = (carrying amount − revised residual) / remaining revised life, from the date of change. No restatement, but disclose if material.
-
-## Register Hygiene Rules
-- CIP > 12 months without spend movement → investigate, impairment-test, or write off.
-- Fully depreciated assets still in use → flag for life-policy recalibration (chronic pattern = lives too short, distorting margins).
-- Ghost assets: physical verification on rotation (high-value annually, full population over 2–3 years); write-offs need approval and root-cause (theft? records?).

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

@@ -1,21 +0,0 @@
-# Worked Example - intercompany-accounting
-
-## Ask
-
-> Parent shows due-from Sub A of 125M; Sub A shows due-to Parent of 117M. Walk me through resolving the 8M difference.
-
-## What a correct response contains
-
-Apply the hierarchy: check in-transit items around cut-off, FX rate differences (different sources/dates), missing bookings on one side, then pricing disputes. Fix entity books before consolidation; never eliminate a mismatch.
-
-## File-driven variant
-
-With fixture(s) `evals/files/ic_receivables_parent.csv`, `evals/files/ic_payables_subs.csv`:
-
-> Match the attached intercompany balances (evals/files/ic_receivables_parent.csv vs evals/files/ic_payables_subs.csv) and identify mismatches. Separately, the parent sold inventory to SubB for $300,000 (cost $200,000) and SubB still holds 40%: compute the unrealized profit to eliminate and draft the elimination entry, proving it balances.
-
-Expected: SubB mismatch $20,000 (cash/goods in transit to investigate); SubC and SubD agree. URP $40,000; elimination: Dr IC Revenue 300,000 / Cr IC COGS 260,000 / Cr Inventory 40,000.
-
-## 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/intercompany-accounting/SKILL.md

@@ -1,79 +0,0 @@
----
-name: intercompany-accounting
-description: When the user wants to manage intercompany transactions, balances, eliminations, or settlement. Also use when the user mentions "intercompany mismatch," "IC reconciliation," "transfer pricing entries," "intercompany loans," "netting," "due to/due from," or "elimination entries."
-metadata:
-  version: 1.0.0
----
-
-# Intercompany Accounting
-
-You are a Group Reporting Accountant. Your goal is to keep intercompany (IC) balances matched, transactions properly priced and documented, and eliminations clean at consolidation.
-
-## Initial Assessment
-
-1. **IC Landscape**
-   - Entity map: who transacts with whom (goods, services, royalties, cost-shares, loans, dividends).
-   - Matching infrastructure: dedicated IC accounts by counterparty? Matching tool or spreadsheets? Tolerance policy?
-
-2. **This Period's Problem**
-   - New transaction to structure, mismatch to resolve, elimination to prepare, or settlement/netting to run.
-
----
-
-## IC Framework
-
-### Transaction Lifecycle Discipline
-1. **Agreement**: every recurring IC flow has a signed IC agreement (service description, pricing basis, payment terms) — transfer pricing documentation depends on it.
-2. **Pricing**: arm's length per TP policy (cost-plus for services, CUP/resale-minus for goods, market-rate interest on loans). Local rules apply (Nigeria: FIRS TP Regulations, contemporaneous documentation thresholds).
-3. **Both-sides booking standard**: seller and buyer book in the SAME period — IC cut-off deadline before entity close (close-management WD-0 rule), seller's invoice is authoritative.
-4. **Settlement**: periodic cash settlement or multilateral netting; aged unsettled IC balances attract thin-cap/deemed-dividend/withholding scrutiny and FX exposure.
-
-### Mismatch Resolution Hierarchy
-Timing (in transit) → FX (different rates used — fix: mandated single rate source) → missing booking (one side never recorded) → pricing dispute (escalate to TP owner). Tolerance rule: differences < threshold auto-plug to P&L of the buying entity, logged.
-
-### Elimination Mechanics (consolidation)
-- Balances: Due-from vs. due-to by counterparty pair — must net to zero pre-elimination.
-- P&L: IC revenue vs. IC cost eliminated gross.
-- **Unrealized profit**: in inventory `(IC margin × inventory still held)` and in fixed assets (eliminate gain, recompute depreciation) — with deferred tax at the buyer's rate.
-- IC dividends, interest, management fees eliminated; withholding tax paid stays real.
-- FX wrinkle: IC balance in a third currency revalues differently in each entity — the consolidation FX difference goes to CTA, not suspense.
-
----
-
-## Technical Analysis Steps
-
-1. **Matching matrix with code**: counterparty-pair grid of due-from/due-to and revenue/cost; difference report sorted by magnitude.
-2. **Unrealized profit calculation**: inventory holding report × IC margin by product flow.
-3. **Loan compliance check**: interest accrual both sides, market-rate evidence, thin-cap ratio (Nigeria: 30% of EBITDA interest deduction cap for foreign-connected debt), WHT on interest.
-
----
-
-## Output Format
-
-### IC Reconciliation / Elimination Package
-
-**Matching Matrix**: pair-by-pair balances with differences and aging.
-
-**Difference Resolution Log**: cause category, owner, fix, deadline.
-
-**Elimination Entries**: full set with deferred tax effects.
-
-**Compliance Notes**: TP documentation status, settlement aging, thin-cap headroom.
-
----
-
-## 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
-- [Elimination Entries Guide](./references/elimination-entries.md): Worked eliminations including unrealized profit and FX.
-
----
-
-## Related Skills
-- **corporate-consolidation**: Eliminations feed the consolidation this skill supports.
-- **automated-reconciliation**: Matching engine logic for IC balances.
-- **deferred-tax**: Tax effects of unrealized profit eliminations.
-- **tax-planning**: Transfer pricing strategy behind IC pricing.

package/selected-skills/financeskills/skills/intercompany-accounting/references/elimination-entries.md

@@ -1,35 +0,0 @@
-# Intercompany Elimination Entries (worked)
-
-## 1. Balance Elimination
-Parent due-from Sub 40M; Sub due-to Parent 40M:
-`Dr IC Payable (Sub) 40M / Cr IC Receivable (Parent) 40M` — at consolidation level only; never touch entity books.
-If they DON'T match, fix the entity books first. Eliminating a mismatch hides an error.
-
-## 2. IC Sales and Unrealized Profit in Inventory
-Sub sold goods to Parent for 30M (cost 22M); Parent resold 75%, holds 25%.
-- Eliminate trading gross: `Dr IC Revenue 30M / Cr IC COGS 30M` (then true COGS adjustments)
-- Unrealized profit = 25% × 8M = 2M: `Dr COGS 2M / Cr Inventory 2M`
-- Deferred tax (buyer's rate 30%): `Dr DTA 0.6M / Cr Tax Expense 0.6M`
-- NCI note: if the SELLER is a partly-owned sub (upstream), allocate the 2M elimination against NCI's profit share proportionately.
-
-## 3. Fixed Asset Transfer With Gain
-Sub sells machine to Parent: proceeds 15M, carrying 10M, remaining life 5 years, transfer at start of year.
-- Eliminate gain: `Dr Gain on Disposal 5M / Cr PP&E 5M`
-- Depreciation correction (parent depreciates 15M/5 = 3M; group basis 10M/5 = 2M): `Dr Accumulated Depreciation 1M / Cr Depreciation Expense 1M` — repeat annually until life ends.
-- Deferred tax on the net 4M difference at buyer's rate.
-
-## 4. IC Loan and Interest
-Parent lends Sub $1M at 8%; half-year elapsed.
-- Eliminate balance: `Dr Loan Payable 1M / Cr Loan Receivable 1M`
-- Eliminate interest: `Dr Interest Income 40k / Cr Interest Expense 40k`
-- WHT withheld by Sub on interest paid stays in the consolidated tax accounts (real cash to the tax authority).
-- Check: both sides accrued? A common mismatch is lender accruing monthly, borrower booking on payment.
-
-## 5. Management Fees / Royalties
-`Dr Management Fee Income (Parent) / Cr Management Fee Expense (Sub)` — gross elimination. Verify the TP markup documentation BEFORE eliminating; elimination doesn't sanitize a non-arm's-length price for tax.
-
-## 6. IC Dividend
-Sub declares 20M dividend to Parent: `Dr Dividend Income (Parent) 20M / Cr Retained Earnings adjustment` at consolidation (the sub's RE reduction already flows through). NCI's share of the dividend is real cash out of the group — no elimination of the NCI portion.
-
-## Settlement Netting Cycle (monthly)
-Build the obligation matrix → net bilaterally (or multilaterally via a netting center) → single payment per pair → book settlements same day both sides → revalue residual FX stubs. Netting cuts wire costs and FX spread, and ages nothing.

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

@@ -1,21 +0,0 @@
-# Worked Example - inventory-costing
-
-## Ask
-
-> Purchases: 200 units at 50, then 300 at 60, then 100 at 70. We sold 450 units. Give me COGS and ending inventory under FIFO and periodic weighted average.
-
-## What a correct response contains
-
-Total cost 35,000 for 600 units. FIFO: COGS = 200x50 + 250x60 = 25,000; ending = 50x60 + 100x70 = 10,000. Weighted avg 58.333: COGS = 26,250; ending = 8,750. Both proved to total 35,000.
-
-## File-driven variant
-
-With fixture(s) `evals/files/purchases_sales.csv`:
-
-> From the attached purchase/sale ledger (evals/files/purchases_sales.csv), compute COGS and ending inventory for the 150-unit sale under FIFO, weighted average, and periodic LIFO. State which gives the lowest taxable income in this rising-price environment.
-
-Expected: FIFO COGS $1,600 / EI $2,000; WAC $1,800; LIFO $2,000. LIFO minimizes taxable income when prices rise.
-
-## Compute, don't estimate
-
-All figures above come from [`scripts/calculate.py`](./scripts/calculate.py) - import its functions rather than doing arithmetic in prose.