financial-data-sourcing

Maps every valuation input to its source, units, freshness limit, and fallback ladder.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Valuation and corporate-finance analyses fail silently when inputs arrive without provenance, consistent units, or a documented substitute for missing data. This Skill defines the input contract for a valuation pipeline: what to fetch, from which source, in what units, how stale it may be, whether a user may supply it directly, and what to substitute when it cannot be found. ## Core Features & Use Cases - Staged collection plan: Eight stages (A1–A8) covering mandate and identity, financial statements, footnotes, market data, macro and currency data, reference-table loads, ownership and governance, and comparable firms, plus conditional branches for banks, young, distressed, cyclical, emerging-market, private, and multi-business firms. - Provenance and gap tracking: Produces raw-financials.json, market-data.json, sources.md, and gaps.json, with a status vocabulary (found, user, derived, fallback, stale, missing) tracing every field to the stage it constrains. - Consistency and single-count rules: Enforces currency, claimholder, basis, vintage, and debt-convention matching rules plus ten single-count rules that prevent double-counting tax shields, country risk, options, cash, and control value. - Use Case: Before running a DCF on an emerging-market manufacturer, use this Skill to collect ten years of statements, walk the riskfree-rate fallback ladder, load the Damodaran reference tables at one consistent vintage, and pass the G1_data gate with a fully documented gaps file. ## Quick Start Use the financial-data-sourcing skill to collect and source every input needed to value a publicly traded company, producing the raw-financials, market-data, sources, and gaps artifacts.

Frequently Asked Questions about financial-data-sourcing

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

FAQPage Schema
How do I source data for a company valuation?

Follow the eight collection stages: fix the mandate and identity, pull ten years of financial statements, extract footnote disclosures, gather market and macro data, load reference tables at one vintage, and assemble ownership and peer sets. Record every field's source, vintage, and status in the gaps file.

What is the fallback when a riskfree rate is unavailable?

Walk the ladder: Aaa sovereign ten-year rate, minimum across same-currency sovereigns, local rate minus the sovereign default spread, an inflation-plus-real build-up, differential inflation from the US dollar, or a full currency switch. Record the rung you stopped at.

Can users supply valuation inputs directly?

Yes for judgment inputs like target margins, market size, growth-period length, and synergy assumptions. Never accept bare statement lines without filing references, rate-table rows without vintage, or a WACC given as a single number without components.

Why must reference tables share one vintage?

Mixing a current riskfree rate with a stale country premium or old spread table creates inconsistencies that survive review unnoticed. All vintage-critical tables must share one as_of within three months of each other and twelve months of the valuation date.

What blocks the G1 data gate?

Failed balance-sheet, net-income, or cash reconciliation ties block the run, as do a missing vintage-critical table with no fallback, an unsourceable failure probability, a missing comparable R-squared for a total beta, or statements older than eighteen months without interim filings.

How are private companies handled differently?

Private firms require owner compensation cleanup, a comparable median R-squared for the total beta, an industry market debt-to-equity ratio, a buyer-type declaration, and an illiquidity discount route. Buyer type determines whether a market beta or total beta applies.