Skip to content
Back to search

skills

SkillWorks with Claude CodeGitHub

A collection of Claude skills for agentic financial research by Octagon

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/octagonai--skills/badge.svg)](/listings/octagonai--skills)

HTML

<a href="/listings/octagonai--skills"><img src="/api/listings/octagonai--skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx skills add OctagonAI/skills

<details> <summary>bun</summary>

bunx skills add OctagonAI/skills

</details>

<details> <summary>pnpm</summary>

pnpm dlx skills add OctagonAI/skills

</details>

<details> <summary>Claude Code</summary>

/plugin install <skill-name>

</details>

<details> <summary>Manual installation</summary>

Copy the skill folder to your Claude skills directory.

</details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 255 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Octagon Skills
  2. A collection of AI agent skills for financial data analysis powered by the [Octagon MCP](https://github.com/OctagonAI/octagon-mcp).
  3. ## Installation
  4. ```bash
  5. npx skills add OctagonAI/skills
  6. ```
  7. <details>
  8. <summary>bun</summary>
  9. ```bash
  10. bunx skills add OctagonAI/skills
  11. ```
  12. </details>
  13. <details>
  14. <summary>pnpm</summary>
  15. ```bash
  16. pnpm dlx skills add OctagonAI/skills
  17. ```
  18. </details>
  19. <details>
  20. <summary>Claude Code</summary>
  21. ```
  22. /plugin install <skill-name>
  23. ```
  24. </details>
  25. <details>
  26. <summary>Manual installation</summary>
  27. Copy the skill folder to your Claude skills directory.
  28. </details>
  29. ## Financial Metrics Analysis Skills
  30. | Skill | Category | Description |
  31. |-------|----------|-------------|
  32. | [financial-analyst-master](skills/financial-analyst-master/) | **Master** | Comprehensive equity research analyst skill that orchestrates all skills for full company analysis |
  33. | [income-statement](skills/income-statement/) | Financial Statements | Retrieve real-time income statement data (Revenue, Net Income, EPS Diluted) |
  34. | [balance-sheet](skills/balance-sheet/) | Financial Statements | Retrieve detailed balance sheet data (Assets, Liabilities, Equity, Net Debt) |
  35. | [cash-flow-statement](skills/cash-flow-statement/) | Financial Statements | Retrieve cash flow statement data (OCF, Investing, Financing, FCF, Cash Position) |
  36. | [financial-metrics-analysis](skills/financial-metrics-analysis/) | Growth Analysis | Analyze year-over-year growth in income statement items (Revenue, COGS, Gross Profit, Operating Income, Net Income) |
  37. | [income-statement-growth](skills/income-statement-growth/) | Growth Analysis | Retrieve YoY growth in Revenue, Gross Profit, Operating Income, Net Income, and EPS Diluted |
  38. | [balance-sheet-growth](skills/balance-sheet-growth/) | Growth Analysis | Retrieve YoY growth in Total Assets, Liabilities, Equity, Cash, and Inventories |
  39. | [cash-flow-growth](skills/cash-flow-growth/) | Growth Analysis | Retrieve YoY growth in Operating Cash Flow, Free Cash Flow, and Net Cash Flow |
  40. | [financial-growth](skills/financial-growth/) | Growth Analysis | Retrieve comprehensive YoY growth in Revenue, Gross Profit, Operating Income, Net Income, EPS, and FCF |
  41. | [revenue-product-segmentation](skills/revenue-product-segmentation/) | Segmentation | Retrieve revenue breakdown by product segment with concentration analysis |
  42. | [revenue-geographic-segmentation](skills/revenue-geographic-segmentation/) | Segmentation | Retrieve revenue breakdown by geographic segment with regional exposure |
  43. | [analyst-estimates](skills/analyst-estimates/) | Estimates & Ratings | Retrieve analyst Revenue and EPS estimates with consensus ranges |
  44. | [financial-health-scores](skills/financial-health-scores/) | Estimates & Ratings | Retrieve Altman Z-Score and Piotroski Score for financial health assessment |
  45. | [historical-financial-ratings](skills/historical-financial-ratings/) | Estimates & Ratings | Retrieve historical financial ratings and key metric scores (ROA, ROE, DCF, D/E) over time |
  46. | [ratings-snapshot](skills/ratings-snapshot/) | Estimates & Ratings | Retrieve current financial ratings overview for quick assessment |
  47. | [esg-ratings](skills/esg-ratings/) | ESG | Retrieve ESG ratings and scores including MSCI ratings, Sustainalytics risk, and industry rank |
  48. | [esg-benchmark-comparison](skills/esg-benchmark-comparison/) | ESG | Retrieve ESG benchmark comparison metrics by sector using MSCI, S&P, CDP frameworks |
  49. ## Earnings Call Analysis Skills
  50. | Skill | Category | Description |
  51. |-------|----------|-------------|
  52. | [earnings-analyst-master](skills/earnings-analyst-master/) | **Master** | Comprehensive earnings analyst skill that orchestrates all earnings skills for transcript analysis |
  53. | [earnings-call-insights](skills/earnings-call-insights/) | Guidance Analysis | Analyze earnings call transcripts to extract future guidance, strategic priorities, and management commentary |
  54. | [earnings-call-analysis](skills/earnings-call-analysis/) | Transcript Analysis | Analyze earnings call transcripts with follow-up questions and source citations |
  55. | [earnings-mgmt-comments](skills/earnings-mgmt-comments/) | Management Commentary | Extract management's commentary on specific topics with executive attribution |
  56. | [earnings-qa-analysis](skills/earnings-qa-analysis/) | Q&A Analysis | Analyze the Q&A section for strategic insights and analyst concerns |
  57. | [earnings-financial-guidance](skills/earnings-financial-guidance/) | Financial Guidance | Extract financial guidance and forward-looking statements with segment detail |
  58. | [earnings-analyst-questions](skills/earnings-analyst-questions/) | Analyst Questions | Identify key themes and concerns raised by analysts with attribution |
  59. | [earnings-conf-call-sentiment](skills/earnings-conf-call-sentiment/) | Sentiment Analysis | Analyze overall sentiment and tone of management during conference calls |
  60. | [earnings-revenue-guidance](skills/earnings-revenue-guidance/) | Revenue Guidance | Extract revenue guidance and growth projections with segment and currency breakdown |
  61. | [earnings-competitive-review](skills/earnings-competitive-review/) | Competitive Analysis | Analyze competitive landscape, market positioning, and strategic differentiation |
  62. | [earnings-capital-allocation](skills/earnings-capital-allocation/) | Capital Allocation | Extract capital allocation, investment priorities, buybacks, and dividend commentary |
  63. | [earnings-market-expansion](skills/earnings-market-expansion/) | Market Expansion | Identify geographic growth plans, new market launches, and product diversification |
  64. | [earnings-cost-mgmt](skills/earnings-cost-mgmt/) | Cost Management | Analyze cost reduction initiatives, restructuring, and operational efficiency |
  65. | [earnings-product-pipeline](skills/earnings-product-pipeline/) | Product Pipeline | Extract R&D updates, clinical trials, regulatory filings, and launch timelines |
  66. ## SEC Filings Analysis Skills
  67. | Skill | Category | Description |
  68. |-------|----------|-------------|
  69. | [sec-analyst-master](skills/sec-analyst-master/) | **Master** | Comprehensive SEC filing analyst skill that orchestrates all SEC skills for due diligence |
  70. | [sec-10k-analysis](skills/sec-10k-analysis/) | Annual Filings | Analyze 10-K annual filings to extract key financial metrics, risk factors, and business insights |
  71. | [sec-10q-analysis](skills/sec-10q-analysis/) | Quarterly Filings | Analyze 10-Q quarterly filings to extract quarterly performance metrics and segment breakdown |
  72. | [sec-risk-factors](skills/sec-risk-factors/) | Risk Analysis | Extract and summarize risk factors from 10-K and 10-Q filings with categorization |
  73. | [sec-mda-analysis](skills/sec-mda-analysis/) | Management Analysis | Analyze Management Discussion and Analysis sections for strategic insights |
  74. | [sec-8k-analysis](skills/sec-8k-analysis/) | Current Events | Analyze 8-K filings to extract material events and corporate changes |
  75. | [sec-proxy-analysis](skills/sec-proxy-analysis/) | Governance | Extract executive compensation and governance info from proxy statements |
  76. | [sec-business-desc-analysis](skills/sec-business-desc-analysis/) | Business Analysis | Extract business descriptions and competitive landscape from 10-K filings |
  77. | [sec-footnotes-analysis](skills/sec-footnotes-analysis/) | Accounting | Analyze footnotes and accounting policies from 10-K and 10-Q filings |
  78. | [sec-s1-analysis](skills/sec-s1-analysis/) | IPO Analysis | Analyze S-1 registration statements for IPO risks, opportunities, and capitalization |
  79. | [sec-amendments-review](skills/sec-amendments-review/) | Filing Changes | Review amendments to SEC filings and identify material changes or corrections |
  80. | [sec-annual-comparison](skills/sec-annual-comparison/) | Trend Analysis | Compare key metrics and risk factors between current and prior year 10-K filings |
  81. | [sec-segment-reporting](skills/sec-segment-reporting/) | Segment Analysis | Analyze business segment performance, margins, and geographic breakdown |
  82. | [sec-cash-flow-review](skills/sec-cash-flow-review/) | Cash Flow | Extract and analyze cash flow trends and working capital changes |
  83. | [sec-corp-governance](skills/sec-corp-governance/) | Governance | Review corporate governance practices, board composition, and policies |
  84. | [sec-debt-covenant](skills/sec-debt-covenant/) | Debt Analysis | Analyze debt covenants and credit agreement terms from SEC filings |
  85. ## Stock Performance & Market Data Skills
  86. | Skill | Category | Description |
  87. |-------|----------|-------------|
  88. | [market-analyst-master](skills/market-analyst-master/) | **Master** | Comprehensive market analyst skill that orchestrates all stock skills for market analysis |
  89. | [stock-performance](skills/stock-performance/) | Price Data | Retrieve daily closing prices, trading volume, and historical price trends |
  90. | [stock-quote](skills/stock-quote/) | Price Data | Get real-time stock quotes with current price, volume, day range, 52-week range, and moving averages |
  91. | [batch-market-cap](skills/batch-market-cap/) | Market Cap | Retrieve market capitalization data for multiple companies at once |
  92. | [company-market-cap](skills/company-market-cap/) | Market Cap | Get market capitalization data for a single company with size classification |
  93. | [price-target-summary](skills/price-target-summary/) | Analyst Sentiment | Retrieve analysts' price target summary with trends across timeframes |
  94. | [price-target-consensus](skills/price-target-consensus/) | Analyst Sentiment | Get consensus, median, high, and low analyst price targets |
  95. | [stock-grades](skills/stock-grades/) | Analyst Sentiment | Get latest analyst ratings, upgrades, and downgrades from financial institutions |
  96. | [sector-pe-ratios](skills/sector-pe-ratios/) | Valuation | Retrieve sector P/E ratios by exchange for valuation benchmarking |
  97. | [industry-pe-ratios](skills/industry-pe-ratios/) | Valuation | Retrieve industry-specific P/E ratios for peer group comparisons |
  98. | [sector-performance-snapshot](skills/sector-performance-snapshot/) | Sector Analysis | Get sector-wide metrics including revenue, EBITDA, market cap, and enterprise value |
  99. | [industry-performance-snapshot](skills/industry-performance-snapshot/) | Sector Analysis | Get daily industry performance overview with average price changes |
  100. | [historical-market-cap](skills/historical-market-cap/) | Market Cap | Retrieve historical market capitalization data over date ranges |
  101. | [stock-historical-index](skills/stock-historical-index/) | Index Data | Retrieve historical end-of-day price data for market indices (S&P 500, NASDAQ, etc.) |
  102. | [stock-price-change](skills/stock-price-change/) | Price Data | Get price change statistics across multiple time periods (1D to 10Y) |
  103. | [commodities-list](skills/commodities-list/) | Commodities | Retrieve catalog of tradable commodities across energy, metals, and agriculture |
  104. | [commodities-quote](skills/commodities-quote/) | Commodities | Get real-time commodity price quotes with day ranges and moving averages |
  105. | [forex-list](skills/forex-list/) | Forex | Retrieve listing of actively traded currency pairs (majors, crosses, exotics) |
  106. ## Prediction Markets Skills
  107. | Skill | Category | Description |
  108. |-------|----------|-------------|
  109. | [prediction-markets-analysis](skills/prediction-markets-analysis/) | Market Research | Generate deep research reports on Kalshi prediction market events with market vs. model probability comparison |
  110. | [kalshi-trading-bot-cli](skills/kalshi-trading-bot-cli/) | Trading CLI | Operate the Kalshi Trading Bot CLI for market discovery, edge scans, baskets, backtests, monitoring, and guarded trade execution |
  111. ## Get Your Octagon API Key
  112. 1. Sign up for a free account at [Octagon](https://app.octagonai.co/signup/?redirectToAfterSignup=https://app.octagonai.co/api-keys)
  113. 2. After logging in, from left menu, navigate to **API Keys**
  114. 3. Generate a new API key
  115. 4. Save the key securely - you'll need it for configuration
  116. ## Prerequisites
  117. Before using these skills, you need to have `npx` (which comes with Node.js and npm) installed on your system.
  118. ### Mac (macOS)
  119. 1. **Install Homebrew** (if you don't have it):
  120. ```bash
  121. /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  122. ```
  123. 2. **Install Node.js (includes npm and npx):**
  124. ```bash
  125. brew install node
  126. ```
  127. 3. **Verify installation:**
  128. ```bash
  129. node -v
  130. npm -v
  131. npx -v
  132. ```
  133. ### Windows
  134. 1. **Download the Node.js installer:**
  135. - Go to [https://nodejs.org/](https://nodejs.org/) and download the LTS version for Windows.
  136. 2. **Run the installer** and follow the prompts. This will install Node.js, npm, and npx.
  137. 3. **Verify installation:**
  138. Open Command Prompt and run:
  139. ```cmd
  140. node -v
  141. npm -v
  142. npx -v
  143. ```
  144. If you see version numbers for all three, you are ready to proceed.
  145. ## MCP Setup
  146. ### Cursor
  147. 1. Open Cursor Settings
  148. 2. Go to **Features > MCP Servers**
  149. 3. Click **+ Add New MCP Server**
  150. 4. Enter:
  151. - **Name**: `octagon-mcp`
  152. - **Type**: `command`
  153. - **Command**: `env OCTAGON_API_KEY=<your-api-key> npx -y octagon-mcp`
  154. Replace `<your-api-key>` with your actual Octagon API key.
  155. **Windows users:** Use this command format instead:
  156. ```
  157. cmd /c "set OCTAGON_API_KEY=<your-api-key> && npx -y octagon-mcp"
  158. ```
  159. After adding, refresh the MCP server list to see the new tools. Access the Composer via Command+L (Mac), select "Agent" next to the submit button, and enter your query.
  160. ### Claude Desktop
  161. 1. Open Claude Desktop
  162. 2. Go to Settings > Developer > Edit Config
  163. 3. Add the following to your `claude_desktop_config.json`:
  164. ```json
  165. {
  166. "mcpServers": {
  167. "octagon-mcp-server": {
  168. "command": "npx",
  169. "args": ["-y", "octagon-mcp@latest"],
  170. "env": {
  171. "OCTAGON_API_KEY": "YOUR_API_KEY_HERE"
  172. }
  173. }
  174. }
  175. }
  176. ```
  177. 4. Restart Claude for the changes to take effect
  178. ### Windsurf
  179. Add this to your `./codeium/windsurf/model_config.json`:
  180. ```json
  181. {
  182. "mcpServers": {
  183. "octagon-mcp-server": {
  184. "command": "npx",
  185. "args": ["-y", "octagon-mcp@latest"],
  186. "env": {
  187. "OCTAGON_API_KEY": "YOUR_API_KEY_HERE"
  188. }
  189. }
  190. }
  191. }
  192. ```
  193. ## Troubleshooting
  194. - **API Key Issues**: Verify the key is correctly set in the command string with no extra spaces.
  195. - **Connection Issues**: Ensure you have internet connectivity and the Octagon API is accessible.
  196. - **Rate Limiting**: Reduce query frequency if encountering rate limit errors.
  197. ## Documentation
  198. - [Octagon Documentation](https://docs.octagonagents.com)
  199. - [Octagon MCP GitHub](https://github.com/OctagonAI/octagon-mcp)
  200. ## License
  201. MIT License - see [LICENSE](LICENSE) for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.