@v587d/capital-generation 2.7.12 → 2.8.1

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 (157) hide show
  1. package/CHANGELOG.md +66 -0
  2. package/README.md +10 -6
  3. package/THIRD_PARTY_NOTICES.md +6 -1
  4. package/chart-ui/package.json +1 -1
  5. package/config/index.js +1 -0
  6. package/config/package.json +1 -1
  7. package/lib/agents/bash-guard.d.ts +22 -17
  8. package/lib/agents/bash-guard.js +32 -28
  9. package/lib/agents/root-tool-policy.d.ts +29 -3
  10. package/lib/agents/root-tool-policy.js +100 -14
  11. package/lib/data-collector/dataset-tools.js +9 -0
  12. package/lib/data-collector/tools.js +17 -5
  13. package/lib/index.d.ts +4 -0
  14. package/lib/index.js +27 -8
  15. package/lib/sources/ftshare-rest.d.ts +54 -0
  16. package/lib/sources/ftshare-rest.js +2363 -0
  17. package/lib/time/tools.js +24 -0
  18. package/lib/web-retriever/local-fetch.d.ts +1 -1
  19. package/lib/web-retriever/local-fetch.js +1 -1
  20. package/lib/web-retriever/wind-client.d.ts +1 -1
  21. package/lib/web-retriever/wind-client.js +1 -1
  22. package/package.json +1 -1
  23. package/preset/capital-generation/README.md +22 -15
  24. package/preset/capital-generation/agent.patch.yml +14 -1
  25. package/preset/capital-generation/skills/capital-data-protocol/SKILL.md +4 -1
  26. package/selected-skills/InvestSkill/UPSTREAM.md +17 -0
  27. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/SKILL.md +10 -296
  28. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/references/10-retrieving-the-filing.md +130 -0
  29. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/references/11-key-metrics-table.md +129 -0
  30. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/references/12-language-mode.md +60 -0
  31. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/bear-case/SKILL.md +5 -3
  32. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/SKILL.md +10 -284
  33. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/references/10-persona.md +113 -0
  34. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/references/11-section-c-company-specific.md +108 -0
  35. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/references/12-section-f-90-day.md +85 -0
  36. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/SKILL.md +11 -433
  37. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/10-overview.md +82 -0
  38. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/11-porter-s-five-forces.md +137 -0
  39. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/12-innovation-disruption-assessment.md +112 -0
  40. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/13-input-formats.md +130 -0
  41. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/SKILL.md +12 -639
  42. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/10-analysis-framework.md +138 -0
  43. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/11-dividend-history-and-reliability.md +131 -0
  44. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/12-share-buyback-analysis.md +125 -0
  45. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/13-fcf-deployment-scorecard.md +133 -0
  46. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/14-output.md +149 -0
  47. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/SKILL.md +10 -411
  48. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/references/10-analysis-framework.md +194 -0
  49. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/references/11-data-sources.md +196 -0
  50. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/references/12-thesis-invalidation.md +43 -0
  51. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/SKILL.md +11 -234
  52. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/10-overview.md +86 -0
  53. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/11-phase-4-the-implied.md +60 -0
  54. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/12-output-format.md +83 -0
  55. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/13-standard-signal-output.md +34 -0
  56. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/SKILL.md +10 -304
  57. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/references/10-key-economic-indicators.md +98 -0
  58. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/references/11-credit-market-indicators.md +114 -0
  59. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/references/12-recession-probability-scoring.md +114 -0
  60. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/SKILL.md +11 -236
  61. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/10-overview.md +83 -0
  62. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/11-phase-5-overlap-with.md +69 -0
  63. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/12-output-format.md +79 -0
  64. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/13-standard-signal-output.md +34 -0
  65. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/SKILL.md +11 -243
  66. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/10-overview.md +61 -0
  67. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/11-phase-2-source-hierarchy.md +54 -0
  68. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/12-phase-5-consistency.md +90 -0
  69. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/13-notes.md +68 -0
  70. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/SKILL.md +11 -499
  71. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/10-overview.md +143 -0
  72. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/11-phase-3-financial-statement.md +167 -0
  73. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/12-phase-6-management-tone.md +176 -0
  74. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/13-thesis-invalidation.md +43 -0
  75. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/SKILL.md +10 -291
  76. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/references/10-overview.md +117 -0
  77. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/references/11-step-3-position-locator.md +112 -0
  78. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/references/12-visualization-support.md +84 -0
  79. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/SKILL.md +10 -457
  80. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/references/10-analysis-framework.md +185 -0
  81. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/references/11-pattern-recognition.md +175 -0
  82. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/references/12-interpretation-guidelines.md +120 -0
  83. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/SKILL.md +11 -503
  84. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/10-analysis-framework.md +132 -0
  85. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/11-ownership-concentration-analysis.md +166 -0
  86. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/12-red-flags-warning-signs.md +192 -0
  87. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/13-thesis-invalidation.md +43 -0
  88. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/SKILL.md +11 -264
  89. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/10-overview.md +63 -0
  90. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/11-phase-2-explanation-card.md +108 -0
  91. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/12-output-format.md +88 -0
  92. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/13-standard-signal-output.md +34 -0
  93. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/SKILL.md +11 -448
  94. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/10-analysis-framework.md +109 -0
  95. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/11-implied-volatility-iv-analysis.md +102 -0
  96. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/12-earnings-play-analysis.md +109 -0
  97. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/13-data-sources.md +159 -0
  98. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/SKILL.md +11 -435
  99. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/10-phase-1-portfolio-snapshot.md +124 -0
  100. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/11-phase-6-correlation-diversification.md +124 -0
  101. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/12-phase-9-rebalancing-decision.md +153 -0
  102. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/13-data-verification.md +62 -0
  103. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/SKILL.md +11 -372
  104. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/10-overview.md +102 -0
  105. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/11-phase-3-the-trim.md +88 -0
  106. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/12-phase-6-the-thesis.md +105 -0
  107. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/13-input-formats.md +105 -0
  108. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/SKILL.md +10 -250
  109. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/references/10-overview.md +92 -0
  110. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/references/11-phase-4-correlation-spike.md +116 -0
  111. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/references/12-notes.md +65 -0
  112. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/SKILL.md +11 -381
  113. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/10-sector-overview.md +123 -0
  114. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/11-sector-correlation-matrix.md +90 -0
  115. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/12-peer-benchmarking-within-sector.md +92 -0
  116. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/13-consumer-staples.md +105 -0
  117. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/SKILL.md +10 -352
  118. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/references/10-analysis-framework.md +110 -0
  119. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/references/11-bearish-thesis-evaluation.md +118 -0
  120. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/references/12-data-sources.md +148 -0
  121. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/SKILL.md +16 -603
  122. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/10-analysis-components.md +122 -0
  123. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/11-dupont-decomposition.md +121 -0
  124. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/12-quality-scoring-framework.md +115 -0
  125. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/13-dcf-framework.md +113 -0
  126. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/14-analyst-consensus-tracking.md +127 -0
  127. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/15-thesis-invalidation.md +43 -0
  128. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-screener/SKILL.md +5 -3
  129. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/SKILL.md +12 -595
  130. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/10-overview.md +133 -0
  131. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/11-method-2-comparable-company.md +127 -0
  132. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/12-football-field-summary-valuation.md +140 -0
  133. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/13-terminal-value-two-methods.md +121 -0
  134. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/14-when-dcf-is.md +110 -0
  135. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/SKILL.md +12 -304
  136. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/10-overview.md +73 -0
  137. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/11-phase-3-dividends-qualified.md +67 -0
  138. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/12-framework-non-us-module.md +61 -0
  139. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/13-scoring-tax-efficiency-score.md +83 -0
  140. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/14-thesis-invalidation.md +55 -0
  141. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/SKILL.md +16 -612
  142. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/10-chart-pattern-analysis.md +172 -0
  143. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/11-chart-visualization-support.md +181 -0
  144. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/12-multi-timeframe-analysis-mtf.md +95 -0
  145. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/13-advanced-indicators-ichimoku-cloud.md +61 -0
  146. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/14-options-flow-integration.md +95 -0
  147. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/15-thesis-invalidation.md +45 -0
  148. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/SKILL.md +10 -274
  149. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/references/10-overview.md +94 -0
  150. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/references/11-phase-5-the-pre.md +113 -0
  151. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/references/12-example.md +90 -0
  152. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-catalyst-calendar/SKILL.md +5 -3
  153. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-idea-generation/SKILL.md +5 -3
  154. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-sector-overview/SKILL.md +5 -3
  155. package/selected-skills/investment-skills/skills/buffett-investment-framework/SKILL.md +1 -1
  156. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/SKILL.md +5 -3
  157. package/watchlist/package.json +1 -1
@@ -0,0 +1,167 @@
1
+ # Step-by-Step Analysis Framework(continued)
2
+
3
+ Part 2 of 4 for `financial-report-analyst` — Step-by-Step Analysis Framework
4
+ See `SKILL.md` for what to read and when; this part is procedure, not routing.
5
+
6
+ ### Phase 3: Financial Statement Deep Dive
7
+
8
+ **3.1 Income Statement Quality Assessment**
9
+
10
+ ```
11
+ Line Item Analysis:
12
+ Current Prior Change Quality Note
13
+ Revenue $ $ %
14
+ COGS $ $ %
15
+ Gross Profit $ %GP
16
+ R&D $ %Rev
17
+ S&M $ %Rev
18
+ G&A $ %Rev
19
+ Operating Income $ %OM
20
+ Interest Expense $ $
21
+ Tax Rate % %
22
+ Net Income (GAAP) $
23
+ EPS (GAAP) $
24
+ Non-GAAP EPS $ Reconciliation items: ___
25
+ ```
26
+
27
+ Quality checks:
28
+ - **Revenue recognition policy**: Has it changed? Check footnotes for ASC 606 adoption details
29
+ - **Channel stuffing signals**: Receivables growing faster than revenue (days sales outstanding expanding)
30
+ - **Deferred revenue**: Growing (positive — customers paying ahead) or shrinking (negative)
31
+ - **Tax rate**: Unusually low tax rate often driven by one-time benefits; normalize for comparison
32
+
33
+ **3.2 Balance Sheet Analysis**
34
+
35
+ ```
36
+ Balance Sheet Health Check:
37
+ Asset Quality:
38
+ Cash & Equivalents: $___ (% of total assets)
39
+ Accounts Receivable: $___ DSO: ___ days (vs. prior: ___)
40
+ Inventory: $___ DIO: ___ days (vs. prior: ___)
41
+ Goodwill & Intangibles: $___ (% of total assets) — impairment risk?
42
+ Other Long-Term Assets: $___
43
+
44
+ Liability Structure:
45
+ Short-Term Debt: $___ (due within 12 months)
46
+ Long-Term Debt: $___
47
+ Total Debt: $___
48
+ Net Debt/(Cash): $___
49
+ Interest Coverage Ratio: ___x (EBIT / Interest Expense)
50
+ Debt/EBITDA: ___x
51
+
52
+ Equity Quality:
53
+ Retained Earnings Trend: Growing / Declining / Negative
54
+ Treasury Stock: $___ (buyback history)
55
+ AOCI: $___ (pension obligations, FX hedges)
56
+ ```
57
+
58
+ Balance sheet red flags:
59
+ - Goodwill > 30% of total assets without clear acquisition rationale
60
+ - Accounts receivable growing 2x+ faster than revenue (aggressive recognition)
61
+ - Inventory build in a demand-softening environment
62
+ - Off-balance sheet operating lease obligations (check footnotes — ASC 842)
63
+ - Underfunded pension liabilities buried in AOCI
64
+
65
+ **3.3 Cash Flow Statement — The Truth Teller**
66
+
67
+ The cash flow statement is the hardest to manipulate. Always reconcile GAAP net income to operating cash flow:
68
+
69
+ ```
70
+ Cash Flow Quality Analysis:
71
+ Operating Cash Flow: $___
72
+ Less: Capex: $___
73
+ Free Cash Flow: $___ FCF Margin: __%
74
+ FCF Conversion Rate: ___ (FCF / Net Income — should be >80% for quality businesses)
75
+
76
+ Working Capital Changes:
77
+ AR Change (use/source): $___
78
+ Inventory Change: $___
79
+ AP Change: $___
80
+ Deferred Revenue Change: $___
81
+ Net Working Capital Impact: $___
82
+
83
+ SBC Add-Back: $___ (% of Revenue — >5% is dilutive)
84
+ D&A Add-Back: $___ (% of Revenue — maintenance capex proxy)
85
+ ```
86
+
87
+ Cash flow quality flags:
88
+ - FCF significantly below net income (earnings quality problem)
89
+ - Large working capital builds consuming cash (inventory/AR growth)
90
+ - SBC >5% of revenue — real dilution not reflected in GAAP net income
91
+ - Capex below depreciation for multiple years (under-investment in assets)
92
+
93
+ ---
94
+
95
+ ### Phase 4: Risk Factors Analysis
96
+
97
+ The Risk Factors section (Item 1A in 10-K) is legally required to disclose material risks. Read for:
98
+
99
+ **4.1 New vs. Removed Risk Factors**
100
+
101
+ Compare current filing's risk factors against the prior period:
102
+
103
+ ```
104
+ Risk Factor Changes:
105
+ NEW Risks Added (first appearance):
106
+ 1. [Risk title] — [Category: Business/Regulatory/Macro/Competition/Cyber/Legal]
107
+ 2. ...
108
+
109
+ REMOVED Risks (previously disclosed, now gone):
110
+ 1. [What was removed] — [Why might this be significant?]
111
+
112
+ ELEVATED Risks (same risk, but expanded disclosure or moved higher in list):
113
+ 1. [Risk title] — [What changed in the language]
114
+ ```
115
+
116
+ Risk categories to flag as highest priority:
117
+ - **Regulatory/Legal**: New government investigations, pending litigation, regulatory changes
118
+ - **Customer Concentration**: Single customer >10% of revenue disclosed
119
+ - **Technology/Competition**: Specific competitor named as existential threat
120
+ - **Going Concern**: Doubt about ability to continue as a going concern (immediate red flag)
121
+ - **Debt Covenant**: Risk of violating debt covenants disclosed
122
+ - **Cybersecurity**: New material cyber incident disclosures (Item 1.05 of 8-K)
123
+
124
+ **4.2 Litigation and Legal Proceedings**
125
+
126
+ From footnotes and Item 3 (Legal Proceedings):
127
+ - Active lawsuits with >$X million exposure
128
+ - SEC or DOJ investigations
129
+ - Tax disputes and uncertain tax positions
130
+ - Environmental liabilities
131
+ - Patent litigation (key for tech and pharma)
132
+
133
+ ---
134
+
135
+ ### Phase 5: Accounting Policy and Footnote Analysis
136
+
137
+ Footnotes contain what management would prefer investors not to focus on.
138
+
139
+ **5.1 Critical Accounting Estimates**
140
+
141
+ Management must disclose "critical accounting estimates" — areas where judgment most affects reported results:
142
+
143
+ ```
144
+ Critical Estimate Review:
145
+ Revenue Recognition: [Policy and any changes]
146
+ Goodwill Impairment: [Testing methodology, headroom]
147
+ Stock-Based Comp: [Fair value models, assumptions]
148
+ Deferred Tax Assets: [Valuation allowance — any new allowances = warning]
149
+ Contingent Liabilities: [What is and isn't accrued]
150
+ Pension/OPEB: [Return assumption, discount rate]
151
+ ```
152
+
153
+ **5.2 Related Party Transactions**
154
+
155
+ Any transactions between the company and executives, board members, or major shareholders. These require heightened scrutiny for potential conflicts of interest.
156
+
157
+ **5.3 Segment Reporting**
158
+
159
+ When companies add or remove reporting segments, investigate:
160
+ - Was a previously disclosed segment merged with another? (Often hides underperformance)
161
+ - Were goodwill allocations shifted between segments? (Can delay impairment)
162
+ - New segment disclosures can reveal previously hidden growth drivers
163
+
164
+ ---
165
+
166
+
167
+ This section is not finished here: `Step-by-Step Analysis Framework` continues in `references/12-phase-6-management-tone.md`.
@@ -0,0 +1,176 @@
1
+ # Step-by-Step Analysis Framework(continued)
2
+
3
+ Part 3 of 4 for `financial-report-analyst` — Step-by-Step Analysis Framework; Output Format; Input Formats Accepted; Standard Signal Output
4
+ See `SKILL.md` for what to read and when; this part is procedure, not routing.
5
+
6
+ ### Phase 6: Management Tone and Language Analysis
7
+
8
+ Apply natural language analysis to management's own words:
9
+
10
+ **6.1 Tone Scoring**
11
+
12
+ Rate management's tone across key sections:
13
+
14
+ ```
15
+ Tone Assessment:
16
+ Section Tone Score (1=Very Negative → 5=Very Positive) Key Language
17
+ ──────────────────────────────────────────────────────────────────────────────────
18
+ MD&A Overview
19
+ Revenue Discussion
20
+ Margin Discussion
21
+ Guidance Language
22
+ Risk Factors Framing
23
+ CEO Letter (if present)
24
+ ──────────────────────────────────────────────────────────────────────────────────
25
+ Overall Tone: [Score] / 5
26
+ Change vs. Prior: More Positive / Same / More Negative
27
+ ```
28
+
29
+ **6.2 Hedging Language Flags**
30
+
31
+ Flag specific hedging phrases that indicate uncertainty:
32
+ - "We believe" / "we expect" / "we anticipate" — standard forward-looking
33
+ - "We cannot assure" / "there can be no assurance" — heightened uncertainty
34
+ - "Significant uncertainty" / "material uncertainty" — near-crisis language
35
+ - Passive voice for negative news ("challenges were experienced") vs. active voice for positives
36
+ - Increasing use of "headwinds," "challenging environment," "softness"
37
+
38
+ **6.3 Management Credibility Tracking**
39
+
40
+ ```
41
+ Guidance Accuracy Scorecard (prior 4 quarters):
42
+ Period Revenue Guidance Actual Beat/Miss Margin Guidance Actual Beat/Miss
43
+ Q-4
44
+ Q-3
45
+ Q-2
46
+ Q-1
47
+ ──────────────────────────────────────────────────────────────────────────────────────────
48
+ Batting Average: ___ Beat Rate: ___ Avg. Miss: ___
49
+ ```
50
+
51
+ ---
52
+
53
+ ### Phase 7: Year-over-Year Comparison (for Quarterly Reports)
54
+
55
+ For 10-Q analysis, compare against the same quarter prior year AND the sequential prior quarter:
56
+
57
+ ```
58
+ YoY and Sequential Comparison:
59
+ Metric Current Q Prior Q (seq) Prior Year Q YoY % QoQ %
60
+ Revenue
61
+ Gross Margin
62
+ Operating Income
63
+ EPS (GAAP)
64
+ FCF
65
+ ```
66
+
67
+ Identify if trends are:
68
+ - Accelerating (sequential improvement + YoY beats)
69
+ - Stable (sequential flat, YoY in-line)
70
+ - Decelerating (sequential miss, YoY still positive)
71
+ - Deteriorating (both sequential and YoY misses)
72
+
73
+ ---
74
+
75
+ ### Phase 8: Insider Activity (from Proxy/Form 4 Data)
76
+
77
+ Cross-reference with available SEC Form 4 data around the filing date:
78
+ - CEO/CFO buying on the open market (strong signal — insiders rarely buy for tax purposes)
79
+ - Bulk insider selling at prices below historical averages (negative signal)
80
+ - New 10b5-1 plan adoptions (scheduled selling — less informative than open market)
81
+ - Executive departures disclosed in proxy or 8-K (CFO exits especially significant)
82
+
83
+ ---
84
+
85
+ ## Output Format
86
+
87
+ ### Executive Summary (1-2 paragraphs)
88
+
89
+ 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?
90
+
91
+ ### Financial Health Dashboard
92
+
93
+ ```
94
+ ┌─────────────────────────────────────────────────────────────────┐
95
+ │ FINANCIAL REPORT ANALYSIS — [TICKER] [Filing Type] [Period] │
96
+ ├────────────────────────┬────────────────────────────────────────┤
97
+ │ Revenue Growth │ [%] YoY [Organic vs. Acquired] │
98
+ │ Gross Margin │ [%] (vs. prior: [%] Δ [bps]) │
99
+ │ Operating Margin │ [%] (vs. prior: [%] Δ [bps]) │
100
+ │ FCF Margin │ [%] (FCF Conversion: [%]) │
101
+ │ Net Debt / (Cash) │ $[M] (Debt/EBITDA: [x]) │
102
+ │ DSO │ [days] (vs. prior: [days]) │
103
+ │ Management Tone │ [Positive / Neutral / Cautious] │
104
+ ├────────────────────────┼────────────────────────────────────────┤
105
+ │ Filing Quality Score │ [Score] / 10 │
106
+ │ Earnings Quality Score │ [Score] / 10 │
107
+ │ Balance Sheet Score │ [Score] / 10 │
108
+ └────────────────────────┴────────────────────────────────────────┘
109
+ ```
110
+
111
+ ### Key Insights (Bulleted)
112
+
113
+ **Positives (Bullish Signals):**
114
+ - [Specific insight with page/section reference from filing]
115
+
116
+ **Negatives (Bearish Signals):**
117
+ - [Specific insight with page/section reference from filing]
118
+
119
+ **Neutral / Watch Items:**
120
+ - [Items requiring monitoring but not yet actionable]
121
+
122
+ ### Red Flags and Anomalies
123
+
124
+ | # | Red Flag | Severity | Where Found | Implication |
125
+ |---|----------|----------|-------------|-------------|
126
+ | 1 | | HIGH/MED/LOW | | |
127
+
128
+ ### Accounting Quality Score
129
+
130
+ | Criterion | Score (0–3) | Notes |
131
+ |-----------|-------------|-------|
132
+ | Revenue recognition clarity | | |
133
+ | Non-GAAP reconciliation quality | | |
134
+ | FCF conversion rate | | |
135
+ | Working capital trends | | |
136
+ | Footnote transparency | | |
137
+ | Auditor opinion | | |
138
+ | Related party transactions | | |
139
+ | **Total** | **/21** | |
140
+
141
+ Score guide: 18–21 = High quality | 12–17 = Average | <12 = Scrutinize further
142
+
143
+ ---
144
+
145
+ ## Input Formats Accepted
146
+
147
+ ```bash
148
+ # Paste raw text from 10-K or 10-Q sections
149
+ /financial-report-analyst [paste filing text]
150
+
151
+ # Analyze specific section of a recent filing
152
+ /financial-report-analyst AAPL 10-K --section md&a
153
+ /financial-report-analyst MSFT 10-Q --section risk-factors
154
+ /financial-report-analyst NVDA 10-K --section cash-flow
155
+
156
+ # Full report analysis (all sections)
157
+ /financial-report-analyst GOOGL 10-K --full
158
+
159
+ # Compare current vs prior filing
160
+ /financial-report-analyst META 10-K --compare-prior
161
+
162
+ # Quick earnings press release analysis
163
+ /financial-report-analyst AMZN --press-release [paste text]
164
+
165
+ # Proxy statement analysis
166
+ /financial-report-analyst TSLA --proxy
167
+ ```
168
+
169
+ ---
170
+
171
+ ## Standard Signal Output
172
+
173
+ All analysis concludes with this standardized block:
174
+
175
+ ```
176
+
@@ -0,0 +1,43 @@
1
+ # Thesis Invalidation
2
+
3
+ Part 4 of 4 for `financial-report-analyst` — Thesis Invalidation
4
+ See `SKILL.md` for what to read and when; this part is procedure, not routing.
5
+
6
+ ## Thesis Invalidation
7
+
8
+ After delivering the analysis signal, specify what would reverse it:
9
+
10
+ **If signal is BULLISH — thesis breaks if:**
11
+ - auditor issues going concern warning OR material restatement announced
12
+ - [One or two more triggers drawn from this analysis's own drivers, each with a threshold]
13
+
14
+ **If signal is BEARISH — thesis breaks if:**
15
+ - new auditor clears all concerns AND restatement resolved favorably
16
+ - [One or two more triggers drawn from this analysis's own drivers, each with a threshold]
17
+
18
+ **Re-run this analysis when:**
19
+ - [ ] Next earnings release
20
+ - [ ] Price moves ±15% from current level
21
+ - [ ] 60 days have elapsed
22
+ - [ ] Material news event (acquisition, leadership change, regulatory decision)
23
+
24
+ ╔══════════════════════════════════════════════╗
25
+ ║ INVESTMENT SIGNAL ║
26
+ ╠══════════════════════════════════════════════╣
27
+ ║ Signal: BULLISH / NEUTRAL / BEARISH ║
28
+ ║ Confidence: HIGH / MEDIUM / LOW ║
29
+ ║ Horizon: SHORT / MEDIUM / LONG-TERM ║
30
+ ║ Score: X.X / 10 ║
31
+ ╠══════════════════════════════════════════════╣
32
+ ║ Action: BUY / HOLD / SELL ║
33
+ ║ Conviction: STRONG / MODERATE / WEAK ║
34
+ ╚══════════════════════════════════════════════╝
35
+ ```
36
+
37
+ 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
38
+ Confidence: HIGH (strong data, clear signals) | MEDIUM (mixed signals) | LOW (limited data, conflicting signals)
39
+ Horizon: SHORT-TERM (1 week–3 months) | MEDIUM-TERM (3 months–1 year) | LONG-TERM (1+ years)
40
+
41
+ **Disclaimer:** Educational analysis only. Not financial advice.
42
+
43
+