@v587d/capital-generation 2.7.12 → 2.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (148) hide show
  1. package/CHANGELOG.md +28 -0
  2. package/README.md +3 -2
  3. package/chart-ui/package.json +1 -1
  4. package/config/package.json +1 -1
  5. package/lib/agents/bash-guard.d.ts +22 -17
  6. package/lib/agents/bash-guard.js +32 -28
  7. package/lib/agents/root-tool-policy.d.ts +29 -3
  8. package/lib/agents/root-tool-policy.js +100 -14
  9. package/lib/index.js +14 -8
  10. package/lib/web-retriever/local-fetch.d.ts +1 -1
  11. package/lib/web-retriever/local-fetch.js +1 -1
  12. package/lib/web-retriever/wind-client.d.ts +1 -1
  13. package/lib/web-retriever/wind-client.js +1 -1
  14. package/package.json +1 -1
  15. package/preset/capital-generation/README.md +22 -15
  16. package/preset/capital-generation/agent.patch.yml +14 -1
  17. package/selected-skills/InvestSkill/UPSTREAM.md +17 -0
  18. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/SKILL.md +10 -296
  19. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/references/10-retrieving-the-filing.md +130 -0
  20. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/references/11-key-metrics-table.md +129 -0
  21. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/references/12-language-mode.md +60 -0
  22. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/bear-case/SKILL.md +5 -3
  23. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/SKILL.md +10 -284
  24. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/references/10-persona.md +113 -0
  25. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/references/11-section-c-company-specific.md +108 -0
  26. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/references/12-section-f-90-day.md +85 -0
  27. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/SKILL.md +11 -433
  28. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/10-overview.md +82 -0
  29. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/11-porter-s-five-forces.md +137 -0
  30. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/12-innovation-disruption-assessment.md +112 -0
  31. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/13-input-formats.md +130 -0
  32. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/SKILL.md +12 -639
  33. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/10-analysis-framework.md +138 -0
  34. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/11-dividend-history-and-reliability.md +131 -0
  35. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/12-share-buyback-analysis.md +125 -0
  36. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/13-fcf-deployment-scorecard.md +133 -0
  37. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/14-output.md +149 -0
  38. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/SKILL.md +10 -411
  39. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/references/10-analysis-framework.md +194 -0
  40. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/references/11-data-sources.md +196 -0
  41. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/references/12-thesis-invalidation.md +43 -0
  42. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/SKILL.md +11 -234
  43. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/10-overview.md +86 -0
  44. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/11-phase-4-the-implied.md +60 -0
  45. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/12-output-format.md +83 -0
  46. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/13-standard-signal-output.md +34 -0
  47. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/SKILL.md +10 -304
  48. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/references/10-key-economic-indicators.md +98 -0
  49. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/references/11-credit-market-indicators.md +114 -0
  50. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/references/12-recession-probability-scoring.md +114 -0
  51. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/SKILL.md +11 -236
  52. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/10-overview.md +83 -0
  53. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/11-phase-5-overlap-with.md +69 -0
  54. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/12-output-format.md +79 -0
  55. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/13-standard-signal-output.md +34 -0
  56. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/SKILL.md +11 -243
  57. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/10-overview.md +61 -0
  58. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/11-phase-2-source-hierarchy.md +54 -0
  59. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/12-phase-5-consistency.md +90 -0
  60. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/13-notes.md +68 -0
  61. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/SKILL.md +11 -499
  62. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/10-overview.md +143 -0
  63. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/11-phase-3-financial-statement.md +167 -0
  64. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/12-phase-6-management-tone.md +176 -0
  65. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/13-thesis-invalidation.md +43 -0
  66. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/SKILL.md +10 -291
  67. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/references/10-overview.md +117 -0
  68. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/references/11-step-3-position-locator.md +112 -0
  69. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/references/12-visualization-support.md +84 -0
  70. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/SKILL.md +10 -457
  71. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/references/10-analysis-framework.md +185 -0
  72. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/references/11-pattern-recognition.md +175 -0
  73. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/references/12-interpretation-guidelines.md +120 -0
  74. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/SKILL.md +11 -503
  75. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/10-analysis-framework.md +132 -0
  76. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/11-ownership-concentration-analysis.md +166 -0
  77. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/12-red-flags-warning-signs.md +192 -0
  78. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/13-thesis-invalidation.md +43 -0
  79. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/SKILL.md +11 -264
  80. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/10-overview.md +63 -0
  81. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/11-phase-2-explanation-card.md +108 -0
  82. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/12-output-format.md +88 -0
  83. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/13-standard-signal-output.md +34 -0
  84. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/SKILL.md +11 -448
  85. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/10-analysis-framework.md +109 -0
  86. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/11-implied-volatility-iv-analysis.md +102 -0
  87. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/12-earnings-play-analysis.md +109 -0
  88. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/13-data-sources.md +159 -0
  89. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/SKILL.md +11 -435
  90. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/10-phase-1-portfolio-snapshot.md +124 -0
  91. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/11-phase-6-correlation-diversification.md +124 -0
  92. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/12-phase-9-rebalancing-decision.md +153 -0
  93. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/13-data-verification.md +62 -0
  94. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/SKILL.md +11 -372
  95. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/10-overview.md +102 -0
  96. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/11-phase-3-the-trim.md +88 -0
  97. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/12-phase-6-the-thesis.md +105 -0
  98. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/13-input-formats.md +105 -0
  99. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/SKILL.md +10 -250
  100. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/references/10-overview.md +92 -0
  101. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/references/11-phase-4-correlation-spike.md +116 -0
  102. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/references/12-notes.md +65 -0
  103. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/SKILL.md +11 -381
  104. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/10-sector-overview.md +123 -0
  105. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/11-sector-correlation-matrix.md +90 -0
  106. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/12-peer-benchmarking-within-sector.md +92 -0
  107. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/13-consumer-staples.md +105 -0
  108. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/SKILL.md +10 -352
  109. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/references/10-analysis-framework.md +110 -0
  110. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/references/11-bearish-thesis-evaluation.md +118 -0
  111. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/references/12-data-sources.md +148 -0
  112. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/SKILL.md +16 -603
  113. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/10-analysis-components.md +122 -0
  114. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/11-dupont-decomposition.md +121 -0
  115. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/12-quality-scoring-framework.md +115 -0
  116. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/13-dcf-framework.md +113 -0
  117. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/14-analyst-consensus-tracking.md +127 -0
  118. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/15-thesis-invalidation.md +43 -0
  119. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-screener/SKILL.md +5 -3
  120. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/SKILL.md +12 -595
  121. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/10-overview.md +133 -0
  122. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/11-method-2-comparable-company.md +127 -0
  123. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/12-football-field-summary-valuation.md +140 -0
  124. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/13-terminal-value-two-methods.md +121 -0
  125. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/14-when-dcf-is.md +110 -0
  126. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/SKILL.md +12 -304
  127. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/10-overview.md +73 -0
  128. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/11-phase-3-dividends-qualified.md +67 -0
  129. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/12-framework-non-us-module.md +61 -0
  130. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/13-scoring-tax-efficiency-score.md +83 -0
  131. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/14-thesis-invalidation.md +55 -0
  132. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/SKILL.md +16 -612
  133. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/10-chart-pattern-analysis.md +172 -0
  134. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/11-chart-visualization-support.md +181 -0
  135. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/12-multi-timeframe-analysis-mtf.md +95 -0
  136. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/13-advanced-indicators-ichimoku-cloud.md +61 -0
  137. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/14-options-flow-integration.md +95 -0
  138. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/15-thesis-invalidation.md +45 -0
  139. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/SKILL.md +10 -274
  140. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/references/10-overview.md +94 -0
  141. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/references/11-phase-5-the-pre.md +113 -0
  142. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/references/12-example.md +90 -0
  143. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-catalyst-calendar/SKILL.md +5 -3
  144. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-idea-generation/SKILL.md +5 -3
  145. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-sector-overview/SKILL.md +5 -3
  146. package/selected-skills/investment-skills/skills/buffett-investment-framework/SKILL.md +1 -1
  147. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/SKILL.md +5 -3
  148. package/watchlist/package.json +1 -1
@@ -40,505 +40,17 @@ Data & Sources
40
40
 
41
41
  Extract deep investment insights from official company financial filings and reports — 10-K annual reports, 10-Q quarterly reports, earnings press releases, proxy statements (DEF 14A), and investor presentations. Combines quantitative financial analysis with qualitative assessment of management tone, strategy, and risk disclosure.
42
42
 
43
- ## Overview
43
+ ## Read the Parts
44
44
 
45
- Official filings are the primary source of truth for company analysis. Unlike financial data terminals (which aggregate selected metrics), the actual 10-K and 10-Q contain management's own words, full footnote disclosures, legal risk factors, and accounting policy choices that are invisible in summary data feeds. This skill teaches you to read between the lines of official documents and convert dense regulatory language into actionable investment insights.
45
+ Everything below the surface of this file lives in `references/`. **whole, with no line window** — quoting a rule or a template out of a slice of one is how a
46
+ file gets reported as read when it was only skimmed. The file names below are the only
47
+ addressing this entry has.
46
48
 
47
- ---
48
-
49
- ## How to Use
50
-
51
- Provide the report in one of these ways:
52
-
53
- ```
54
- # Paste report text directly
55
- /financial-report-analyst [paste 10-K or 10-Q sections]
56
-
57
- # Reference a specific ticker for the most recent filing
58
- /financial-report-analyst AAPL 10-K
59
-
60
- # Analyze a specific section
61
- /financial-report-analyst MSFT 10-Q --section risk-factors
62
-
63
- # Full deep-dive analysis
64
- /financial-report-analyst NVDA 10-K --full
65
-
66
- # Comparative: compare current vs prior period filing
67
- /financial-report-analyst GOOGL --compare-prior
68
- ```
69
-
70
- ### Retrieving the filing — the keyless EDGAR path
71
-
72
- When the user names a ticker instead of pasting text, this skill still fetches nothing by itself. Get the primary document from SEC EDGAR (free, no API key) **through the host's retrieval path — delegate it in a role-split host** — and mark `Retrieval: delegated retrieval`:
73
-
74
- 1. **Ticker → CIK:** `https://www.sec.gov/files/company_tickers.json` — match `ticker` (`BRK-B` for `BRK.B`), zero-pad `cik_str` to 10 digits.
75
- 2. **Filings index:** `https://data.sec.gov/submissions/CIK##########.json` — in `filings.recent`, the arrays `form` · `filingDate` · `reportDate` · `accessionNumber` · `primaryDocument` line up by index. Pick the newest row whose `form` is the one asked for: `10-K` (annual; `20-F` for foreign private issuers), `10-Q` (quarterly; `6-K` for foreign issuers), `8-K` (earnings release is usually Exhibit 99.1 in the filing folder), `DEF 14A` (proxy).
76
- 3. **Document:** `https://www.sec.gov/Archives/edgar/data/<CIK without leading zeros>/<accessionNumber without dashes>/<primaryDocument>` — the full filing as HTML. The folder's `<accessionNumber>-index.htm` lists every exhibit.
77
- 4. **Statement facts (to cross-check Item 8):** `https://data.sec.gov/api/xbrl/companyfacts/CIK##########.json`.
78
-
79
- Identify yourself with a `User-Agent` header (`Name email`) and stay under 10 requests per second. For `--compare-prior`, take the second-newest row of the same form. Cite accession number and filing date in the `Data & Sources` header.
80
-
81
- Only where the host has no retrieval path at all, ask the user to paste the sections and mark `Retrieval: pasted by user` — the repository's helper scripts are not part of this plugin and are never run from here. If neither is available, the figures stay missing: report the gap under the ⚠️ warning instead of lowering confidence on an estimate.
82
-
83
- ---
84
-
85
- ## Step-by-Step Analysis Framework
86
-
87
- ### Phase 1: Document Orientation
88
-
89
- Before diving into numbers, understand what kind of document this is and what period it covers:
90
-
91
- - **Filing Type**: 10-K (annual), 10-Q (quarterly), 8-K (material event), DEF 14A (proxy), S-1 (IPO)
92
- - **Fiscal Period**: Year-end or quarter-end date, fiscal year convention
93
- - **Auditor**: External auditor name and audit opinion type (unqualified, qualified, adverse, disclaimer)
94
- - **Auditor Change**: Any change in auditor is a major red flag — investigate immediately
95
- - **Filing Date**: Note if filed late (extension requests = warning signal)
96
- - **Restatements**: Any prior period restatements disclosed in current filing
97
-
98
- ---
99
-
100
- ### Phase 2: Management Discussion & Analysis (MD&A) Deep Read
101
-
102
- The MD&A is management's own narrative explanation of results. Read it critically — management has incentives to highlight positives and minimize negatives.
103
-
104
- **2.1 Revenue Analysis**
105
-
106
- Extract and analyze from MD&A:
107
-
108
- ```
109
- Revenue Breakdown Table:
110
- Segment/Product Line Current Period Prior Period YoY Change % Commentary
111
- ─────────────────────────────────────────────────────────────────────────────────────
112
- [Segment 1]
113
- [Segment 2]
114
- [Geographic: Americas]
115
- [Geographic: EMEA]
116
- [Geographic: APAC]
117
- ─────────────────────────────────────────────────────────────────────────────────────
118
- Total Revenue
119
- ```
120
-
121
- Key questions to answer from MD&A:
122
- - What does management cite as the primary growth drivers? Are these sustainable or one-time?
123
- - Is growth organic (volume/price) or inorganic (acquisitions)? Separate these explicitly.
124
- - What is the mix shift between high-margin and low-margin products/services?
125
- - Is management guiding to acceleration or deceleration? Are they vague or specific?
126
- - What is the backlog, remaining performance obligations (RPO), or deferred revenue trend?
127
-
128
- **2.2 Margin Analysis**
129
-
130
- ```
131
- Margin Trend Table:
132
- Metric Current Period Prior Period QoQ or YoY Explanation from MD&A
133
- ──────────────────────────────────────────────────────────────────────────────────────
134
- Gross Margin %
135
- Operating Margin %
136
- Net Margin %
137
- Adjusted EBITDA % (if disclosed)
138
- FCF Margin % (Operating CF - Capex)
139
- ──────────────────────────────────────────────────────────────────────────────────────
140
- ```
141
-
142
- Red flags in margin discussion:
143
- - Non-GAAP exclusions growing faster than GAAP expenses (SBC, restructuring)
144
- - Gross margin compression attributed to "product mix" without specifics
145
- - COGS increases described only in absolute terms, not as % of revenue
146
- - Operating leverage claims not reflected in actual operating margin expansion
147
-
148
- **2.3 Liquidity and Capital Resources**
149
-
150
- From the Liquidity section of MD&A, extract:
151
- - Cash and equivalents position (end of period)
152
- - Revolving credit facility (drawn / undrawn capacity)
153
- - Upcoming debt maturities (12-month and 3-year look-ahead)
154
- - Operating cash flow generated in period
155
- - Free cash flow (OCF minus capex)
156
- - Capital allocation priorities stated by management
157
- - Share repurchase authorization remaining
158
- - Dividend policy changes
159
-
160
- **2.4 Forward-Looking Statements Analysis**
161
-
162
- Catalog management's specific guidance language:
163
-
164
- ```
165
- Guidance Item Specific Language Used Strength (Specific/Vague/Hedged)
166
- ────────────────────────────────────────────────────────────────────────────────────
167
- Revenue Guidance
168
- Margin Guidance
169
- Capex Guidance
170
- Hiring/Headcount
171
- Product Launch Timing
172
- ────────────────────────────────────────────────────────────────────────────────────
173
- ```
174
-
175
- Flag: When management shifts from specific numerical guidance to directional language ("we expect continued growth"), this is a meaningful signal of reduced confidence.
176
-
177
- ---
178
-
179
- ### Phase 3: Financial Statement Deep Dive
180
-
181
- **3.1 Income Statement Quality Assessment**
182
-
183
- ```
184
- Line Item Analysis:
185
- Current Prior Change Quality Note
186
- Revenue $ $ %
187
- COGS $ $ %
188
- Gross Profit $ %GP
189
- R&D $ %Rev
190
- S&M $ %Rev
191
- G&A $ %Rev
192
- Operating Income $ %OM
193
- Interest Expense $ $
194
- Tax Rate % %
195
- Net Income (GAAP) $
196
- EPS (GAAP) $
197
- Non-GAAP EPS $ Reconciliation items: ___
198
- ```
199
-
200
- Quality checks:
201
- - **Revenue recognition policy**: Has it changed? Check footnotes for ASC 606 adoption details
202
- - **Channel stuffing signals**: Receivables growing faster than revenue (days sales outstanding expanding)
203
- - **Deferred revenue**: Growing (positive — customers paying ahead) or shrinking (negative)
204
- - **Tax rate**: Unusually low tax rate often driven by one-time benefits; normalize for comparison
205
-
206
- **3.2 Balance Sheet Analysis**
207
-
208
- ```
209
- Balance Sheet Health Check:
210
- Asset Quality:
211
- Cash & Equivalents: $___ (% of total assets)
212
- Accounts Receivable: $___ DSO: ___ days (vs. prior: ___)
213
- Inventory: $___ DIO: ___ days (vs. prior: ___)
214
- Goodwill & Intangibles: $___ (% of total assets) — impairment risk?
215
- Other Long-Term Assets: $___
216
-
217
- Liability Structure:
218
- Short-Term Debt: $___ (due within 12 months)
219
- Long-Term Debt: $___
220
- Total Debt: $___
221
- Net Debt/(Cash): $___
222
- Interest Coverage Ratio: ___x (EBIT / Interest Expense)
223
- Debt/EBITDA: ___x
224
-
225
- Equity Quality:
226
- Retained Earnings Trend: Growing / Declining / Negative
227
- Treasury Stock: $___ (buyback history)
228
- AOCI: $___ (pension obligations, FX hedges)
229
- ```
230
-
231
- Balance sheet red flags:
232
- - Goodwill > 30% of total assets without clear acquisition rationale
233
- - Accounts receivable growing 2x+ faster than revenue (aggressive recognition)
234
- - Inventory build in a demand-softening environment
235
- - Off-balance sheet operating lease obligations (check footnotes — ASC 842)
236
- - Underfunded pension liabilities buried in AOCI
237
-
238
- **3.3 Cash Flow Statement — The Truth Teller**
239
-
240
- The cash flow statement is the hardest to manipulate. Always reconcile GAAP net income to operating cash flow:
241
-
242
- ```
243
- Cash Flow Quality Analysis:
244
- Operating Cash Flow: $___
245
- Less: Capex: $___
246
- Free Cash Flow: $___ FCF Margin: __%
247
- FCF Conversion Rate: ___ (FCF / Net Income — should be >80% for quality businesses)
248
-
249
- Working Capital Changes:
250
- AR Change (use/source): $___
251
- Inventory Change: $___
252
- AP Change: $___
253
- Deferred Revenue Change: $___
254
- Net Working Capital Impact: $___
255
-
256
- SBC Add-Back: $___ (% of Revenue — >5% is dilutive)
257
- D&A Add-Back: $___ (% of Revenue — maintenance capex proxy)
258
- ```
259
-
260
- Cash flow quality flags:
261
- - FCF significantly below net income (earnings quality problem)
262
- - Large working capital builds consuming cash (inventory/AR growth)
263
- - SBC >5% of revenue — real dilution not reflected in GAAP net income
264
- - Capex below depreciation for multiple years (under-investment in assets)
265
-
266
- ---
267
-
268
- ### Phase 4: Risk Factors Analysis
269
-
270
- The Risk Factors section (Item 1A in 10-K) is legally required to disclose material risks. Read for:
271
-
272
- **4.1 New vs. Removed Risk Factors**
273
-
274
- Compare current filing's risk factors against the prior period:
275
-
276
- ```
277
- Risk Factor Changes:
278
- NEW Risks Added (first appearance):
279
- 1. [Risk title] — [Category: Business/Regulatory/Macro/Competition/Cyber/Legal]
280
- 2. ...
281
-
282
- REMOVED Risks (previously disclosed, now gone):
283
- 1. [What was removed] — [Why might this be significant?]
284
-
285
- ELEVATED Risks (same risk, but expanded disclosure or moved higher in list):
286
- 1. [Risk title] — [What changed in the language]
287
- ```
288
-
289
- Risk categories to flag as highest priority:
290
- - **Regulatory/Legal**: New government investigations, pending litigation, regulatory changes
291
- - **Customer Concentration**: Single customer >10% of revenue disclosed
292
- - **Technology/Competition**: Specific competitor named as existential threat
293
- - **Going Concern**: Doubt about ability to continue as a going concern (immediate red flag)
294
- - **Debt Covenant**: Risk of violating debt covenants disclosed
295
- - **Cybersecurity**: New material cyber incident disclosures (Item 1.05 of 8-K)
296
-
297
- **4.2 Litigation and Legal Proceedings**
298
-
299
- From footnotes and Item 3 (Legal Proceedings):
300
- - Active lawsuits with >$X million exposure
301
- - SEC or DOJ investigations
302
- - Tax disputes and uncertain tax positions
303
- - Environmental liabilities
304
- - Patent litigation (key for tech and pharma)
305
-
306
- ---
307
-
308
- ### Phase 5: Accounting Policy and Footnote Analysis
309
-
310
- Footnotes contain what management would prefer investors not to focus on.
311
-
312
- **5.1 Critical Accounting Estimates**
313
-
314
- Management must disclose "critical accounting estimates" — areas where judgment most affects reported results:
315
-
316
- ```
317
- Critical Estimate Review:
318
- Revenue Recognition: [Policy and any changes]
319
- Goodwill Impairment: [Testing methodology, headroom]
320
- Stock-Based Comp: [Fair value models, assumptions]
321
- Deferred Tax Assets: [Valuation allowance — any new allowances = warning]
322
- Contingent Liabilities: [What is and isn't accrued]
323
- Pension/OPEB: [Return assumption, discount rate]
324
- ```
325
-
326
- **5.2 Related Party Transactions**
327
-
328
- Any transactions between the company and executives, board members, or major shareholders. These require heightened scrutiny for potential conflicts of interest.
329
-
330
- **5.3 Segment Reporting**
331
-
332
- When companies add or remove reporting segments, investigate:
333
- - Was a previously disclosed segment merged with another? (Often hides underperformance)
334
- - Were goodwill allocations shifted between segments? (Can delay impairment)
335
- - New segment disclosures can reveal previously hidden growth drivers
336
-
337
- ---
338
-
339
- ### Phase 6: Management Tone and Language Analysis
340
-
341
- Apply natural language analysis to management's own words:
342
-
343
- **6.1 Tone Scoring**
344
-
345
- Rate management's tone across key sections:
346
-
347
- ```
348
- Tone Assessment:
349
- Section Tone Score (1=Very Negative → 5=Very Positive) Key Language
350
- ──────────────────────────────────────────────────────────────────────────────────
351
- MD&A Overview
352
- Revenue Discussion
353
- Margin Discussion
354
- Guidance Language
355
- Risk Factors Framing
356
- CEO Letter (if present)
357
- ──────────────────────────────────────────────────────────────────────────────────
358
- Overall Tone: [Score] / 5
359
- Change vs. Prior: More Positive / Same / More Negative
360
- ```
361
-
362
- **6.2 Hedging Language Flags**
363
-
364
- Flag specific hedging phrases that indicate uncertainty:
365
- - "We believe" / "we expect" / "we anticipate" — standard forward-looking
366
- - "We cannot assure" / "there can be no assurance" — heightened uncertainty
367
- - "Significant uncertainty" / "material uncertainty" — near-crisis language
368
- - Passive voice for negative news ("challenges were experienced") vs. active voice for positives
369
- - Increasing use of "headwinds," "challenging environment," "softness"
370
-
371
- **6.3 Management Credibility Tracking**
372
-
373
- ```
374
- Guidance Accuracy Scorecard (prior 4 quarters):
375
- Period Revenue Guidance Actual Beat/Miss Margin Guidance Actual Beat/Miss
376
- Q-4
377
- Q-3
378
- Q-2
379
- Q-1
380
- ──────────────────────────────────────────────────────────────────────────────────────────
381
- Batting Average: ___ Beat Rate: ___ Avg. Miss: ___
382
- ```
383
-
384
- ---
385
-
386
- ### Phase 7: Year-over-Year Comparison (for Quarterly Reports)
387
-
388
- For 10-Q analysis, compare against the same quarter prior year AND the sequential prior quarter:
389
-
390
- ```
391
- YoY and Sequential Comparison:
392
- Metric Current Q Prior Q (seq) Prior Year Q YoY % QoQ %
393
- Revenue
394
- Gross Margin
395
- Operating Income
396
- EPS (GAAP)
397
- FCF
398
- ```
399
-
400
- Identify if trends are:
401
- - Accelerating (sequential improvement + YoY beats)
402
- - Stable (sequential flat, YoY in-line)
403
- - Decelerating (sequential miss, YoY still positive)
404
- - Deteriorating (both sequential and YoY misses)
405
-
406
- ---
407
-
408
- ### Phase 8: Insider Activity (from Proxy/Form 4 Data)
409
-
410
- Cross-reference with available SEC Form 4 data around the filing date:
411
- - CEO/CFO buying on the open market (strong signal — insiders rarely buy for tax purposes)
412
- - Bulk insider selling at prices below historical averages (negative signal)
413
- - New 10b5-1 plan adoptions (scheduled selling — less informative than open market)
414
- - Executive departures disclosed in proxy or 8-K (CFO exits especially significant)
415
-
416
- ---
417
-
418
- ## Output Format
419
-
420
- ### Executive Summary (1-2 paragraphs)
421
-
422
- High-level verdict on the filing quality and key takeaways for investors. Address: Is this a better or worse filing than prior periods? What is the single most important thing an investor should take away?
423
-
424
- ### Financial Health Dashboard
425
-
426
- ```
427
- ┌─────────────────────────────────────────────────────────────────┐
428
- │ FINANCIAL REPORT ANALYSIS — [TICKER] [Filing Type] [Period] │
429
- ├────────────────────────┬────────────────────────────────────────┤
430
- │ Revenue Growth │ [%] YoY [Organic vs. Acquired] │
431
- │ Gross Margin │ [%] (vs. prior: [%] Δ [bps]) │
432
- │ Operating Margin │ [%] (vs. prior: [%] Δ [bps]) │
433
- │ FCF Margin │ [%] (FCF Conversion: [%]) │
434
- │ Net Debt / (Cash) │ $[M] (Debt/EBITDA: [x]) │
435
- │ DSO │ [days] (vs. prior: [days]) │
436
- │ Management Tone │ [Positive / Neutral / Cautious] │
437
- ├────────────────────────┼────────────────────────────────────────┤
438
- │ Filing Quality Score │ [Score] / 10 │
439
- │ Earnings Quality Score │ [Score] / 10 │
440
- │ Balance Sheet Score │ [Score] / 10 │
441
- └────────────────────────┴────────────────────────────────────────┘
442
- ```
443
-
444
- ### Key Insights (Bulleted)
445
-
446
- **Positives (Bullish Signals):**
447
- - [Specific insight with page/section reference from filing]
448
-
449
- **Negatives (Bearish Signals):**
450
- - [Specific insight with page/section reference from filing]
451
-
452
- **Neutral / Watch Items:**
453
- - [Items requiring monitoring but not yet actionable]
454
-
455
- ### Red Flags and Anomalies
456
-
457
- | # | Red Flag | Severity | Where Found | Implication |
458
- |---|----------|----------|-------------|-------------|
459
- | 1 | | HIGH/MED/LOW | | |
460
-
461
- ### Accounting Quality Score
462
-
463
- | Criterion | Score (0–3) | Notes |
464
- |-----------|-------------|-------|
465
- | Revenue recognition clarity | | |
466
- | Non-GAAP reconciliation quality | | |
467
- | FCF conversion rate | | |
468
- | Working capital trends | | |
469
- | Footnote transparency | | |
470
- | Auditor opinion | | |
471
- | Related party transactions | | |
472
- | **Total** | **/21** | |
473
-
474
- Score guide: 18–21 = High quality | 12–17 = Average | <12 = Scrutinize further
475
-
476
- ---
477
-
478
- ## Input Formats Accepted
479
-
480
- ```bash
481
- # Paste raw text from 10-K or 10-Q sections
482
- /financial-report-analyst [paste filing text]
483
-
484
- # Analyze specific section of a recent filing
485
- /financial-report-analyst AAPL 10-K --section md&a
486
- /financial-report-analyst MSFT 10-Q --section risk-factors
487
- /financial-report-analyst NVDA 10-K --section cash-flow
488
-
489
- # Full report analysis (all sections)
490
- /financial-report-analyst GOOGL 10-K --full
491
-
492
- # Compare current vs prior filing
493
- /financial-report-analyst META 10-K --compare-prior
494
-
495
- # Quick earnings press release analysis
496
- /financial-report-analyst AMZN --press-release [paste text]
497
-
498
- # Proxy statement analysis
499
- /financial-report-analyst TSLA --proxy
500
- ```
501
-
502
- ---
503
-
504
- ## Standard Signal Output
505
-
506
- All analysis concludes with this standardized block:
507
-
508
- ```
509
- ## Thesis Invalidation
510
-
511
- After delivering the analysis signal, specify what would reverse it:
512
-
513
- **If signal is BULLISH — thesis breaks if:**
514
- - auditor issues going concern warning OR material restatement announced
515
- - [One or two more triggers drawn from this analysis's own drivers, each with a threshold]
516
-
517
- **If signal is BEARISH — thesis breaks if:**
518
- - new auditor clears all concerns AND restatement resolved favorably
519
- - [One or two more triggers drawn from this analysis's own drivers, each with a threshold]
520
-
521
- **Re-run this analysis when:**
522
- - [ ] Next earnings release
523
- - [ ] Price moves ±15% from current level
524
- - [ ] 60 days have elapsed
525
- - [ ] Material news event (acquisition, leadership change, regulatory decision)
526
-
527
- ╔══════════════════════════════════════════════╗
528
- ║ INVESTMENT SIGNAL ║
529
- ╠══════════════════════════════════════════════╣
530
- ║ Signal: BULLISH / NEUTRAL / BEARISH ║
531
- ║ Confidence: HIGH / MEDIUM / LOW ║
532
- ║ Horizon: SHORT / MEDIUM / LONG-TERM ║
533
- ║ Score: X.X / 10 ║
534
- ╠══════════════════════════════════════════════╣
535
- ║ Action: BUY / HOLD / SELL ║
536
- ║ Conviction: STRONG / MODERATE / WEAK ║
537
- ╚══════════════════════════════════════════════╝
538
- ```
539
-
540
- Score Guide: 8.0–10.0 Strongly Bullish | 6.0–7.9 Moderately Bullish | 4.0–5.9 Neutral | 2.0–3.9 Moderately Bearish | 0.0–1.9 Strongly Bearish
541
- Confidence: HIGH (strong data, clear signals) | MEDIUM (mixed signals) | LOW (limited data, conflicting signals)
542
- Horizon: SHORT-TERM (1 week–3 months) | MEDIUM-TERM (3 months–1 year) | LONG-TERM (1+ years)
49
+ - `references/10-overview.md` — Overview; How to Use; Step-by-Step Analysis Framework
50
+ - `references/11-phase-3-financial-statement.md` — (continued) Step-by-Step Analysis Framework
51
+ - `references/12-phase-6-management-tone.md` — (continued) Step-by-Step Analysis Framework; Output Format; Input Formats Accepted; Standard Signal Output
52
+ - `references/13-thesis-invalidation.md` — Thesis Invalidation
543
53
 
544
- **Disclaimer:** Educational analysis only. Not financial advice.
54
+ Loading this file is not reading the skill: the steps, templates, and thresholds exist only
55
+ in the parts above. Say which parts you opened, name the ones you did not, and never report a
56
+ step or a template you have not read in this session.
@@ -0,0 +1,143 @@
1
+ # Overview
2
+
3
+ Part 1 of 4 for `financial-report-analyst` — Overview; How to Use; Step-by-Step Analysis Framework
4
+ See `SKILL.md` for what to read and when; this part is procedure, not routing.
5
+
6
+ ## Overview
7
+
8
+ Official filings are the primary source of truth for company analysis. Unlike financial data terminals (which aggregate selected metrics), the actual 10-K and 10-Q contain management's own words, full footnote disclosures, legal risk factors, and accounting policy choices that are invisible in summary data feeds. This skill teaches you to read between the lines of official documents and convert dense regulatory language into actionable investment insights.
9
+
10
+ ---
11
+
12
+ ## How to Use
13
+
14
+ Provide the report in one of these ways:
15
+
16
+ ```
17
+ # Paste report text directly
18
+ /financial-report-analyst [paste 10-K or 10-Q sections]
19
+
20
+ # Reference a specific ticker for the most recent filing
21
+ /financial-report-analyst AAPL 10-K
22
+
23
+ # Analyze a specific section
24
+ /financial-report-analyst MSFT 10-Q --section risk-factors
25
+
26
+ # Full deep-dive analysis
27
+ /financial-report-analyst NVDA 10-K --full
28
+
29
+ # Comparative: compare current vs prior period filing
30
+ /financial-report-analyst GOOGL --compare-prior
31
+ ```
32
+
33
+ ### Retrieving the filing — the keyless EDGAR path
34
+
35
+ When the user names a ticker instead of pasting text, this skill still fetches nothing by itself. Get the primary document from SEC EDGAR (free, no API key) **through the host's retrieval path — delegate it in a role-split host** — and mark `Retrieval: delegated retrieval`:
36
+
37
+ 1. **Ticker → CIK:** `https://www.sec.gov/files/company_tickers.json` — match `ticker` (`BRK-B` for `BRK.B`), zero-pad `cik_str` to 10 digits.
38
+ 2. **Filings index:** `https://data.sec.gov/submissions/CIK##########.json` — in `filings.recent`, the arrays `form` · `filingDate` · `reportDate` · `accessionNumber` · `primaryDocument` line up by index. Pick the newest row whose `form` is the one asked for: `10-K` (annual; `20-F` for foreign private issuers), `10-Q` (quarterly; `6-K` for foreign issuers), `8-K` (earnings release is usually Exhibit 99.1 in the filing folder), `DEF 14A` (proxy).
39
+ 3. **Document:** `https://www.sec.gov/Archives/edgar/data/<CIK without leading zeros>/<accessionNumber without dashes>/<primaryDocument>` — the full filing as HTML. The folder's `<accessionNumber>-index.htm` lists every exhibit.
40
+ 4. **Statement facts (to cross-check Item 8):** `https://data.sec.gov/api/xbrl/companyfacts/CIK##########.json`.
41
+
42
+ Identify yourself with a `User-Agent` header (`Name email`) and stay under 10 requests per second. For `--compare-prior`, take the second-newest row of the same form. Cite accession number and filing date in the `Data & Sources` header.
43
+
44
+ Only where the host has no retrieval path at all, ask the user to paste the sections and mark `Retrieval: pasted by user` — the repository's helper scripts are not part of this plugin and are never run from here. If neither is available, the figures stay missing: report the gap under the ⚠️ warning instead of lowering confidence on an estimate.
45
+
46
+ ---
47
+
48
+ ## Step-by-Step Analysis Framework
49
+
50
+ ### Phase 1: Document Orientation
51
+
52
+ Before diving into numbers, understand what kind of document this is and what period it covers:
53
+
54
+ - **Filing Type**: 10-K (annual), 10-Q (quarterly), 8-K (material event), DEF 14A (proxy), S-1 (IPO)
55
+ - **Fiscal Period**: Year-end or quarter-end date, fiscal year convention
56
+ - **Auditor**: External auditor name and audit opinion type (unqualified, qualified, adverse, disclaimer)
57
+ - **Auditor Change**: Any change in auditor is a major red flag — investigate immediately
58
+ - **Filing Date**: Note if filed late (extension requests = warning signal)
59
+ - **Restatements**: Any prior period restatements disclosed in current filing
60
+
61
+ ---
62
+
63
+ ### Phase 2: Management Discussion & Analysis (MD&A) Deep Read
64
+
65
+ The MD&A is management's own narrative explanation of results. Read it critically — management has incentives to highlight positives and minimize negatives.
66
+
67
+ **2.1 Revenue Analysis**
68
+
69
+ Extract and analyze from MD&A:
70
+
71
+ ```
72
+ Revenue Breakdown Table:
73
+ Segment/Product Line Current Period Prior Period YoY Change % Commentary
74
+ ─────────────────────────────────────────────────────────────────────────────────────
75
+ [Segment 1]
76
+ [Segment 2]
77
+ [Geographic: Americas]
78
+ [Geographic: EMEA]
79
+ [Geographic: APAC]
80
+ ─────────────────────────────────────────────────────────────────────────────────────
81
+ Total Revenue
82
+ ```
83
+
84
+ Key questions to answer from MD&A:
85
+ - What does management cite as the primary growth drivers? Are these sustainable or one-time?
86
+ - Is growth organic (volume/price) or inorganic (acquisitions)? Separate these explicitly.
87
+ - What is the mix shift between high-margin and low-margin products/services?
88
+ - Is management guiding to acceleration or deceleration? Are they vague or specific?
89
+ - What is the backlog, remaining performance obligations (RPO), or deferred revenue trend?
90
+
91
+ **2.2 Margin Analysis**
92
+
93
+ ```
94
+ Margin Trend Table:
95
+ Metric Current Period Prior Period QoQ or YoY Explanation from MD&A
96
+ ──────────────────────────────────────────────────────────────────────────────────────
97
+ Gross Margin %
98
+ Operating Margin %
99
+ Net Margin %
100
+ Adjusted EBITDA % (if disclosed)
101
+ FCF Margin % (Operating CF - Capex)
102
+ ──────────────────────────────────────────────────────────────────────────────────────
103
+ ```
104
+
105
+ Red flags in margin discussion:
106
+ - Non-GAAP exclusions growing faster than GAAP expenses (SBC, restructuring)
107
+ - Gross margin compression attributed to "product mix" without specifics
108
+ - COGS increases described only in absolute terms, not as % of revenue
109
+ - Operating leverage claims not reflected in actual operating margin expansion
110
+
111
+ **2.3 Liquidity and Capital Resources**
112
+
113
+ From the Liquidity section of MD&A, extract:
114
+ - Cash and equivalents position (end of period)
115
+ - Revolving credit facility (drawn / undrawn capacity)
116
+ - Upcoming debt maturities (12-month and 3-year look-ahead)
117
+ - Operating cash flow generated in period
118
+ - Free cash flow (OCF minus capex)
119
+ - Capital allocation priorities stated by management
120
+ - Share repurchase authorization remaining
121
+ - Dividend policy changes
122
+
123
+ **2.4 Forward-Looking Statements Analysis**
124
+
125
+ Catalog management's specific guidance language:
126
+
127
+ ```
128
+ Guidance Item Specific Language Used Strength (Specific/Vague/Hedged)
129
+ ────────────────────────────────────────────────────────────────────────────────────
130
+ Revenue Guidance
131
+ Margin Guidance
132
+ Capex Guidance
133
+ Hiring/Headcount
134
+ Product Launch Timing
135
+ ────────────────────────────────────────────────────────────────────────────────────
136
+ ```
137
+
138
+ Flag: When management shifts from specific numerical guidance to directional language ("we expect continued growth"), this is a meaningful signal of reduced confidence.
139
+
140
+ ---
141
+
142
+
143
+ This section is not finished here: `Step-by-Step Analysis Framework` continues in `references/11-phase-3-financial-statement.md`.