Claude Skill

residual-income

Residual Income valuation, EVA Economic Value Added, excess return valuation, book value plus economic profit, financial institution valuation, bank valuation, insurance company valuation

LLM Mart · 0 points · 0 views 0 listing impressions 0 install-command copies
Virus-scanned Reviewed automatically before listing.

Full trust report

Download agentii-ai-agentii-investment-intelligence-plugins_vertical-plugins_quantitative-analysis_skills_agentii_residual-income-3b0a195.zip · 5 KB
Part of agentii-ai/agentii-investment-intelligence — 46 skills

Install

skills CLI npx skills add https://github.com/agentii-ai/agentii-investment-intelligence/tree/main/plugins/vertical-plugins/quantitative-analysis/skills/agentii/residual-income
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install agentii-ai-agentii-investment-intelligence@llmmart
Git git clone https://github.com/agentii-ai/agentii-investment-intelligence.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole agentii-ai/agentii-investment-intelligence collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Residual Income / Economic Value Added (EVA) Valuation

Values a company as: Book Value + Present Value of Future Economic Profit. Economic profit = earnings ABOVE the required return on equity. Especially valuable for financial institutions (banks, insurers) where DCF is problematic due to the nature of debt (it's inventory, not capital) and for capital-intensive firms. Also known as the Edwards-Bell-Ohlson (EBO) model in academic literature.

Preflight

Run the canonical pre-flight sequence — MCP health probe, ticker resolution, workspace style.md override, memory load, and coverage check. See contracts/preflight.md.

Include the X-Agentii-Trace header on every tool call per contracts/x-agentii-trace-header.md.

Triggers

  • residual income valuation
  • EVA valuation
  • economic value added
  • excess return model
  • book value plus economic profit
  • EBO model
  • bank valuation model
  • financial institution valuation
  • value residual income
  • RI valuation

Defaults

Parameter Default Notes
projection_years 5 Years of explicit residual income forecast
terminal_growth 2.5% Perpetual RI growth (should be conservative)
cost_of_equity CAPM Ke = Rf + β × ERP, or manual input

Methodology

Retrieval Scope

structured_only — Residual Income uses book value from XBRL + earnings estimates + current price.

Retrieval Strategy

See contracts/retrieval.md for the canonical decision tree; skill-specific retrieval detail is in references/methodology.md.

Temporal Scope

Default lookback: 4 fiscal quarter(s); maximum: 20. The default balances recency against the trend window this analysis requires.

Tool Allowlist

Per frontmatter allowed_tools:

  • search_xbrl_facts — primary structured financial facts (is_primary default)
  • get_realtime_quote — latest market price for valuation cross-checks
  • search_earnings_calendar — EPS actual/estimate/surprise + report dates

Protocol

Step-by-step execution detail is in references/methodology.md.

When to Use Residual Income vs. DCF

Company Type Preferred Model Why
Banks, Insurers Residual Income Debt is inventory, not capital — DCF doesn't work
Capital-Intensive Industrials Residual Income Asset-heavy; book value is meaningful
Asset Managers Residual Income AUM-based; book value + fee earnings
Tech, SaaS, Pharma DCF Asset-light; cash flow focus
Mature Dividend Payers DDM Dividends are the primary return mechanism
High-Growth, No Earnings Revenue-based DCF No earnings or book value to anchor

Output File

Write the final deliverable to {ticker}/{YYYY-MM-DD_HHMM}_residual-income_{affix}.md.

Output Structure

The deliverable is a structured markdown report written to the path in ## Output File. Full section-by-section template (headings, tables, and field definitions) lives in references/output-structure.md. Required elements:

  1. Executive Summary — headline conclusions (≤200 words).
  2. Core analysis sections — per this skill's methodology and analyst modes.
  3. Data classification — tag findings [FACT] / [DEDUCTED] / [VIEW] per contracts/snapshot-synthesis.md.
  4. Coverage Gaps & Citations — inline /v/ citations are PRIMARY (immediately after each fact); the bottom Citations section is a non-duplicative roll-up index.
  5. Output frontmatter — emit the FR-090 structured block per contracts/output-frontmatter-schema.md.

Citations & memory: follow contracts/citation-and-memory.md — ≥1 citation per 200 words; every material fact, table row, and metric is immediately followed by its inline clickable https://agentii.ai/v/{ticker}/{citation_id}/{N} link; a bottom Citations section provides a non-duplicative roll-up index; the closing TUI reply includes a compact Key Citations list (headline 5–10 facts) of clickable /v/ URLs; and append the run to agentii.md per contracts/agentii-md-schema.md.

Validation Gates

  1. RI convergence: residual income must not grow perpetually above Ke. If failed: terminal growth g must be < Ke by at least 2%.
  2. Book value consistency: BV_t = BV_t-1 + NI_t - D_t must hold for all forecast years. If failed: refuse delivery; check arithmetic.
  3. Economic plausibility: fair value P/B between 0.1x and 10x. If failed: flag extreme assumptions.

Tool Fallbacks

Per-tool failure modes and fallback actions are tabulated in references/tool-fallbacks.md.

Memory & Snapshot

  • Memory load (pre-flight): load prior workspace context for the ticker before retrieval — see contracts/memory-load.md.
  • Structured output frontmatter: emit the FR-090 block (key_metrics, conclusions, facts_count, deducted_count, views_count, citation_count) per contracts/output-frontmatter-schema.md.
  • Snapshot synthesis: after writing the deliverable, update the two-tier snapshot and classify findings as [FACT]/[DEDUCTED]/[VIEW] — see contracts/snapshot-synthesis.md.
  • Session archival: record the run under sessions/{YYYY-MM-DD}/ and update sessions/INDEX.md per contracts/session-format.md.

Final Summary (TUI)

End the closing chat reply with a compact Key Citations list (headline 5–10 facts), each a clickable https://agentii.ai/v/{ticker}/{citation_id}/{N} link, so the user can cmd+click straight to the exact SEC page. See contracts/citation-and-memory.md.

Error Handling

Failure Mode Action User-Facing Message
Negative book value Halt "Book value is negative — Residual Income model not applicable. Use DCF."
No earnings data Halt "Insufficient earnings data for ."
Files (agentii-investment-intelligence)
  • references
    • methodology.md 1.3 KB
      # residual-income — Methodology Detail
      
      Extracted from SKILL.md for progressive disclosure (US5).
      
      ## Retrieval Strategy
      
      Follows the retrieval strategy decision tree in `contracts/retrieval.md`. Primary branch: **(a) Structured Data Query**. Resolve the canonical ticker first (exact → fuzzy alias → share-class) before any data call.
      
      ## Protocol
      
      1. **Pre-retrieval**: `get_company_fiscal_calendar/{ticker}` then `get_ticker_coverage/{ticker}` .
      2. **Book value**: `search_xbrl_facts(ticker, concept=["Equity", "StockholdersEquity"], fiscal_year=[latest])` — latest book value of equity.
      3. **Earnings**: `search_earnings_calendar(ticker, fiscal_year=[latest, latest+1, latest+2])` for consensus EPS estimates.
      4. **Cost of equity (Ke)**: CAPM — Rf (10Y UST) + β × ERP (5%). β from `get_realtime_quote`.
      5. **Forecast residual income**:
       - For each forecast year: RI_t = Net Income_t - (Ke × Beginning Book Value_t-1)
       - Book Value_t = Book Value_t-1 + Net Income_t - Dividends_t
       - Dividends_t = Net Income_t × Payout Ratio (historical average or zero if no dividend)
      6. **Terminal value**: TV = RI_terminal × (1+g) / (Ke - g), where g is perpetuity growth (typically 0% or GDP-like rate for RI).
      7. **Fair value**: BV_0 + PV(RI_1) + PV(RI_2) + ... + PV(RI_terminal) + PV(TV) = per-share equity value.
      8. **Output**: per with YAML frontmatter .
      
    • modes.md 697 B
      # residual-income — Analyst Mode Definitions
      
      Derived from the skill's own methodology structure (scripts/mode_backfill.py, spec 046 M1).
      
      ### Mode: preflight
      
      **Objective**: Preflight analysis per the skill's methodology (see SKILL.md sections).
      
      ### Mode: triggers
      
      **Objective**: Triggers analysis per the skill's methodology (see SKILL.md sections).
      
      ### Mode: defaults
      
      **Objective**: Defaults analysis per the skill's methodology (see SKILL.md sections).
      
      ### Mode: methodology
      
      **Objective**: Methodology analysis per the skill's methodology (see SKILL.md sections).
      
      ### Mode: retrieval-scope
      
      **Objective**: Retrieval Scope analysis per the skill's methodology (see SKILL.md sections).
      
    • output-structure.md 1.4 KB
      # residual-income — Output Structure (full template)
      
      Extracted from SKILL.md for progressive disclosure (US5). The skill body keeps a compact summary under `## Output Structure`.
      
      1. **Executive Summary** — per-share fair value, premium/discount to current price, implied P/B vs current P/B
      2. **Book Value Analysis** — current BV per share, historical BV growth, ROE trend
      3. **Cost of Equity** — CAPM decomposition: Rf, β, ERP → Ke
      4. **Residual Income Projection** — year-by-year RI forecast with NI, BV, Dividends, RI per year
      5. **Terminal Value** — perpetuity of residual income beyond forecast horizon
      6. **Fair Value Bridge** — BV_0 + PV(RI_1..5) + PV(TV) = per-share value
      7. **Implied P/B** — fair value P/B vs. current P/B; if <1.0, market prices below book (distress signal or value opportunity)
      8. **Sensitivity** — fair value at varying Ke (±1%, ±2%) and terminal RI growth (±1%)
      9. **Coverage Gaps & Citations**
      
      **Citations & memory**: follow `contracts/citation-and-memory.md` — ≥1 citation per 200 words; every material fact, table row, and metric is immediately followed by its inline clickable `https://agentii.ai/v/{ticker}/{citation_id}/{N}` link; a bottom **Citations** section provides a non-duplicative roll-up index; the closing TUI reply includes a compact **Key Citations** list (headline 5–10 facts) of clickable `/v/` URLs; and append the run to `agentii.md` per `contracts/agentii-md-schema.md`.
      
    • tool-fallbacks.md 367 B
      # residual-income — Tool Fallbacks
      
      Extracted from SKILL.md for progressive disclosure (US5).
      
      | Tool | Failure Mode | Fallback Action |
      |------|-------------|-----------------|
      | `get_realtime_quote` | Beta unavailable | Use industry average beta from Damodaran data |
      | `search_earnings_calendar` | No consensus | Use historical EPS trend + manual ROE forecast |
      
  • SKILL.md 6.4 KB
    ---
    name: residual-income
    multi_ticker_semantics: target_with_optional_peers
    description: Residual Income valuation, EVA Economic Value Added, excess return valuation, book value plus economic profit, financial institution valuation, bank valuation, insurance company valuation
    temporal_scope:
     default_quarters: 4
     max_quarters: 20
     description: "Trailing equity data; up to 20 quarters for projection"
    allowed_tools:
     - search_xbrl_facts
     - get_realtime_quote
     - search_earnings_calendar
    retrieval_scope: structured_only
    min_tool_diversity: 3
    ---
    
    # Residual Income / Economic Value Added (EVA) Valuation
    
    Values a company as: Book Value + Present Value of Future Economic Profit. Economic profit = earnings ABOVE the required return on equity. Especially valuable for financial institutions (banks, insurers) where DCF is problematic due to the nature of debt (it's inventory, not capital) and for capital-intensive firms. Also known as the Edwards-Bell-Ohlson (EBO) model in academic literature.
    
    ## Preflight
    
    Run the canonical pre-flight sequence — MCP health probe, ticker resolution, workspace `style.md` override, memory load, and coverage check. See `contracts/preflight.md`.
    
    Include the `X-Agentii-Trace` header on every tool call per `contracts/x-agentii-trace-header.md`.
    ## Triggers
    
    - residual income valuation {ticker}
    - EVA valuation {ticker}
    - economic value added {ticker}
    - excess return model {ticker}
    - book value plus economic profit {ticker}
    - EBO model {ticker}
    - bank valuation model {ticker}
    - financial institution valuation {ticker}
    - value {ticker} residual income
    - RI valuation {ticker}
    
    ## Defaults
    
    | Parameter | Default | Notes |
    |-----------|---------|-------|
    | projection_years | 5 | Years of explicit residual income forecast |
    | terminal_growth | 2.5% | Perpetual RI growth (should be conservative) |
    | cost_of_equity | CAPM | Ke = Rf + β × ERP, or manual input |
    
    ## Methodology
    
    ### Retrieval Scope
    
    `structured_only` — Residual Income uses book value from XBRL + earnings estimates + current price.
    
    ### Retrieval Strategy
    
    See `contracts/retrieval.md` for the canonical decision tree; skill-specific retrieval detail is in `references/methodology.md`.
    
    ### Temporal Scope
    
    Default lookback: 4 fiscal quarter(s); maximum: 20. The default balances recency against the trend window this analysis requires.
    
    ### Tool Allowlist
    
    Per frontmatter `allowed_tools`:
    
    - `search_xbrl_facts` — primary structured financial facts (is_primary default)
    - `get_realtime_quote` — latest market price for valuation cross-checks
    - `search_earnings_calendar` — EPS actual/estimate/surprise + report dates
    
    ### Protocol
    
    Step-by-step execution detail is in `references/methodology.md`.
    
    ### When to Use Residual Income vs. DCF
    
    | Company Type | Preferred Model | Why |
    |-------------|----------------|-----|
    | Banks, Insurers | Residual Income | Debt is inventory, not capital — DCF doesn't work |
    | Capital-Intensive Industrials | Residual Income | Asset-heavy; book value is meaningful |
    | Asset Managers | Residual Income | AUM-based; book value + fee earnings |
    | Tech, SaaS, Pharma | DCF | Asset-light; cash flow focus |
    | Mature Dividend Payers | DDM | Dividends are the primary return mechanism |
    | High-Growth, No Earnings | Revenue-based DCF | No earnings or book value to anchor |
    
    ## Output File
    
    Write the final deliverable to `{ticker}/{YYYY-MM-DD_HHMM}_residual-income_{affix}.md`.
    
    ## Output Structure
    
    The deliverable is a structured markdown report written to the path in `## Output File`. Full section-by-section template (headings, tables, and field definitions) lives in `references/output-structure.md`. Required elements:
    
    1. **Executive Summary** — headline conclusions (≤200 words).
    2. **Core analysis sections** — per this skill's methodology and analyst modes.
    3. **Data classification** — tag findings `[FACT]` / `[DEDUCTED]` / `[VIEW]` per `contracts/snapshot-synthesis.md`.
    4. **Coverage Gaps & Citations** — inline `/v/` citations are PRIMARY (immediately after each fact); the bottom **Citations** section is a non-duplicative roll-up index.
    5. **Output frontmatter** — emit the FR-090 structured block per `contracts/output-frontmatter-schema.md`.
    
    **Citations & memory**: follow `contracts/citation-and-memory.md` — ≥1 citation per 200 words; every material fact, table row, and metric is immediately followed by its inline clickable `https://agentii.ai/v/{ticker}/{citation_id}/{N}` link; a bottom **Citations** section provides a non-duplicative roll-up index; the closing TUI reply includes a compact **Key Citations** list (headline 5–10 facts) of clickable `/v/` URLs; and append the run to `agentii.md` per `contracts/agentii-md-schema.md`.
    
    ## Validation Gates
    
    1. **RI convergence**: residual income must not grow perpetually above Ke. *If failed*: terminal growth g must be < Ke by at least 2%.
    2. **Book value consistency**: BV_t = BV_t-1 + NI_t - D_t must hold for all forecast years. *If failed*: refuse delivery; check arithmetic.
    3. **Economic plausibility**: fair value P/B between 0.1x and 10x. *If failed*: flag extreme assumptions.
    
    ## Tool Fallbacks
    
    Per-tool failure modes and fallback actions are tabulated in `references/tool-fallbacks.md`.
    
    ## Memory & Snapshot
    
    - **Memory load** (pre-flight): load prior workspace context for the ticker before retrieval — see `contracts/memory-load.md`.
    - **Structured output frontmatter**: emit the FR-090 block (`key_metrics`, `conclusions`, `facts_count`, `deducted_count`, `views_count`, `citation_count`) per `contracts/output-frontmatter-schema.md`.
    - **Snapshot synthesis**: after writing the deliverable, update the two-tier snapshot and classify findings as `[FACT]`/`[DEDUCTED]`/`[VIEW]` — see `contracts/snapshot-synthesis.md`.
    - **Session archival**: record the run under `sessions/{YYYY-MM-DD}/` and update `sessions/INDEX.md` per `contracts/session-format.md`.
    
    ## Final Summary (TUI)
    
    End the closing chat reply with a compact **Key Citations** list (headline 5–10 facts), each a clickable `https://agentii.ai/v/{ticker}/{citation_id}/{N}` link, so the user can cmd+click straight to the exact SEC page. See `contracts/citation-and-memory.md`.
    
    ## Error Handling
    
    | Failure Mode | Action | User-Facing Message |
    |-------------|--------|---------------------|
    | Negative book value | Halt | "Book value is negative — Residual Income model not applicable. Use DCF." |
    | No earnings data | Halt | "Insufficient earnings data for {ticker}." |
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.

Related