Skip to main content
skill CX Codex

sec-risk-factors — Claude Code skill: SEC risk analysis

sec-risk-factors — a skill that retrieves and categorizes risk factors from 10-K and 10-Q filings via Octagon MCP. Use it to analyze Item 1A disclosures, track risk changes across periods, and compare risk profiles between companies.

MIT 263 installs ★ 132 updated 2026-06-05

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add OctagonAI/skills --skill sec-risk-factors -a claude-code
Open on GitHub

What sec-risk-factors does

The skill calls octagon-agent with a company ticker and returns structured risk data by category: macroeconomic, operational, financial, legal, and strategic. Each risk is mapped to the source page and severity signals (risks listed first are typically more material). You can extract new risks from quarterly 10-Q updates, spot language changes that indicate shifting concern, or benchmark one company's risk profile against competitors.

You need Octagon MCP configured in your environment (Claude Code, Cursor, Windsurf, GitHub Copilot, or Gemini CLI). The agent handles both annual 10-K reports and quarterly 10-Q updates, and accepts filters for specific risk categories like cybersecurity or supply chain.

What it helps with

  • extract risk factors from a 10-K Item 1A disclosure
  • compare a company's risk profile year-over-year
  • identify new or modified risks in quarterly 10-Q filings
  • benchmark risk factors across competing firms
  • filter risks by category (cybersecurity, supply chain, regulatory)

Example prompts for the agent

  • Extract and summarize the risk factors from Apple's latest annual report.
  • Find new or updated risk factors in Tesla's latest 10-Q filing.
  • Compare supply chain risk factors between Apple and Microsoft in their latest 10-K filings.

How to install sec-risk-factors

1Skills CLI (Vercel)

npx skills add OctagonAI/skills --skill sec-risk-factors -a claude-code

2Manually: put the files in place

~/.claude/skills/sec-risk-factors/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/sec-risk-factors/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about sec-risk-factors

How do I install sec-risk-factors for Claude Code?

Run npx skills add OctagonAI/skills --skill sec-risk-factors -a claude-code, then open the configuration at ~/.claude/skills/sec-risk-factors/SKILL.md.

What does sec-risk-factors do?

It queries 10-K and 10-Q filings through Octagon MCP and returns risk factors organized by category (macroeconomic, operational, financial, legal, strategic) with source page references for each disclosure.

Which filings does this skill support?

The skill works with annual 10-K reports and quarterly 10-Q filings for U.S. public companies. You can request the latest filing or compare risks across multiple periods.

Source text

SKILL.md · MIT
---
name: sec-risk-factors
description: Extract and summarize risk factors from SEC filings using Octagon MCP. Use when analyzing Item 1A risk disclosures, categorizing business risks, identifying new or material risks, and comparing risk profiles across companies or time periods.
---

# SEC Risk Factors Analysis

Extract and summarize risk factors from SEC filings (10-K and 10-Q) for public companies using the Octagon MCP server.

## Prerequisites

Ensure Octagon MCP is configured in your AI agent (Cursor, Claude Desktop, Windsurf, etc.). See [references/mcp-setup.md](references/mcp-setup.md) for installation instructions.

## Workflow

### 1. Identify Analysis Parameters

Determine the following before querying:
- **Ticker**: Stock symbol (e.g., AAPL, MSFT, GOOGL)
- **Filing Type** (optional): 10-K (annual) or 10-Q (quarterly updates)
- **Focus Areas** (optional): Specific risk categories of interest

### 2. Execute Query via Octagon MCP

Use the `octagon-agent` tool with a natural language prompt:

```
Extract and summarize the risk factors section from <TICKER>'s latest annual report.
```

**MCP Call Format:**

```json
{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Extract and summarize the risk factors section from AAPL's latest annual report."
  }
}
```

### 3. Expected Output

The agent returns categorized risk factors including:

| Risk Category | Description | Source Pages |
|---------------|-------------|--------------|
| Macroeconomic & Industry Risks | Economic downturns, inflation, currency | 10-K, p.8 |
| Legal & Regulatory Compliance | Legal proceedings, regulatory challenges | 10-K, p.15-16 |
| Financial Risks | Pricing pressures, competition, FX volatility | 10-K, p.18-31 |
| Business Risks | Product transitions, competitiveness | 10-K, p.11 |
| Operational Risks | Manufacturing, logistics, outsourcing | 10-K, p.11 |
| Data Security & Privacy | Cybersecurity, data protection | 10-K, p.18 |
| Supply Chain Risks | Geopolitical tensions, natural disasters | 10-K, p.9 |

**Data Sources**: octagon-sec-agent

### 4. Interpret Results

See [references/interpreting-results.md](references/interpreting-results.md) for guidance on:
- Understanding risk factor categories
- Assessing risk materiality
- Comparing risks across filings
- Identifying new or emerging risks

## Example Queries

**Standard Risk Factor Extraction:**
```
Extract and summarize the risk factors section from AAPL's latest annual report.
```

**Quarterly Risk Updates:**
```
Extract any new or updated risk factors from TSLA's latest 10-Q filing.
```

**Specific Risk Category:**
```
Extract cybersecurity and data privacy risk factors from META's latest 10-K.
```

**Comparative Analysis:**
```
Compare the risk factors between GOOGL's 2024 and 2023 10-K filings.
```

**Industry Comparison:**
```
Extract and compare supply chain risk factors from AAPL and MSFT's latest 10-K filings.
```

**Regulatory Focus:**
```
Extract all regulatory and legal compliance risk factors from JPM's latest annual report.
```

## Risk Factor Categories

### Macroeconomic Risks

| Risk Type | Examples |
|-----------|----------|
| Economic Cycles | Recessions, GDP decline, consumer spending |
| Inflation | Input costs, pricing power, margin pressure |
| Interest Rates | Borrowing costs, valuation impacts |
| Currency | FX volatility, translation effects |
| Geopolitical | Trade wars, sanctions, political instability |

### Operational Risks

| Risk Type | Examples |
|-----------|----------|
| Supply Chain | Supplier concentration, logistics disruptions |
| Manufacturing | Production issues, quality control |
| Technology | System failures, IT infrastructure |
| Human Capital | Key personnel, labor relations |
| Business Continuity | Natural disasters, pandemics |

### Financial Risks

| Risk Type | Examples |
|-----------|----------|
| Liquidity | Cash flow, access to capital |
| Credit | Counterparty risk, receivables |
| Market | Stock price volatility, valuation |
| Tax | Rate changes, audit exposure |
| Pension | Funding obligations, assumptions |

### Regulatory & Legal Risks

| Risk Type | Examples |
|-----------|----------|
| Compliance | Industry regulations, licensing |
| Litigation | Lawsuits, class actions |
| Antitrust | Competition law, market dominance |
| Data Privacy | GDPR, CCPA, data breaches |
| Environmental | ESG regulations, climate policies |

### Strategic Risks

| Risk Type | Examples |
|-----------|----------|
| Competition | Market share, pricing pressure |
| Disruption | Technology shifts, new entrants |
| M&A | Integration risks, deal failure |
| Innovation | R&D success, product pipeline |
| Reputation | Brand damage, public perception |

## Analyzing Risk Changes

### New Risks (High Priority)

Risks added since prior filing:
- Indicates emerging concerns
- Often reflects recent events
- May signal strategic shifts

### Removed Risks (Monitor)

Risks no longer disclosed:
- Issue may be resolved
- Or consolidated into other risks
- Verify resolution in MD&A

### Modified Language (Important)

Risks with changed wording:
- Expanded = increased concern
- Reduced = diminished concern
- More specific = crystallizing risk

## Analysis Tips

1. **Order matters**: Risks are typically ordered by perceived materiality - first risks are often most significant.

2. **Length signals importance**: More detailed risk descriptions often indicate greater management concern.

3. **Specificity is key**: Specific examples suggest real concerns vs. boilerplate language.

4. **Cross-reference MD&A**: Management discussion often provides context for risk factors.

5. **Track changes YoY**: New, removed, or modified risks reveal evolving concerns.

6. **Compare to peers**: Unique risks vs. industry-standard disclosures indicate company-specific issues.

## Use Cases

- **Investment due diligence**: Comprehensive risk assessment before investing
- **Portfolio risk monitoring**: Track risk evolution for holdings
- **Competitive analysis**: Compare risk profiles across competitors
- **Sector research**: Identify common vs. unique risks in an industry
- **Compliance review**: Ensure adequate risk disclosure

© OctagonAI · MIT · OctagonAI/skills

Similar skills

All skills for Finance and business →

From the same set67

The whole set →
revenue-product-segmentation revenue-product-segmentation — a skill for Claude Code, Codex, Cursor and other agents that pulls a product-segment revenue breakdown for any public company via Octagon MCP. Covers annual periods and returns figures in USD billions. CX Codex +1 263installs earnings-market-expansion The earnings-market-expansion skill extracts geographic expansion, new country launches, and product diversification strategies from earnings call transcripts. Requires Octagon MCP. CX Codex +1 263installs revenue-geographic-segmentation revenue-geographic-segmentation pulls geographic revenue breakdowns for public companies through Octagon MCP and analyzes regional exposure alongside currency risks. CX Codex +1 263installs sec-analyst-master sec-analyst-master — a skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that runs a full SEC filing analysis by orchestrating the complete suite of Octagon SEC sub-skills. CX Codex +1 263installs sec-corp-governance sec-corp-governance is a Claude Code skill that analyzes a public company’s board and governance disclosures from its proxy statement. It covers committees, shareholder rights, and related-party transactions. CX Codex +1 262installs earnings-cost-mgmt The earnings-cost-mgmt skill extracts cost reduction details from earnings call transcripts: headcount actions, office consolidation, expense optimization. Built for analysts tracking how companies manage operating expenses. CX Codex +1 261installs sec-s1-analysis sec-s1-analysis is a Claude Code skill that analyzes IPO S-1 filings, extracting business models, risks, financials, and ownership structure. It requires configured Octagon MCP. CX Codex +1 260installs sec-10q-analysis sec-10q-analysis pulls financial metrics, segment revenue, and operating margins from quarterly SEC 10-Q filings using Octagon MCP. CX Codex +1 260installs

Project sponsors

Companies that keep this analytics open