dcf-valuation-engine

Computes DCF valuations from value drivers through terminal value to value per share.

Updated Sep 9, 2026
One-click install
npx skills add https://github.com/lyndonkl/hermesworld --skill dcf-valuation-engine-lyndonkl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dcf-valuation-engine
Source: https://github.com/lyndonkl/hermesworld/tree/main/packages/capital-structure-analyst/skills/corporate-finance/dcf-valuation-engine
Command: npx skills add https://github.com/lyndonkl/hermesworld --skill dcf-valuation-engine-lyndonkl

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Building a discounted cash flow model by hand is slow and error-prone: growth without matching reinvestment inflates value, terminal assumptions silently break, and the bridge from operating assets to equity per share is easy to get wrong. This Skill runs the arithmetic deterministically from drivers you supply, so effort goes into the four judgments that matter — growth, margin, reinvestment, and risk. ## Core Features & Use Cases - Full DCF valuation: The value subcommand turns drivers (revenue growth, operating margin, sales-to-capital, tax rate, cost of capital) into a year-by-year FCFF forecast, terminal value, failure-risk adjustment, equity bridge, and value per share. - Sensitivity grids: The sensitivity subcommand re-runs the valuation across one or two driver axes (e.g., terminal growth vs. target margin) to show a range instead of a false point estimate. - Implied expectations: The implied subcommand solves backwards — given the market price, what growth or margin must the market already believe? - Use Case: Value a company growing 25% today but converging to 3%: pass a glide-path driver JSON to dcf.py value, then run implied against the current stock price to check whether the market's assumed margin is defensible. ## Quick Start Ask the agent to run a DCF valuation with your revenue growth, margin, sales-to-capital, and cost of capital assumptions and report the value per share plus what the current market price implies.

Frequently Asked Questions about dcf-valuation-engine

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a DCF valuation from value drivers?

Pass a JSON payload with base revenue, revenue growth, operating margin, sales-to-capital, tax rate, cost of capital, terminal assumptions, and bridge items to `python3 scripts/dcf.py value`. Drivers accept a constant, a per-year list, or a glide object with start, end, and converge_by.

How do I find what growth or margin the market price implies?

Use the `implied` subcommand with your base case, a dotted driver path such as operating_margin.end, the target value per share, and search bounds. It bisects the driver until the DCF value per share matches the market price.

Does the DCF script require any Python packages?

No. The engine is pure Python standard library with no third-party dependencies, so it runs anywhere Python 3 is installed. Input and output are JSON via stdin/stdout or an --in file.

Why does the DCF engine refuse to run my terminal assumptions?

The engine rejects terminal growth at or above the terminal cost of capital, since the perpetuity formula would not produce a finite value. It also rejects combinations where terminal growth divided by return on capital implies reinvesting more than 100% of income.

When should I not use an FCFF DCF model?

Avoid FCFF for financial service firms, where debt is raw material and cost of capital is meaningless — use dividend or excess-return models instead. For deeply distressed firms where equity behaves like an option, use an option-pricing approach rather than a going-concern DCF.

How does the model handle young or distressed companies?

Supply a failure block with a probability and distress proceeds based on book value or a discounted going-concern value. The engine weights the going-concern value and distress proceeds by the failure probability, and net operating loss carryforwards shelter early income from tax.