business-narrative-analyst

Writes a valuation narrative and maps every claim to DCF driver inputs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Valuations often start from a driver template and grow a story afterwards, producing rationalizations no downstream check can detect. This Skill reverses that order: it writes the business story first, grades every claim by evidence, and converts each claim into exactly one DCF driver so the forecast is grounded in an auditable narrative. ## Core Features & Use Cases - Narrative-to-driver mapping: Produces narrative.md (the prose case) and drivers.json (the dcf-valuation-engine payload), with a one-claim-one-driver rule and a claim ledger graded probable, plausible, or possible. - Constraint and screen enforcement: Honors classification constraints such as no-standard-growth-model, require-failure-probability, and no-perpetual-growth-above-riskfree, and runs impossible/implausible/improbable screens plus an aggregation test. - Counter-narratives and probe diagnostics: Builds higher and lower alternative stories, then probes the payload through the DCF engine to read terminal value share, implied marginal return on capital, and terminal excess return. - Use Case: As the narrative stage of a valuation team run, it receives classification and financial inputs from an orchestrator and hands defensible growth, margin, reinvestment, and failure assumptions to the intrinsic-valuation stage. ## Quick Start Ask the valuation orchestrator to run the narrative stage for a company so it writes narrative.md and drivers.json from the classification and financial inputs.

Frequently Asked Questions about business-narrative-analyst

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

FAQPage Schema
How do I turn a business story into DCF valuation assumptions?

Write the narrative in prose first, break it into discrete claims, grade each as probable, plausible, or possible, then map every claim to exactly one driver field such as revenue_growth, operating_margin, or sales_to_capital. The Skill outputs narrative.md and a drivers.json payload for the dcf-valuation-engine.

How to build a growth forecast for a company with negative earnings?

Under the no-standard-growth-model constraint, build a revenue path from market size and attainable share, anchor a target margin on mature firms with the same business model, and glide to it with a convergence year. Never state an earnings growth rate; deeply negative early cash flow is the correct output.

Can this Skill be used standalone outside the valuation team?

No. It is a stage brief loaded by the valuation orchestrator with absolute input and output paths, and it explicitly says it is not for direct use. For standalone narrative work, load the narrative-to-numbers skill instead.

What inputs does the narrative stage of a valuation require?

It requires mandate.json with currency and valuation date, classification.json with a primary path and constraints, and at least one third-party market size estimate with source and date. Raw financials, market data, gaps, and cleaned financials are used when present, with missing items reported as gaps.

What are the limits on terminal growth and return on capital assumptions?

Terminal growth never exceeds the riskfree rate in the mandate currency. Terminal return on capital above the terminal cost of capital requires a named barrier to entry in the prose; otherwise the two are set equal, meaning no perpetual excess returns.

Why does a valuation claim get routed to the option layer instead of cash flows?

Claims graded possible have probabilities that cannot be assessed, so they never enter the cash flows. They go to the option_layer block and are valued once by the real-options stage, preventing double counting with revenue already in the model.