xbrl-fallbacks

Recover shares-outstanding values from SEC filing text when XBRL data is missing.

Updated Apr 29, 2026
One-click install
npx skills add https://github.com/jefrnc/quant-llm-skills --skill xbrl-fallbacks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xbrl-fallbacks
Source: https://github.com/jefrnc/quant-llm-skills/tree/main/skills/xbrl-fallbacks
Command: npx skills add https://github.com/jefrnc/quant-llm-skills --skill xbrl-fallbacks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

XBRL gaps (404/empty/sparse company-facts) can make quant pipelines incorrectly conclude that share counts are missing, breaking dilution and float-based analyses for real issuers.

Core Features & Use Cases

  • Fallback hierarchy for shares outstanding: recovers the earliest reliable cover-page/text count across 10-Q, 10-K, 6-K, 20-F, F-* registrations, 424B supplements, DEF 14A, and initial registration forms.
  • Text-based extraction rules: interprets common templated language for “as of” share counts, normalizes numbers (commas, scaling), and captures the as-of date.
  • Multi-class and ADS gotchas: handles Class A/B summation and tracks ADS-to-ordinary share ratios without collapsing important share structures.
  • Provenance and validation guardrails: emits a synthetic-tag datapoint (text:...) with source_form, source_accession, filed_date vs as_of_date safety semantics, plus cross-check guidance against any available XBRL and offering deltas.
  • Use case: estimate dilution over time for small-cap FPIs, SPAC shell phases, or recently listed companies when structured XBRL is delayed or absent.

Quick Start

Use the xbrl-fallbacks skill to extract and validate shares-outstanding from the most recent relevant SEC filing text when company-facts XBRL is missing or empty.

Frequently Asked Questions about xbrl-fallbacks

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

FAQPage Schema
How do I recover shares outstanding when SEC XBRL company-facts returns a 404 or empty data?

To recover shares outstanding when SEC XBRL company-facts returns a 404 or empty data, apply a deterministic fallback search order to extract cover-page text counts from 10-Q, 10-K, 6-K, and 20-F filings. This text-based extraction normalizes numbers and captures the as-of date to restore missing datapoints.

What is the best way to estimate dilution for recent IPOs and SPAC pre-combination phases?

The best way to estimate dilution for recent IPOs and SPAC pre-combination phases is to use text-based cover-page extraction from SEC filings. This approach recovers the earliest reliable share counts when structured XBRL data is delayed, absent, or sparse for these specific issuer types.

How do you extract shares outstanding from SEC filing text while maintaining lookahead safety?

Extracting shares outstanding from SEC filing text while maintaining lookahead safety requires provenance-tagged output that distinguishes filed_date from as_of_date semantics. The process enforces validation rules and cross-checks against available XBRL and offering deltas to prevent future data leakage in quant pipelines.

Does this text extraction approach handle multi-class share structures and ADS ratios?

Yes, this text extraction approach handles multi-class share structures and ADS ratios. It interprets Class A/B summation templated language and tracks ADS-to-ordinary share ratios without collapsing important share structures during the cover-page count normalization process.

Can I use cover-page text extraction for quant float analysis when structured data is missing?

Yes, you can use cover-page text extraction for quant float analysis when structured data is missing. It applies a fallback hierarchy across F-* registrations, 424B supplements, DEF 14A, and initial registration forms to find the earliest dependable source for missing share counts.

Why does XBRL fail to return shares outstanding for foreign private issuers and amended filings?

XBRL fails to return shares outstanding for foreign private issuers and amended filings because structured company-facts datapoints are often delayed, sparse, or absent. In these cases, the cover-page text count becomes the first dependable source, requiring fallback extraction to prevent broken dilution pipelines.