option-valuation-toolkit

Price employee options, distressed equity, and real options with Black-Scholes and binomial models.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Valuation work repeatedly hits four option problems that a plain DCF cannot handle: employee options that must be valued and subtracted before computing value per share, distressed equity that still trades because it behaves like a call option on firm assets, real options like patents and undeveloped reserves that a static DCF misses, and early-exercise situations where a European formula understates value. ## Core Features & Use Cases - Five pricing subcommands: black-scholes, binomial (with American exercise), employee-options (dilution-adjusted via iterative fixed point), equity-as-option (with implied default probability and debt yield), and implied-vol (bisection inversion), all reading JSON and printing JSON. - Real-option discipline: a three-test framework (is there an option, is exclusivity real, can a model price it) plus a mapping table from business facts like patents, reserves, and expansion rights onto script inputs, with guidance on the cost-of-delay dividend yield. - Use Case: Value Biogen's Avonex patent as a real option by piping spot, strike, 17-year life, volatility, and cost of delay into the black-scholes subcommand, yielding roughly $905m against a $547m intrinsic value. ## Quick Start Run the options script's selftest subcommand with python3 to verify the engine, then pipe a JSON payload with spot, strike, time to expiry, volatility, and riskfree rate into the black-scholes subcommand to price your first option.

Frequently Asked Questions about option-valuation-toolkit

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

FAQPage Schema
How do I value employee stock options in a company valuation?

Value employee options with the employee-options subcommand, which prices them with Black-Scholes on a dilution-adjusted spot solved iteratively. Subtract the resulting total option value from equity value, then divide by actual shares outstanding rather than a diluted count.

How to value equity of a company with negative earnings and high debt?

Treat the equity as a call option on firm value struck at the face value of debt using the equity-as-option subcommand. It returns equity value, implied debt value, implied interest rate, and probability of default from firm value, debt face value, maturity, and firm value volatility.

When should I use a binomial tree instead of Black-Scholes?

Use the binomial subcommand when early exercise is genuinely possible, such as American puts or real options exercised as soon as they pay. Black-Scholes and the tree agree for European options, which the selftest confirms converges within a fifth of a cent at 500 steps.

Does this option pricing script require any Python packages?

No third-party packages are required. The script uses only the Python standard library, computing the normal distribution from math.erf, so it runs anywhere python3 is installed without pip installs.

Why does the binomial subcommand refuse to run my inputs?

The tree stops when the risk-neutral probability falls outside [0, 1], which means volatility is too low relative to the rates for the chosen step size. Raise the steps parameter, typically to a few hundred, and rerun.

When should a real option premium not be added to a DCF valuation?

Add nothing when you cannot name a specific underlying asset with a contingent payoff, or when competitors can exploit the same contingency, since competition drives the option value to zero. Also avoid double counting by removing the option's growth from the DCF cash flows.