@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,175 @@
1
+ # Analysis Framework(continued)
2
+
3
+ Part 2 of 3 for `insider-trading` — Analysis Framework; Input Formats; Output
4
+ See `SKILL.md` for what to read and when; this part is procedure, not routing.
5
+
6
+ ### 8. Pattern Recognition
7
+
8
+ Identify meaningful patterns in trading activity:
9
+
10
+ **Bullish Patterns**
11
+ - Clustered buying by multiple insiders within 1-2 weeks
12
+ - First-time purchases by long-tenured executives
13
+ - Buying during period of stock weakness or negative sentiment
14
+ - Insiders increasing position size significantly (>25%)
15
+ - CEO making largest purchase of tenure
16
+
17
+ **Bearish Patterns**
18
+ - Clustered selling by multiple insiders
19
+ - CEO or CFO selling large percentage of holdings
20
+ - First-time sells by insiders who previously only bought
21
+ - Selling despite stock decline (urgency to exit)
22
+ - Executive departures followed by sales
23
+
24
+ **Neutral Patterns**
25
+ - Regular quarterly option exercises and sells
26
+ - Small percentage sells for diversification (<5% of holdings)
27
+ - Tax payment share forfeitures
28
+ - Routine 10b5-1 plan executions
29
+ - Gift transfers to family trusts
30
+
31
+ ### 9. Red Flags & Warning Signs
32
+
33
+ Identify concerning patterns:
34
+
35
+ **High-Severity Red Flags**
36
+ - CEO or CFO selling >50% of holdings
37
+ - Clustered selling before earnings miss or guidance cut
38
+ - Trading during blackout window
39
+ - Late Form 4 filing (>2 days) without explanation
40
+ - Pattern of selling before negative news
41
+
42
+ **Medium-Severity Red Flags**
43
+ - Increasing rate of insider selling
44
+ - Multiple executives selling simultaneously
45
+ - Selling despite recent insider buying by others
46
+ - Large sales shortly after option vesting
47
+ - Board member resignations followed by sales
48
+
49
+ **Context Matters**
50
+ - Insider selling is common and often benign
51
+ - Check for 10b5-1 plans (pre-arranged sales)
52
+ - Consider personal circumstances (divorce, estate planning)
53
+ - Look at historical patterns for that individual
54
+ - Assess whether selling is proportional to holdings
55
+
56
+ ### 10. Data Sources & Research Tools
57
+
58
+ Reference the following sources for insider trading data:
59
+
60
+ **Primary Source - SEC EDGAR**
61
+ - Form 4 filings: https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&type=4&company=[TICKER]
62
+ - Form 3 filings: Initial beneficial ownership
63
+ - Form 5 filings: Annual statements
64
+ - File within 2 business days of transaction (Form 4)
65
+
66
+ **Aggregator Websites**
67
+ - **OpenInsider.com**: Free, comprehensive database with filters
68
+ - Cluster analysis tools
69
+ - Screeners for significant transactions
70
+ - Historical data back 10+ years
71
+
72
+ - **SEC Form 4 Tracker**: Real-time Form 4 monitoring
73
+ - **Finviz Insider**: Basic insider data with visualizations
74
+ - **GuruFocus Insider**: Premium insider analysis
75
+
76
+ **Premium Tools**
77
+ - **Bloomberg Terminal**: Comprehensive insider data and analytics
78
+ - **FactSet**: Insider transaction database
79
+ - **S&P Capital IQ**: Detailed ownership and transaction data
80
+
81
+ **Key Data Points to Extract**
82
+ - Insider name and title
83
+ - Transaction date and filing date
84
+ - Shares bought/sold
85
+ - Price per share
86
+ - Shares owned after transaction
87
+ - Transaction code (P, S, M, etc.)
88
+ - Form 4 footnotes (10b5-1 plan indicator)
89
+
90
+ ## Input Formats
91
+
92
+ ### Format 1: Ticker Symbol
93
+ ```
94
+ User: /insider-trading AAPL
95
+
96
+ Claude retrieves recent Form 4 data from SEC EDGAR and analyzes
97
+ ```
98
+
99
+ ### Format 2: Specific Time Period
100
+ ```
101
+ User: /insider-trading TSLA --period 2024-Q4
102
+
103
+ Claude focuses on Q4 2024 insider transactions
104
+ ```
105
+
106
+ ### Format 3: Custom Data Paste
107
+ ```
108
+ User: /insider-trading --data
109
+
110
+ [Paste Form 4 data table or CSV from OpenInsider/SEC]
111
+
112
+ Claude analyzes provided data
113
+ ```
114
+
115
+ ## Output
116
+
117
+ Provide comprehensive insider trading analysis report with:
118
+
119
+ ### 1. Executive Summary
120
+ - **Overall Insider Sentiment**: Bullish / Neutral / Bearish
121
+ - **Confidence Level**: High / Medium / Low
122
+ - **Key Takeaways**: 3-5 most important findings
123
+ - **Investment Signal**: Buy / Hold / Sell indication
124
+ - **Time Period Analyzed**: [Date range]
125
+
126
+ ### 2. Transaction Summary Table
127
+ ```
128
+ Period: Last 6 Months
129
+ Total Transactions: [N]
130
+ Total Buy Transactions: [N] ($[Amount])
131
+ Total Sell Transactions: [N] ($[Amount])
132
+ Net Insider Activity: $[Amount]
133
+ Net Sentiment Score: [+0.XX or -0.XX]
134
+ ```
135
+
136
+ ### 3. Significant Transactions (Top 10)
137
+ Detailed table with context for each major transaction
138
+
139
+ ### 4. Insider Category Breakdown
140
+ Analysis by executive officers, board members, and major shareholders
141
+
142
+ ### 5. Ownership Trend Analysis
143
+ Current ownership % and historical trend (4 quarters)
144
+
145
+ ### 6. Timing & Pattern Analysis
146
+ - Stock price context during trading periods
147
+ - Identified bullish or bearish patterns
148
+ - Seasonal or cyclical factors
149
+
150
+ ### 7. Red Flags & Concerns
151
+ - List any identified warning signs
152
+ - Severity assessment
153
+ - Recommended monitoring
154
+
155
+ ### 8. Comparison to Peers
156
+ Brief comparison of insider sentiment vs. industry peers (if available)
157
+
158
+ ### 9. Historical Context
159
+ - How current activity compares to historical baseline
160
+ - Notable changes in behavior
161
+ - Track record of insider signals
162
+
163
+ ### 10. Investment Implications
164
+ - Overall assessment and confidence level
165
+ - Key bullish factors from insider activity
166
+ - Key bearish factors or concerns
167
+ - Recommended action
168
+ - Monitoring plan for future activity
169
+
170
+ ### 11. Data Sources Used
171
+ - SEC EDGAR filings referenced
172
+ - Date range of analysis
173
+ - Number of Form 4 filings reviewed
174
+
175
+
@@ -0,0 +1,120 @@
1
+ # Interpretation Guidelines
2
+
3
+ Part 3 of 3 for `insider-trading` — Interpretation Guidelines; Usage Examples; Integration Notes; Standard Signal Output; Thesis Invalidation
4
+ See `SKILL.md` for what to read and when; this part is procedure, not routing.
5
+
6
+ ## Interpretation Guidelines
7
+
8
+ ### When Insider Buying is STRONGLY Bullish
9
+ 1. Multiple insiders buying in 1-2 week period
10
+ 2. CEO making unusually large purchase
11
+ 3. Buying after significant stock decline (>20%)
12
+ 4. Insiders buying with personal cash (not option exercises)
13
+ 5. First-time buyers or return to buying after long gap
14
+
15
+ ### When Insider Buying is MODERATELY Bullish
16
+ 1. Single insider making meaningful purchase
17
+ 2. Regular accumulation pattern
18
+ 3. Buying at all-time highs (conviction in further growth)
19
+ 4. Board member purchases
20
+
21
+ ### When Insider Selling is LESS Concerning
22
+ 1. 10b5-1 pre-arranged plan sales
23
+ 2. Small percentage of holdings (<5%)
24
+ 3. Regular quarterly pattern
25
+ 4. Diversification after large stock appreciation
26
+ 5. Tax payments or estate planning
27
+
28
+ ### When Insider Selling is CONCERNING
29
+ 1. Clustered selling by multiple executives
30
+ 2. CEO/CFO selling >25% of holdings
31
+ 3. Selling despite stock decline
32
+ 4. No 10b5-1 plan indicated
33
+ 5. Selling shortly before negative news
34
+
35
+ ### Signal Reliability Factors
36
+ - **Sample size**: More insiders trading = stronger signal
37
+ - **Magnitude**: Larger $ amounts = stronger signal
38
+ - **Timing**: Unusual timing = stronger signal
39
+ - **Context**: Contrarian trades (buying weakness) = stronger signal
40
+ - **Track record**: Historically accurate insiders = stronger signal
41
+
42
+ ## Usage Examples
43
+
44
+ ### Example 1: Basic Analysis
45
+ ```
46
+ User: /insider-trading NVDA
47
+
48
+ Claude: Pulls the last 6 months of NVDA Form 4 filings and reports net
49
+ open-market buys vs. sells, separates 10b5-1 plan sales from discretionary
50
+ trades, flags clustered buying, and closes with the signal block.
51
+ ```
52
+
53
+ ### Example 2: Before Earnings
54
+ ```
55
+ User: /insider-trading AAPL --period "before-earnings"
56
+
57
+ Claude: Examines trading in the 30–60 days before the most recent earnings
58
+ release and states whether anything beyond scheduled 10b5-1 sales occurred.
59
+ ```
60
+
61
+ ### Example 3: Red Flag Detection
62
+ ```
63
+ User: /insider-trading ABC --focus red-flags
64
+
65
+ Claude: Checks each red-flag pattern above (large % of holdings sold,
66
+ clustered director exits, selling into a decline) and reports which fired,
67
+ with the filing dates that support each.
68
+ ```
69
+
70
+ ## Integration Notes
71
+
72
+ - Combine with /stock-eval for complete due diligence
73
+ - Use /institutional-ownership for full insider + institutional picture
74
+ - Feed analysis to /report-generator for visual charts of insider activity
75
+ - Best used monthly or after significant insider filing activity
76
+ - Particularly valuable when analyzing small-mid cap stocks (insiders have more edge)
77
+
78
+ ## Standard Signal Output
79
+
80
+ All analysis concludes with this standardized block:
81
+
82
+ ```
83
+ ## Thesis Invalidation
84
+
85
+ After delivering the analysis signal, specify what would reverse it:
86
+
87
+ **If signal is BULLISH — thesis breaks if:**
88
+ - 3+ insiders file Form 4 sells within a 30-day window OR CEO sells >5% of holdings
89
+ - [One or two more triggers drawn from this analysis's own drivers, each with a threshold]
90
+
91
+ **If signal is BEARISH — thesis breaks if:**
92
+ - CEO/CFO initiate new purchases >$1M within 30 days
93
+ - [One or two more triggers drawn from this analysis's own drivers, each with a threshold]
94
+
95
+ **Re-run this analysis when:**
96
+ - [ ] Next earnings release
97
+ - [ ] Price moves ±15% from current level
98
+ - [ ] 60 days have elapsed
99
+ - [ ] Material news event (acquisition, leadership change, regulatory decision)
100
+
101
+ ╔══════════════════════════════════════════════╗
102
+ ║ INVESTMENT SIGNAL ║
103
+ ╠══════════════════════════════════════════════╣
104
+ ║ Signal: BULLISH / NEUTRAL / BEARISH ║
105
+ ║ Confidence: HIGH / MEDIUM / LOW ║
106
+ ║ Horizon: SHORT / MEDIUM / LONG-TERM ║
107
+ ║ Score: X.X / 10 ║
108
+ ╠══════════════════════════════════════════════╣
109
+ ║ Action: BUY / HOLD / SELL ║
110
+ ║ Conviction: STRONG / MODERATE / WEAK ║
111
+ ╚══════════════════════════════════════════════╝
112
+ ```
113
+
114
+ **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
115
+ **Confidence**: HIGH (strong data, clear signals) | MEDIUM (mixed signals) | LOW (limited data, conflicting signals)
116
+ **Horizon**: SHORT-TERM (1 week–3 months) | MEDIUM-TERM (3 months–1 year) | LONG-TERM (1+ years)
117
+
118
+ **Disclaimer:** Educational analysis only. Not financial advice.
119
+
120
+